TikTok Shop Search
I risultati di TikTok Shop Search sono prodotti pubblici corrispondenti a una parola chiave in un mercato selezionato, con identità di prodotto e venditore, prezzi, immagini, valutazioni, numero di recensioni e numero di vendite. Questi record commerciali supportano la scoperta regionale dei prodotti, il confronto dei prezzi, la ricerca sui venditori e istantanee di mercato ripetibili.
Funzionalità della TikTok Shop Search API
- Controllo di parola chiave e mercatoAbbina una query di prodotto a uno dei 16 valori di region supportati per cercare nel catalogo pubblico del mercato desiderato.
- Raccolta limitata di risultati uniciRichiedi da 20 a 2.000 risultati mentre le pagine raccolte vengono deduplicate in base all’identità pubblica del prodotto.
- Identità di prodotto e venditoreRestituisce ID dei prodotti, titoli, descrizioni, link canonici e dettagli esposti del venditore o del negozio.
- Prezzi e segnali commerciali visibiliConserva prezzo di vendita, prezzo originale, valuta, sconto, valutazione, numero di recensioni e numero di vendite, quando esposti.
- Contesto di media e prodottoMantiene con ogni record immagini pubbliche, categorie, strutture SKU, stato, query di ricerca, regione e momento di raccolta.
Parametri della TikTok Shop Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Parola chiave o frase di prodotto obbligatoria e non vuota. |
results_limit | Facoltativo | Limite richiesto di risultati unici da 20 a 2.000. Il valore predefinito è 100. |
region | Facoltativo | Regione di mercato: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP o IE. Il valore predefinito è US. |
Come usare la TikTok Shop Search API
Scegli una frase di prodotto concreta e un mercato, poi invia una richiesta di ricerca asincrona.
- Imposta una query non vuota, scegli una region supportata e imposta results_limit da 20 a 2.000.
- Invia la richiesta con POST a /v1/tiktok-shop/search e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
- Leggi data.results.items. Quando has_more è true, continua con next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"running shoes","results_limit":100,"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 Search API
- Scoperta regionale dei prodotti: Mappa i prodotti pubblici che corrispondono a una categoria, un’esigenza, un brand o una frase di prodotto in un mercato selezionato.
- Confronto di prezzi e sconti: Confronta i campi disponibili di prezzo di vendita, prezzo originale, valuta e sconto nei prodotti restituiti.
- Confronto di reputazione e domanda: Confronta valutazioni, numero di recensioni e numero di vendite esposti, senza convertire in zero le metriche mancanti.
- Selezione di prodotti e negozi: Usa link dei prodotti, identità del venditore, immagini, categorie e contesto SKU per scegliere i candidati da esaminare più a fondo.
Consigli degli esperti per la TikTok Shop Search API
- Salva sempre query e region insieme, perché la stessa frase può portare a cataloghi pubblici diversi.
- Imposta results_limit sul volume che ti serve e segui next_cursor finché has_more è false per leggere il risultato completo dell’attività.
- Considera un prezzo, una valutazione, un numero di recensioni o un numero di vendite mancante come non disponibile e non come zero.
- Conserva search_query e collected_at con ogni record, così le istantanee regionali restano riproducibili.
- Passa l’URL PDP di un prodotto selezionato a TikTok Shop Product API quando ti serve un arricchimento aggiornato a livello di dettaglio.
API correlate
Oltre alla TikTok Shop Search API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok Shop.
- 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 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 Search Suggestions API — Ottiene fino a 20 completamenti di ricerca in classifica che TikTok Shop suggerisce per l’inizio di una ricerca di prodotti in un mercato.