TikTok Shop Products
I prodotti di TikTok Shop sono schede pubbliche di vetrina con identità del prodotto, contesto del venditore, immagini, prezzi, categorie, dati SKU, valutazioni, numero di recensioni e numero di vendite. Questi record supportano le istantanee del catalogo di un negozio, il confronto degli assortimenti, il monitoraggio dei prezzi pubblici e l’arricchimento a livello di prodotto.
Funzionalità della TikTok Shop Products API
- Controlli del catalogo a livello di negozioRaccogli i prodotti da un URL pubblico di negozio supportato con un limite di risultati richiesto, un ordinamento per più venduti o novità e una regione di mercato documentata.
- Identità di prodotto, venditore e mediaRestituisce in ogni record ID dei prodotti, titoli, descrizioni disponibili, URL canonici, identità del venditore o del negozio e riferimenti pubblici alle immagini deduplicati.
- Prezzi e segnali commerciali visibiliConserva prezzi di vendita e originali esposti, valuta, valori formattati, sconti, valutazioni, numero di recensioni e numero di vendite per il confronto tra prodotti.
- Righe di catalogo strutturateMantiene stato, categoria e strutture SKU disponibili nelle righe di prodotto normalizzate, escludendo i contatori a livello di negozio che non sono collegati a un singolo prodotto.
Parametri della TikTok Shop Products API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | URL pubblico di un negozio TikTok Shop obbligatorio nel formato /shop/store/{slug}/{numeric_shop_id}; un’attività accetta un solo negozio. |
results_limit | Facoltativo | Numero massimo di prodotti unici da salvare tra le pagine della fonte; il valore predefinito è 100 e accetta numeri interi da 20 a 2.000. |
sort_by | Facoltativo | Ordinamento della fonte per il catalogo del negozio: top per l’ordinamento dei più venduti o new_releases per l’ordinamento delle ultime novità; il valore predefinito è top. |
region | Facoltativo | Regione di mercato di TikTok Shop; il valore predefinito è US e la disponibilità pubblica del catalogo nelle altre regioni accettate può variare. |
Come usare la TikTok Shop Products API
Invia l’URL di un negozio pubblico di TikTok Shop con controlli di raccolta facoltativi, segui l’attività asincrona e leggi i record di prodotto normalizzati con la paginazione a cursore.
- Prepara un URL /shop/store/{slug}/{numeric_shop_id} supportato e scegli i valori di results_limit, sort_by e region.
- Invia la richiesta con POST a /v1/tiktok-shop/products e salva il task_id restituito.
- Interroga /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/products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079","results_limit":100,"sort_by":"top","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 Products API
- Istantanee del catalogo della vetrina: Usa ID dei prodotti, titoli, URL, venditori, prezzi, immagini, categorie, strutture SKU e collected_at per ricostruire il catalogo pubblico di un negozio in un dato momento.
- Confronto tra assortimento dei più venduti e delle novità: Raccogli lo stesso negozio con ordinamento top e new_releases, poi confronta identità dei prodotti, prezzi, categorie e segnali visibili dei prodotti restituiti.
- Monitoraggio di prezzi e segnali pubblici: Confronta i campi raccolti in modo indipendente di prezzo, sconto, valutazione, numero di recensioni, numero di vendite, stato e momento di raccolta per ID di prodotto corrispondenti.
- Preparazione di un elenco ristretto di URL di prodotti: Usa URL canonici dei prodotti, titoli, immagini, contesto del venditore e metriche visibili per selezionare i prodotti restituiti da usare in flussi di dettaglio o di recensioni.
Consigli degli esperti per la TikTok Shop Products API
- Verifica che l’input usi un percorso pubblico /shop/store/ di tiktok.com con un ID negozio numerico prima di inviare l’attività.
- Imposta region sul mercato del negozio che vuoi esaminare; quando un negozio valido non restituisce record, verifica la disponibilità regionale prima di riprovare.
- Usa top per l’ordinamento dei più venduti della fonte o new_releases per quello delle ultime novità, e non interpretare nessuna delle due modalità come una garanzia di redditività o di tendenza.
- Considera results_limit come il massimo della raccolta e continua con il cursore separato del risultato dell’attività finché has_more è false, per leggere ogni riga salvata.
- Usa l’ID del prodotto come chiave per le istantanee ripetute, conserva collected_at e gestisci i campi di venditore, prezzo, stato, categoria, SKU, media e metriche come facoltativi.
API correlate
Oltre alla TikTok Shop Products 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 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 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.