TikTok Shop Product Reviews
Le recensioni dei prodotti di TikTok Shop sono feedback pubblici dei clienti, con testo, valutazioni, nomi di chi recensisce, immagini, timestamp, dettagli SKU, paesi e flag espliciti sullo stato dell’acquisto. Questi campi supportano l’analisi dei feedback sui prodotti, il confronto tra varianti e regioni e flussi di lavoro sulle recensioni attenti alle prove.
Funzionalità della TikTok Shop Product Reviews API
- Un prodotto con ambito regionaleInvia un URL PDP pubblico supportato con una regione di mercato e raccogli le recensioni uniche esposte per quel prodotto, fino al limite richiesto.
- Contenuto, valutazione, autore e media della recensioneOgni record normalizzato conserva il testo della recensione esposto, la valutazione numerica, l’identità di chi recensisce, le immagini, l’orario di pubblicazione, l’URL del prodotto e il momento di raccolta.
- Contesto di prodotto, SKU, paese e acquistoI record delle recensioni mantengono gli identificatori di prodotto e SKU, le specifiche della variante, il paese della recensione e i flag espliciti di acquisto verificato o recensione incentivata, quando forniti.
Parametri della TikTok Shop Product Reviews API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL pubblico di TikTok Shop obbligatorio nel formato /shop/pdp/{numeric_id} o /shop/pdp/{slug}/{numeric_id}; un’attività accetta un solo prodotto. |
results_limit | Facoltativo | Numero massimo di recensioni uniche da salvare tra le pagine della fonte; il valore predefinito è 100 e accetta numeri interi da 20 a 2.000. |
region | Facoltativo | Regione di mercato di TikTok Shop; il valore predefinito è US e la disponibilità pubblica di prodotti o recensioni nelle altre regioni accettate può variare. |
Come usare la TikTok Shop Product Reviews API
Invia l’URL di un prodotto supportato, segui l’attività asincrona e leggi i record delle recensioni normalizzati con la paginazione a cursore.
- Prepara l’url PDP di un prodotto TikTok Shop supportato, un results_limit da 20 a 2.000 e la regione di mercato del prodotto.
- Invia la richiesta con POST a /v1/tiktok-shop/product-reviews e salva il task_id restituito.
- Interroga GET /v1/tasks/{task_id} finché l’attività non va a buon fine o restituisce un errore.
- Leggi data.results.items e richiedi il next_cursor restituito finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della TikTok Shop Product Reviews API
- Analisi dei feedback sui prodotti: Usa testo delle recensioni, valutazioni numeriche, timestamp e identità del prodotto per esaminare i feedback pubblici restituiti per un prodotto noto.
- Confronto dei feedback per SKU e regione: Raggruppa i record per specifica SKU o paese della recensione, poi confronta testo e valutazioni senza dedurre valori per i campi mancanti.
- Esame del contesto d’acquisto e dei media delle recensioni: Controlla le immagini fornite dai clienti e segmenta i record in base ai flag espliciti di acquisto verificato o recensione incentivata, quando questi valori sono presenti.
Consigli degli esperti per la TikTok Shop Product Reviews API
- Verifica prima dell’invio che l’input sia un URL PDP completo di tiktok.com con un ID prodotto numerico, perché i profili, i video, i negozi e gli altri URL di TikTok vengono rifiutati.
- Scegli la regione che corrisponde al mercato del prodotto; un URL valido può comunque non restituire recensioni pubbliche quando il mercato selezionato non espone il prodotto o il suo feed di recensioni.
- Imposta results_limit tra 20 e 2.000 per la copertura della raccolta, poi segui next_cursor finché has_more è false per leggere ogni pagina di risultati salvata.
- Considera sconosciuti testo della recensione, identità di chi recensisce, dettagli SKU e flag sullo stato dell’acquisto se assenti; un booleano mancante non è false e un record con la sola valutazione resta valido.
API correlate
Oltre alla TikTok Shop Product Reviews API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok Shop.
- TikTok Shop Search API — Cerca i prodotti pubblici di TikTok Shop per parola chiave e regione di mercato con venditore, prezzo, media, valutazione, recensioni e quantità vendute.
- TikTok Shop Products API — Raccoglie i prodotti pubblici dall’URL di un negozio TikTok Shop con venditore, prezzo, media, categoria, SKU, valutazione, recensioni e quantità vendute.
- TikTok Shop Product API — Recupera un prodotto pubblico di TikTok Shop dall’URL della sua pagina prodotto con venditore, prezzo, media, categoria, SKU, valutazione, recensioni e quantità vendute.
- TikTok Shop User Showcase API — Raccoglie i prodotti pubblici in vetrina di un nome utente TikTok con prezzo, venditore, media, valutazione, recensioni, quantità vendute e contesto regionale.
- TikTok Shop Hot Products API — Raccoglie i prodotti più venduti di un mercato TikTok Shop tramite codice della regione, in ordine di classifica, con prezzo, valuta, unità vendute, valutazione e negozio.
- TikTok Shop Categories API — Recupera l’albero completo delle categorie di un mercato TikTok Shop con ID, nomi, slug inglesi, livelli, categorie madri e percorsi.