tiktok-shop/
product

Recupera un prodotto pubblico di TikTok Shop da un URL PDP, con identità, venditore, prezzo, valutazioni e vendite visibili, media, categorie e SKU in un unico record normalizzato.

TikTok Shop Product API

Dettaglio pubblico del prodotto
Input con URL PDP
Singolo record normalizzato
0,7 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

I prodotti di TikTok Shop sono pagine pubbliche di dettaglio con segnali su identità, venditore, prezzi, media, categoria, varianti, valutazioni, numero di recensioni e numero di vendite. Questi campi supportano l’arricchimento dei prodotti, la ricerca sui cataloghi, la revisione del merchandising e i confronti puntuali nel tempo.

Funzionalità della TikTok Shop Product API

  • Ricerca del dettaglio di un singolo PDPInvia un solo URL PDP pubblico supportato di TikTok Shop e ricevi al massimo un record di prodotto normalizzato: l’endpoint è adatto ad arricchire un articolo noto, non a scoprire prodotti.
  • Venditore, prezzo e segnali commerciali visibiliIl record del prodotto conserva l’identità del venditore esposta, il prezzo di vendita e originale, la valuta, lo sconto, la valutazione, il numero di recensioni e il numero di vendite, per una valutazione diretta a livello di campo.
  • Contesto di media, categoria e SKUI record restituiti includono le immagini del prodotto esposte con le relative dimensioni, oltre alle strutture di categoria e di SKU o varianti presenti nella pagina pubblica del prodotto.

Parametri della TikTok Shop Product 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.
regionFacoltativoRegione di mercato di TikTok Shop facoltativa; il valore predefinito è US, mentre la disponibilità dei prodotti nelle altre regioni accettate può variare.

Come usare la TikTok Shop Product API

Invia l’URL di un prodotto supportato, salva l’ID dell’attività asincrona e leggi il prodotto normalizzato dopo che l’attività è andata a buon fine.

  1. Invia una richiesta POST a /v1/tiktok-shop/product con un url PDP supportato e una region facoltativa.
  2. Salva il task_id restituito e interroga GET /v1/tasks/{task_id} finché lo stato è succeeded o failed.
  3. Dopo il successo leggi data.results.items e segui next_cursor solo quando has_more è true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeeded

Casi d’uso della TikTok Shop Product API

  • Arricchimento dei risultati di ricerca o di catalogo: Usa un URL PDP noto per aggiungere campi di venditore, prezzo, valutazione, media, categoria e SKU a un prodotto selezionato da una ricerca o dal catalogo di un negozio.
  • Confronto delle istantanee dei segnali del prodotto: Confronta prezzo di vendita, prezzo originale, sconto, valutazione, numero di recensioni e numero di vendite raccolti in record di prodotto di momenti diversi.
  • Revisione di categorie e varianti: Esamina le strutture di categoria, immagini e SKU esposte per capire come è organizzato e presentato un prodotto pubblico.

Consigli degli esperti per la TikTok Shop Product API

  • Verifica prima dell’invio che l’input sia un URL PDP completo di tiktok.com con un ID prodotto numerico, per evitare una richiesta rifiutata.
  • Lascia region su US, a meno che il prodotto appartenga a un altro mercato accettato, e considera un risultato vuoto fuori dagli Stati Uniti come un possibile limite di disponibilità.
  • Non inviare results_limit: un’attività accetta un solo URL di prodotto e può restituire al massimo un record normalizzato.
  • Tratta i campi nulli di venditore, prezzo, segnali, media, categoria e SKU come un’istantanea della pagina pubblica e gestisci un’attività riuscita senza elementi senza creare un prodotto segnaposto.

Oltre alla TikTok Shop Product 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 Reviews API — Raccoglie le recensioni pubbliche dall’URL della pagina prodotto di TikTok Shop con testo, valutazione, autore, immagini, SKU, paese e contesto dell’acquisto.
  • 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 API — FAQ

TikTok Shop Product API recupera un prodotto pubblico da un URL PDP supportato di TikTok Shop. Restituisce identità normalizzata, venditore, prezzo, valutazione, segnali di recensioni e vendite, media, categorie e dati SKU.

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}. Gli altri URL di TikTok vengono rifiutati come input non valido.

No. Ogni attività accetta un solo URL di prodotto, non accetta results_limit e restituisce al massimo un record di prodotto normalizzato.

Il valore predefinito di region è US e sono accettati US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP e IE. La disponibilità dei prodotti fuori dagli Stati Uniti può variare.

Un URL PDP valido può non produrre alcun record quando il prodotto è stato rimosso, non è disponibile nella regione selezionata o non è esposto nella pagina pubblica.

Ogni record di prodotto restituito costa 0,7 crediti SocQ. Un’attività che non restituisce alcun prodotto non comporta alcun addebito.