API Xiaohongshu Ricerca utenti

Q: Come ottengo più di una pagina di account?

Ogni chiamata restituisce una pagina. Prendi il next_page_token di primo livello dalla risposta e rinvialo come page_token, lasciando invariati keyword e tutti i filtri; se ometti page_token riparti dalla prima pagina. limit è accettato ma qui non ha effetto, quindi per ottenere più account devi usare la paginazione, una chiamata per pagina.

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore: Normale

Buono / normale
Disponibile
Limitato
Quasi del tutto inattivo

Ultime 24 ore

Ultimi 30 giorni

Trova creator e account di brand su Xiaohongshu per parola chiave, 20 per pagina. Ottieni nickname, ID Xiaohongshu, numero di follower e tipo di verifica. Filtra per follower_range o user_type. Il numero di follower approssima le cifre arrotondate dell'elenco, quindi chiama profile per i valori esatti.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su xiaohongshu e action impostato su search_users. 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 User search trova account per keyword, come il nome di un brand o una parola su un argomento come caffè, e restituisce creator e account di brand anziché note. Ogni riga riporta lo user_id interno, il nickname, l'ID Xiaohongshu in red_id, l'avatar, un link al profilo, il numero di follower e se e come l'account è verificato. È il punto di partenza per creare shortlist di creator, mappare i concorrenti e verificare gli account dei brand su Xiaohongshu.

Restringi i risultati per dimensione del pubblico con follower_range, da under_100 fino a over_100k, e mantieni utenti comuni, persone verificate o aziende verificate con user_type impostato su general, verified_individual o business. verification_type viene omesso per gli account non verificati. I link ai profili restituiti da questa ricerca non contengono un token di accesso, quindi passa lo user_id alla funzionalità Xiaohongshu Details per ottenere un link apribile da un browser senza login, insieme ai conteggi esatti.

Prompt per l'AI

Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Xiaohongshu Ricerca utenti di EveryInfra (xiaohongshu/search_users).

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 search_users, e inserisci i parametri in params.
- Parametri obbligatori:
  - keyword: Una keyword per trovare account, ad esempio coffee, il nome di un brand o un argomento. Restituisce utenti (creator e account di brand), non note.
- Parametri facoltativi:
  - follower_range: Filtra gli account in search_users per numero di follower: under_100, 100_to_1k, 1k_to_10k, 10k_to_100k o over_100k. Omettilo per non avere limiti. (valori consentiti: 100_to_1k / 10k_to_100k / 1k_to_10k / over_100k / under_100)
  - page_token: Cursore di paginazione per le azioni comments, sub_comments, search, user_posts, search_users e hashtag: ripassa il valore next_page_token di una riga della risposta precedente per recuperare la pagina successiva.
  - user_type: Filtra gli account in search_users per tipo: general (utente normale), verified_individual (persona verificata) o business (azienda verificata). Omettilo per non avere limiti. (valori consentiti: business / general / verified_individual)
- Restituisce un elenco di record. Campi principali di ogni record: user_id, nickname (Nome visualizzato dell'account), red_id (ID Xiaohongshu: l'ID ricercabile scelto…), avatar_url, url (Il link del record su Xiaohongshu), follower_count (Numero di follower), is_verified, verification_type (Tipo di verifica su search_users e prof…), next_page_token (Token di pagina (search, comments, sub_…).
- Esempio di corpo della richiesta:
{
  "platform": "xiaohongshu",
  "action": "search_users",
  "params": {
    "keyword": "咖啡"
  }
}
- 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ì	`search_users`	Identificativo della funzionalità, valore fisso.
`keyword`	body.params	`string`	Sì	-	Una keyword per trovare account, ad esempio coffee, il nome di un brand o un argomento. Restituisce utenti (creator e account di brand), non note.
`follower_range`	body.params	`string (enum)`	No	-	Filtra gli account in search_users per numero di follower: under_100, 100_to_1k, 1k_to_10k, 10k_to_100k o over_100k. Omettilo per non avere limiti.Valori consentiti`100_to_1k10k_to_100k1k_to_10kover_100kunder_100`
`page_token`	body.params	`string`	No	-	Cursore di paginazione per le azioni comments, sub_comments, search, user_posts, search_users e hashtag: ripassa il valore next_page_token di una riga della risposta precedente per recuperare la pagina successiva; omettilo per partire dalla prima pagina. Ogni pagina corrisponde a una chiamata, addebitata per richiesta.
`user_type`	body.params	`string (enum)`	No	-	Filtra gli account in search_users per tipo: general (utente normale), verified_individual (persona verificata) o business (azienda verificata). Omettilo per non avere limiti.Valori consentiti`businessgeneralverified_individual`

Esempi di codice

bash

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": "search_users",
  "params": {
    "keyword": "咖啡"
  }
}'

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

json

{  "id": "req_…",  "platform": "xiaohongshu",  "action": "search_users",  "results": [    {      "user_id": "•••",      "nickname": "•••",      "red_id": "•••",      "avatar_url": "https://sns-avatar-qc.xhscdn.com/•••",      "url": "https://www.xiaohongshu.com/•••",      "follower_count": 456000,      "is_verified": false,      "next_page_token": "n1.p2",      "platform": "xiaohongshu"    },    {      "user_id": "•••",      "nickname": "•••",      "red_id": "•••",      "avatar_url": "https://sns-avatar-qc.xhscdn.com/•••",      "url": "https://www.xiaohongshu.com/•••",      "follower_count": 148000,      "is_verified": true,      "verification_type": "business",      "next_page_token": "n1.p2",      "platform": "xiaohongshu"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 20,  "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.
`avatar_url`	Link all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere.
`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.
`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.
`is_verified`	Indica se la piattaforma ha verificato l'account. null significa che non è possibile determinarlo.
`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.
`next_page_token`	Token di pagina (search, comments, sub_comments, user_posts, search_users, hashtag): ripassalo invariato come page_token, lasciando identici gli altri parametri, per recuperare la pagina successiva.
`platform`	Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).

FAQ

Come trovo un utente specifico su Xiaohongshu?

Cerca con il nome dell'account o una parola strettamente legata a esso, poi conferma la corrispondenza con red_id, l'ID Xiaohongshu ricercabile scelto dal titolare dell'account. Una volta individuata la riga giusta, conserva il suo user_id: le funzionalità Details e Posts by user cercano gli account tramite questo ID interno e non tramite il nickname.

Perché i numeri di follower sembrano arrotondati?

L'elenco di ricerca mostra i numeri di follower in forma arrotondata e follower_count converte questa visualizzazione in un numero intero, quindi un valore in elenco di 1,2 × 10.000 viene restituito come 12.000. Null significa che il conteggio non era pubblico o non è stato possibile leggerlo, non che è zero. La funzionalità Xiaohongshu Details restituisce il dato esatto.

Come ottengo più di una pagina di account?

Ogni chiamata restituisce una pagina. Prendi il next_page_token di primo livello dalla risposta e rinvialo come page_token, lasciando invariati keyword e tutti i filtri; se ometti page_token riparti dalla prima pagina. limit è accettato ma qui non ha effetto, quindi per ottenere più account devi usare la paginazione, una chiamata per pagina.

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.

Errori