API Xiaohongshu Recensioni
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
Leggi le recensioni degli acquirenti di un prodotto dello store di Xiaohongshu tramite il suo product_id di 24 caratteri, in ordine predefinito o dalla più recente. Ogni recensione include testo completo, valutazione su 5 punti, valutazioni di servizio e consegna, voti di utilità, numero di risposte, foto dell'acquirente, tag della recensione, variante acquistata e data della recensione. ID, nomi e avatar di chi recensisce non vengono mai restituiti. Fino a 20 per pagina.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su xiaohongshu e action impostato su reviews. 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.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Xiaohongshu Recensioni di EveryInfra (xiaohongshu/reviews).
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 reviews, e inserisci i parametri in params.
- Parametri obbligatori:
- product_id: L'ID prodotto di 24 caratteri preso dall'id di una riga di product_search, oppure un link al prodotto https://www.xiaohongshu.com/goods-detail/<ID>. Un ID non valido viene rifiutato prima di qualsiasi addebito.
- Parametri facoltativi:
- page_token: Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri.
- sort: Ordine delle recensioni: default (l'ordinamento predefinito dello store, equivale a ometterlo) o newest (prima le più recenti). Usa lo stesso valore durante la paginazione. (valori consentiti: default / newest)
- Restituisce un elenco di record. Campi principali di ogni record: id, product_id (Il prodotto a cui appartiene la recensi…), text (Testo della nota o del commento), rating, rating_scale, service_rating (La valutazione del servizio data dall'a…), logistics_rating (La valutazione della consegna data dall…), like_count (Numero di Mi piace), reply_count, images (Link alle immagini), tags (Elenco di tag: su note, i tag degli arg…), sku (La variante acquistata (reviews), così…); 14 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu.
- Esempio di corpo della richiesta:
{
"platform": "xiaohongshu",
"action": "reviews",
"params": {
"product_id": "6a4629ef7d09bf0001a45876"
}
}
- 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ì | reviews | Identificativo della funzionalità, valore fisso. |
product_id | body.params | string | Sì | - | L'ID prodotto di 24 caratteri preso dall'id di una riga di product_search, oppure un link al prodotto https://www.xiaohongshu.com/goods-detail/<ID>. Un ID non valido viene rifiutato prima di qualsiasi addebito. |
page_token | body.params | string | No | - | Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come ricevuto, lasciando invariati gli altri parametri. Una pagina contiene fino a 20 recensioni e corrisponde a una chiamata; l'ultima pagina non ha next_page_token. |
sort | body.params | string (enum) | No | - | Ordine delle recensioni: default (l'ordinamento predefinito dello store, equivale a ometterlo) o newest (prima le più recenti). Usa lo stesso valore durante la paginazione.Valori consentitidefaultnewest |
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": "reviews",
"params": {
"product_id": "6a4629ef7d09bf0001a45876"
}
}'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": "reviews", "results": [ { "id": "•••", "product_id": "6a4629ef7d09bf0001a45876", "text": "这款银色瓶瓶的防晒乳是颜蔻美白补水隔离防晒乳,拥有SPF50+PA+++的高倍防护力,能全波段抵御紫外线,无论是日常通勤、户外运动还是海边度假,都能有效防止肌肤晒黑晒伤。\n\n它的质地非常轻薄水润,像乳液一样好推开,上脸后能快速成膜,完全没有传统防晒霜的油腻感和厚重感,也不会假白或搓泥,后续上妆也超级服帖。更棒的是,它不仅仅是一款防晒霜,还兼具了美白和补水的功效。里面添加了多种美白成分,能从根源抑制黑色素生成,淡化色斑和暗沉;同时富含透明质酸、甘油等保湿成分,能给肌肤补充水分,让肌肤在炎炎夏日也能保持水润饱满的状态,简直是干皮亲妈!\n\n此外,这个防晒乳涂抹…", "rating": 5, "rating_scale": 5, "service_rating": 5, "logistics_rating": 5, "like_count": 0, "reply_count": 0, "images": [ "https://mall-i1.xhscdn.com/comment/1040g2u0322hsqm3m7a2g5o1d03gg8te683ff2oo?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL", "https://mall-i1.xhscdn.com/comment/1040g2u0322hsqm3m7a305o1d03gg8te64ldc2e8?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL", "https://mall-i1.xhscdn.com/comment/1040g2u0322hsqm3m7a3g5o1d03gg8te67h6moqo?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL" ], "tags": [ "不假白", "防晒伤", "防晒美白2合1" ], "sku": "数量: 2盒(上新限定机制)", "posted_date": "2026-07-13", "next_page_token": "n1.p2", "platform": "xiaohongshu" }, { "id": "•••", "product_id": "6a4629ef7d09bf0001a45876", "text": "颜蔻美白补水隔离防晒乳很好用\n乳液质地水润顺滑,很好推开,成膜快,清爽不油腻,不会假白搓泥 夏天出汗完全不流白汤\n高倍防晒力,集防晒、隔离、提亮补水于一体,日常通勤足够。上脸自然提亮肤色,当做妆前打底也很服帖,一年四季都能用,性价比高,能够让我坚持用防晒!\n如果是油皮的姐妹可以叠加一点点散粉,我是混合皮就不用➕散粉了,上脸还有水光感😝", "rating": 5, "rating_scale": 5, "service_rating": 5, "logistics_rating": 5, "like_count": 2, "reply_count": 0, "images": [ "https://mall-i1.xhscdn.com/comment/1040g2u03234npkbt6u1044ui8ustj9tla99kbu0?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL", "https://mall-i1.xhscdn.com/comment/1040g2u03234npkbt6u1g44ui8ustj9tlsjutur8?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL", "https://mall-i1.xhscdn.com/comment/1040g2u03234npkbt6u2044ui8ustj9tl1gjfem8?imageView2/2/w/1080/format/webp/q/85&ap=3&sc=EVA_DTL" ], "tags": [ "不假白", "不流白汤", "成膜快" ], "sku": "数量: 2盒(上新限定机制)", "posted_date": "2026-07-27", "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 |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
product_id | Il prodotto a cui appartiene la recensione (reviews), lo stesso product_id della richiesta. |
text | Testo della nota o del commento. note e hashtag restituiscono il testo completo; search e user_posts possono restituire un estratto troncato (fino a circa 60 e 100 caratteri rispettivamente). Chiama note con l'ID della nota per ottenere il testo completo. |
rating | Valutazione. La scala varia in base alla piattaforma: rating_scale nella stessa riga indica il valore massimo (di solito 5; Booking, Douban, iQIYI e NAVER usano 10). Converti con rating_scale prima di confrontare piattaforme diverse, altrimenti il confronto può risultare invertito. |
rating_scale | Valore massimo di rating nella stessa riga: 5 per le scale a cinque stelle, 10 per quelle a dieci punti. Presente solo se la riga ha una valutazione. |
service_rating | La valutazione del servizio data dall'acquirente, su 5 (reviews); assente quando l'acquirente non l'ha data. |
logistics_rating | La valutazione della consegna data dall'acquirente, su 5 (reviews); assente quando l'acquirente non l'ha data. |
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. |
reply_count | Risposte, di solito a un commento. null significa non rese note. |
images | Link alle immagini. Su note, hashtag, search e user_posts, tutte le immagini della nota in ordine. Nei risultati dei commenti (comments, comments_batch, sub_comments), le immagini allegate al commento, sticker inclusi; un array vuoto significa che non ce ne sono. null significa che questo elemento non è stato restituito questa volta. |
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. |
sku | La variante acquistata (reviews), così come la riporta la pagina del prodotto, ciascuna nel formato nome: valore, con più varianti separate da punto e virgola, ad esempio colore: bianco; taglia: M. |
posted_date | Data della recensione (reviews, YYYY-MM-DD, ora di Pechino). Il negozio mostra solo testo come 06-12 o 3 giorni fa, che viene convertito in una data nell'ora di Pechino; assente quando non è leggibile. ID, nomi e avatar dei recensori non vengono mai restituiti. |
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). |
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.