API Taobao 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 Taobao, fino a 100 per chiamata, e scorri le pagine per ottenerne altre. Ogni recensione include valutazione, variante acquistata, voti di utilità, foto, recensione aggiuntiva e risposta del venditore. Passa l'ID dell'articolo, un link del prodotto o un testo di condivisione con un solo link di prodotto. Il lotto potrebbe non includere tutte le recensioni.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su taobao e action impostato su reviews. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Ogni blocco di 20 righe richieste conta come una chiamata: limit determina l'addebito e i blocchi per cui non viene restituita alcuna riga non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
Taobao Reviews legge le recensioni degli acquirenti di un prodotto: testo della recensione, valutazione, data di pubblicazione, variante acquistata, nickname dell'acquirente, immagini e risposta del venditore. Usala per capire se gli acquirenti sono soddisfatti e dove si concentrano le lamentele, per analisi della reputazione, per risalire alle cause delle recensioni negative o per estrarre punti di forza e criticità dal prodotto di un concorrente.
url accetta gli stessi identificativi di prodotto di Product details: un ID numerico, un link al prodotto o un testo di condivisione con esattamente un link a un prodotto. sku collega ogni recensione a una variante specifica, così puoi confrontare il feedback tra colori o taglie, e seller_reply mostra come il negozio gestisce le critiche. Controlla rating_scale nella stessa riga prima di confrontare le valutazioni.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Taobao Recensioni di EveryInfra (taobao/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 taobao e action su reviews, e inserisci i parametri in params.
- Parametri obbligatori:
- url: Per product_detail, reviews o questions, usa un ID numerico dell'articolo, l'URL di un prodotto Taobao/Tmall o un messaggio di condivisione che contenga esattamente un URL di prodotto.
- Parametri facoltativi:
- page: Numero di pagina delle recensioni dell'articolo, da 1 a 50, dalla più recente, di solito 20 recensioni per pagina e meno nell'ultima. Con page ottieni direttamente l'intera pagina e limit non ha effetto.
- page_token: Token di pagina. Omettilo per la prima pagina. Quando la risposta contiene un next_page_token, ripassalo come page_token, esattamente come ricevuto, per ottenere la pagina successiva, lasciando invariati gli altri parame…
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 20)
- Restituisce un elenco di record. Campi principali di ogni record: id, text, rating, rating_scale, posted_at, sku (Variante acquistata dall'acquirente (re…), buy_count (Quante volte l'autore della recensione…), useful_count (Quante volte la recensione è stata valu…), author_name, author_avatar_url (Link all'avatar dell'autore della recen…), images (Link alle immagini: foto del prodotto i…), review_append (Testo della recensione aggiuntiva dell'…); 14 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=taobao.
- Esempio di corpo della richiesta:
{
"platform": "taobao",
"action": "reviews",
"params": {
"url": "https://item.taobao.com/item.htm?id=744983869996"
}
}
- Prezzo: $1.39 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ì | taobao | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | reviews | Identificativo della funzionalità, valore fisso. |
url | body.params | string | Sì | - | Per product_detail, reviews o questions, usa un ID numerico dell'articolo, l'URL di un prodotto Taobao/Tmall o un messaggio di condivisione che contenga esattamente un URL di prodotto. I link e.tb.cn e m.tb.cn funzionano solo se possono essere risolti in modo sicuro in una pagina prodotto. I token composti solo da TaoPassword, i link scaduti e le pagine che non sono di prodotto vengono rifiutati. |
page | body.params | integer | No | - | Numero di pagina delle recensioni dell'articolo, da 1 a 50, dalla più recente, di solito 20 recensioni per pagina e meno nell'ultima. Con page ottieni direttamente l'intera pagina e limit non ha effetto; senza, la paginazione parte da pagina 1 come prima e prosegue con next_page_token. Ogni pagina viene addebitata come una chiamata; una pagina oltre l'ultima restituisce un risultato vuoto e non viene addebitata. Taobao mostra al massimo le prime 1.000 recensioni di un articolo (pagina 50), quindi le pagine oltre la 50 vengono rifiutate prima dell'addebito. pagination.has_more a true indica che c'è una pagina successiva: chiedi page + 1, oppure ripassa next_page_token come page_token. Se invii sia page sia page_token, prevale page_token. Se arrivano nuove recensioni mentre scorri le pagine, pagine adiacenti possono ripetere una o due recensioni, quindi elimina i duplicati in base all'id della recensione quando unisci i risultati. |
page_token | body.params | string | No | - | Token di pagina. Omettilo per la prima pagina. Quando la risposta contiene un next_page_token, ripassalo come page_token, esattamente come ricevuto, per ottenere la pagina successiva, lasciando invariati gli altri parametri (limit può cambiare). Puoi anche fare a meno del token e chiedere un numero di pagina con page; se li invii entrambi, prevale page_token. Un token è valido per 24 ore e funziona solo per lo stesso prodotto e lo stesso account; un token usato con un altro prodotto viene rifiutato con 422 e non viene addebitato. L'assenza di next_page_token (o pagination.has_more a false) indica che sei arrivato alla fine. Ogni pagina restituisce limit recensioni (predefinito 20, fino a 100) e la pagina successiva riprende dopo l'ultima recensione restituita. Le recensioni sono ordinate dalla più recente; se arrivano nuove recensioni mentre scorri le pagine, pagine adiacenti possono ripetere una o due recensioni, quindi elimina i duplicati in base all'id della recensione quando unisci i risultati. Ogni pagina viene addebitata a sé in base al numero di righe, una chiamata ogni 20 righe (20 righe sono una chiamata, 21–40 sono due, 100 sono cinque); le chiamate non usate perché sono arrivate meno righe vengono rimborsate e una pagina vuota non viene addebitata. |
limit | body.params | integer (1–100) | No | 20 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
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": "taobao",
"action": "reviews",
"params": {
"url": "https://item.taobao.com/item.htm?id=744983869996"
}
}'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": "taobao", "action": "reviews", "results": [ { "text": "質量過關，用着挺放心的，之前那個用了幾年時間，用不了，綠聯質量太好了", "rating": 5, "posted_at": "2026.08.27 21:28", "platform": "taobao", "rating_scale": 5 } ], "next_page_token": …, "pagination": { … }, "count": 1, "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. |
text | Testo del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma). |
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. |
posted_at | Data e ora di pubblicazione in formato ISO 8601, UTC (ad esempio 2026-08-07T12:34:56+00:00). Le stringhe non standard della piattaforma vengono passate così come sono, quindi esegui il parsing in modo difensivo. null significa che la piattaforma non le rende note. |
sku | Variante acquistata dall'acquirente (reviews), ad esempio colore o taglia, come riportata nella recensione. |
buy_count | Quante volte l'autore della recensione ha acquistato il prodotto, come mostrato nella recensione. |
useful_count | Quante volte la recensione è stata valutata come utile. |
author_name | Nome visualizzato dell'autore. |
author_avatar_url | Link all'avatar dell'autore della recensione (reviews). |
images | Link alle immagini: foto del prodotto in product_detail, foto dell'acquirente in reviews (assente se la recensione non ne ha). |
review_append | Testo della recensione aggiuntiva dell'acquirente. Se sono presenti più recensioni aggiuntive, vengono unite con interruzioni di riga in ordine di pubblicazione; il campo è assente se non ce ne sono. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
next_page_token | Token di pagina: ripassalo invariato come page_token, con gli altri parametri uguali, per recuperare la pagina successiva; valido per 24 ore e solo per lo stesso prodotto. Ogni riga di una pagina riporta lo stesso valore, che compare anche al livello superiore della risposta. Assente nell'ultima pagina. |
seller_reply | Risposta del venditore alla recensione; assente se non c'è. |
FAQ
#Posso separare le recensioni per variante?
#Sì. sku in ogni recensione è la variante acquistata, quindi raggruppando per questo campo puoi confrontare il feedback tra colori, taglie o bundle. useful_count, il numero di volte in cui una recensione è stata segnata come utile, ti aiuta a scegliere le più informative.
Come vedo in che modo un negozio risponde alle lamentele?
#Leggi seller_reply, la risposta del venditore a quella recensione. Leggendo le valutazioni basse insieme alle risposte vedi quali problemi si ripetono e come il negozio li gestisce di solito.
Posso scorrere le recensioni pagina per pagina o saltare a una pagina precisa, e come funziona l'addebito?
#Sì, in due modi. Per numero di pagina: passa page (1–50) per ottenere direttamente quella pagina, di solito 20 recensioni; ogni pagina è una chiamata e limit non ha effetto. Per token: ripassa il next_page_token della risposta invariato come page_token; ogni pagina restituisce limit recensioni (predefinito 20, fino a 100), addebitate una chiamata ogni 20 recensioni, e le chiamate non usate perché sono arrivate meno recensioni vengono rimborsate. In entrambi i casi, un next_page_token nella risposta indica che c'è una pagina successiva, una pagina vuota non viene addebitata e, se li invii entrambi, prevale page_token. Taobao mostra al massimo le prime 1.000 recensioni di un articolo.
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.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- Taobao: la terminologia di ID prodotto e SKU ↗
Taobao definisce l'ID prodotto come le cifre che seguono id= in un link al prodotto, mentre uno SKU descrive una specifica combinazione di attributi, come colore e taglia. ID prodotto e SKU non vanno usati in modo intercambiabile.
Verificato il 2026-09-04