tiktok-shop/
products

Raccogli i prodotti pubblici da un URL di un negozio TikTok Shop, con identità, prezzi, immagini, contesto del venditore, valutazioni, recensioni e numero di vendite come record normalizzati.

TikTok Shop Products API

URL di un solo negozio
Più venduti o novità
Da 20 a 2.000 prodotti richiesti
Record di prodotto normalizzati
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 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

ParametriObbligatorioDescrizione
urlObbligatorioURL pubblico di un negozio TikTok Shop obbligatorio nel formato /shop/store/{slug}/{numeric_shop_id}; un’attività accetta un solo negozio.
results_limitFacoltativoNumero 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_byFacoltativoOrdinamento 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.
regionFacoltativoRegione 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.

  1. Prepara un URL /shop/store/{slug}/{numeric_shop_id} supportato e scegli i valori di results_limit, sort_by e region.
  2. Invia la richiesta con POST a /v1/tiktok-shop/products e salva il task_id restituito.
  3. Interroga /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/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 true

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

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.

Esplora altre piattaforme

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

TikTok Shop Products API — FAQ

TikTok Shop Products API raccoglie i record dei prodotti pubblici da un URL di negozio TikTok Shop supportato. Restituisce identità normalizzata del prodotto, contesto del venditore, prezzi, immagini, categorie, dati SKU, valutazioni, numero di recensioni, numero di vendite e momento di raccolta.

url deve usare tiktok.com o un sottodominio TikTok e corrispondere a /shop/store/{slug}/{numeric_shop_id}. La richiesta accetta anche results_limit da 20 a 2.000, sort_by come top o new_releases e un valore di region documentato.

top richiede l’ordinamento dei più venduti della fonte, mentre new_releases richiede l’ordinamento delle ultime novità. Sono modalità di ordinamento della fonte e non garantiscono redditività, stato di tendenza o una classifica completa dell’inventario.

Ogni riga normalizzata può includere identità di prodotto e venditore, un URL canonico, titolo o descrizione, immagini, prezzi, sconto, valutazione, numero di recensioni, numero di vendite, stato, categorie, SKU, URL di input, regione e momento di raccolta. I contatori a livello di negozio esterni alle singole righe di prodotto non fanno parte della specifica del record normalizzato.

results_limit è un massimo e non un numero garantito. La raccolta si ferma quando la regione selezionata non espone altri prodotti o un altro cursore, e gli ID di prodotto esposti in duplicato vengono salvati una sola volta per attività.

Dopo che l’attività è andata a buon fine, leggi data.results.items da GET /v1/tasks/{task_id}. Quando has_more è true, passa next_cursor allo stesso endpoint dell’attività finché has_more diventa false.

Ogni record di prodotto restituito costa 0,7 crediti SocQ. La stima della richiesta usa results_limit, oppure 100 se omesso, e un insieme di risultati vuoto non comporta alcun addebito.