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
| 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. |
region | Facoltativo | Regione 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.
- Invia una richiesta POST a /v1/tiktok-shop/product con un url PDP supportato e una region facoltativa.
- Salva il task_id restituito e interroga GET /v1/tasks/{task_id} finché lo stato è succeeded o failed.
- 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 succeededCasi 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.
API correlate
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.