tiktok-shop/
product-reviews

Raccogli le recensioni pubbliche di TikTok Shop da un URL PDP di un prodotto, con testo, valutazioni, dettagli di chi recensisce, immagini, SKU e contesto d’acquisto come record normalizzati.

TikTok Shop Product Reviews API

URL PDP di un solo prodotto
Testo e valutazioni pubblici delle recensioni
SKU e contesto d’acquisto
Raccolta per regione
0,3 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlObbligatorioURL pubblico di TikTok Shop obbligatorio nel formato /shop/pdp/{numeric_id} o /shop/pdp/{slug}/{numeric_id}; un’attività accetta un solo prodotto.
results_limitFacoltativoNumero massimo di recensioni uniche da salvare tra le pagine della fonte; il valore predefinito è 100 e accetta numeri interi da 20 a 2.000.
regionFacoltativoRegione 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.

  1. 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.
  2. Invia la richiesta con POST a /v1/tiktok-shop/product-reviews e salva il task_id restituito.
  3. Interroga GET /v1/tasks/{task_id} finché l’attività non va a buon fine o restituisce un errore.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

Combina i dati di TikTok Shop con i dati pubblici delle altre piattaforme social supportate.

TikTok Shop Product Reviews API — FAQ

TikTok Shop Product Reviews API recupera le recensioni pubbliche dei clienti per un URL PDP supportato di TikTok Shop. Restituisce testo delle recensioni, valutazioni, dettagli di chi recensisce, immagini, timestamp, contesto di prodotto e SKU, paesi e flag espliciti sullo stato dell’acquisto, in forma normalizzata.

Usa un URL di tiktok.com o di un suo sottodominio TikTok il cui percorso corrisponde a /shop/pdp/{numeric_id} o /shop/pdp/{slug}/{numeric_id}. region ha come valore predefinito US e accetta US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP e IE.

I campi riportano solo i valori espliciti forniti con la recensione pubblica. Quando uno dei due campi è assente, considera il suo valore sconosciuto e non false, e non dedurre la verifica dell’acquisto né lo stato di incentivo.

results_limit è un massimo, non un numero garantito. La raccolta si ferma al feed di recensioni disponibile, a un confine has_more a monte o al limite, e un prodotto rimosso, non disponibile, limitato per regione o inaccessibile pubblicamente può non produrre alcun record.

Ogni recensione salvata costa 0,3 crediti SocQ, comprese tutte le recensioni uniche memorizzate tra le pagine della fonte. Un’attività senza recensioni salvate non comporta alcun addebito.