API Xiaohongshu Dettagli
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- 100%
- Tempo medio nelle ultime 24 ore
- 2.54 s
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Cerca un account Xiaohongshu. Ottieni nickname, ID Xiaohongshu, bio, località IP, verifica e il numero esatto di follower, account seguiti, post, like e salvataggi. Passa l'ID di un link /user/profile/, il link stesso o l'author_id di chi ha commentato. I conteggi non visibili vengono restituiti come null, non come zero.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su xiaohongshu e action impostato su profile. Prezzo $5.56 per 1.000 richieste ($0.005556 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
Xiaohongshu Details legge il profilo di un account a partire dal suo user_id: nickname, ID Xiaohongshu, bio, avatar, genere, località IP, verifica, numero di follower e di account seguiti, numero di post e i Mi piace e i salvataggi ricevuti dalle sue note. Dice a team dei brand, agenzie e ricercatori quanto è grande un account e quanto coinvolgimento genera prima di inserire un creator in shortlist, firmare una partnership o aggiungere l'account a un elenco di monitoraggio.
Passa l'ID che segue /user/profile/ in un link al profilo, il link stesso oppure l'ID autore di chi commenta preso dai risultati di Xiaohongshu Comments. Qui follower_count è esatto, a differenza dei valori arrotondati di User search, e i conteggi non pubblici vengono restituiti come null, non come zero. ip_location è la provincia o il paese che la piattaforma associa all'account, non un dato inserito dal proprietario, e real_name_info compare solo quando il profilo mostra dati di identità reale.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Xiaohongshu Dettagli di EveryInfra (xiaohongshu/profile).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su xiaohongshu e action su profile, e inserisci i parametri in params.
- Parametri obbligatori:
- user_id: Indica l'ID utente Xiaohongshu (l'identificativo dopo /user/profile/ nell'URL) o l'URL completo del profilo per le azioni profile e user_posts. Funziona anche l'author_id restituito dalle azioni sui commenti.
- Restituisce un oggetto. Campi principali: user_id, nickname (Nome visualizzato dell'account), red_id (ID Xiaohongshu: l'ID ricercabile scelto…), url (Il link del record su Xiaohongshu), bio, follower_count (Numero di follower), following_count, like_collect_count (Il totale di Mi piace e salvataggi del…), post_count, gender (Genere come mostrato sul profilo), ip_location (Posizione IP (provincia o paese) mostra…), avatar_url; 20 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu.
- Esempio di corpo della richiesta:
{
"platform": "xiaohongshu",
"action": "profile",
"params": {
"user_id": "5bec178863f51f0001859bd9"
}
}
- Prezzo: $5.56 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | xiaohongshu | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | profile | Identificativo della funzionalità, valore fisso. |
user_id | body.params | string | Sì | - | Indica l'ID utente Xiaohongshu (l'identificativo dopo /user/profile/ nell'URL) o l'URL completo del profilo per le azioni profile e user_posts. Funziona anche l'author_id restituito dalle azioni sui commenti. Serve a recuperare i dettagli del profilo o le note pubblicate; non accetta i nomi visualizzati degli utenti. |
Esempi di codice
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "xiaohongshu",
"action": "profile",
"params": {
"user_id": "5bec178863f51f0001859bd9"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#{ "id": "req_…", "platform": "xiaohongshu", "action": "profile", "results": { "user_id": "5bec178863f51f0001859bd9", "nickname": "•••", "red_id": "536248807", "url": "https://www.xiaohongshu.com/user/profile/5bec178863f51f0001859bd9?xsec_token=YBa43WesDF2ZG-HMGXVxTlt0t4eJdIhAYkDoVSOA1K-Ew%3D", "bio": "人生的觉醒消失于人群之中", "follower_count": 2114, "following_count": 49, "like_collect_count": 16889, "post_count": 752, "gender": 0, "ip_location": "•••", "avatar_url": "https://sns-avatar-qc-ae.rednotecdn.com/•••", "is_verified": false, "tags": [ "白羊座", "江苏扬州", "旅行博主" ], "like_count": 15178, "collect_count": 1711, "location": "中国 江苏 扬州", "platform": "xiaohongshu" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
user_id | ID univoco dell'utente sulla piattaforma. |
nickname | Nome visualizzato dell'account. |
red_id | ID Xiaohongshu: l'ID ricercabile scelto dal titolare dell'account, diverso dallo user_id interno. |
url | Il link del record su Xiaohongshu. I link di search, note, profile e hashtag di solito contengono un token di accesso, quindi si aprono anche in un browser senza aver effettuato l'accesso (il token scade; chiama di nuovo per un link aggiornato). I link alle note di user_posts non contengono token e ne richiedono uno per aprirsi in un browser: chiama note con l'ID della nota per ottenere un link che si apra. Nemmeno i link ai profili di search_users contengono token; chiama profile con lo user_id per ottenerne uno che si apra. I link alle note di pgy_content_square contengono un token, tranne con keyword, nel qual caso non ne contengono. |
bio | Bio del profilo scritta dall'account; può contenere interruzioni di riga ed emoji. |
follower_count | Numero di follower. Esatto su profile. Approssimativo su search_users: l'elenco mostra un valore arrotondato (12.000 appare come 1,2 × 10.000), convertito in un numero intero. null significa non pubblico o non riconosciuto, non zero. |
following_count | Account seguiti. null significa non reso noto, non 0. |
like_collect_count | Il totale di Mi piace e salvataggi del profilo: Mi piace ricevuti più salvataggi sulle note dell'account. like_count e collect_count riportano le due componenti. |
post_count | Post totali. null significa non reso noto, non 0. |
gender | Genere come mostrato sul profilo; può essere vuoto. |
ip_location | Posizione IP (provincia o paese) mostrata da Xiaohongshu; non è inserita dall'utente. Solo alcune righe di user_posts la riportano. |
avatar_url | Link all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere. |
is_verified | Indica se la piattaforma ha verificato l'account. null significa che non è possibile determinarlo. |
tags | Elenco di tag: su note, i tag degli argomenti della nota; su profile, i tag personali mostrati nella pagina del profilo (come segno zodiacale o regione); su reviews, i tag di recensione assegnati dal negozio, come buona qualità, assenti quando non ce ne sono. Così come sono scritti. |
like_count | Numero di Mi piace. Nei risultati di note e dei commenti, i Mi piace su quell'elemento; su profile, il totale dei Mi piace ricevuti dalle note dell'account. null significa non pubblico o non restituito questa volta, non zero. |
collect_count | Numero di salvataggi. Nei risultati di note, quante volte quella nota è stata salvata; su profile, il totale dei salvataggi sulle note dell'account. null significa non pubblico o non restituito questa volta, non zero. |
real_name_info | Dati di verifica del nome reale esattamente come li mostra il profilo; il campo è assente quando non ce ne sono. |
verification_type | Tipo di verifica su search_users e profile: individual (persona verificata), business (azienda verificata) o other. Gli account non verificati omettono questo campo. |
verification_text | Descrizione della verifica così come appare sul profilo (profile). |
location | Descrizione della località passata così com'è; il formato varia in base alla piattaforma. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
FAQ
#Cosa misura like_collect_count?
#Il totale di Mi piace e salvataggi mostrato nel profilo: tutti i Mi piace più tutti i salvataggi ricevuti dalle note dell'account. like_count e collect_count riportano le due parti separatamente, così puoi capire se il pubblico tende a mettere Mi piace alle note di un account o a salvarle per ritrovarle in seguito.
Devo salvare user_id o red_id?
#Salvali entrambi, ma usa user_id come chiave dei tuoi record: è il valore da ripassare a questa funzionalità e a Posts by user. red_id viene scelto dal titolare dell'account ed è ciò che le persone digitano nella ricerca dell'app, quindi è comodo da mostrare e per abbinare un ID che qualcuno ti invia.
Il link al profilo si apre in un browser?
#Di solito sì. I link restituiti da questa funzionalità contengono normalmente un token di accesso, quindi si aprono senza login finché il token non scade; una nuova chiamata ne restituisce uno nuovo. I link al profilo di User search e i link alle note di Posts by user non hanno il token, ed è per questo che quelle funzionalità rimandano qui o a Note details.
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.