tiktok-shop/
search

Cerca i prodotti pubblici di TikTok Shop per parola chiave e regione di mercato, con campi normalizzati su prodotto, venditore, prezzo, media, valutazioni, recensioni e numero di vendite.

TikTok Shop Search API

Scoperta dei prodotti
Cataloghi regionali
Segnali commerciali
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 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

ParametriObbligatorioDescrizione
queryObbligatorioParola chiave o frase di prodotto obbligatoria e non vuota.
results_limitFacoltativoLimite richiesto di risultati unici da 20 a 2.000. Il valore predefinito è 100.
regionFacoltativoRegione 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.

  1. Imposta una query non vuota, scegli una region supportata e imposta results_limit da 20 a 2.000.
  2. Invia la richiesta con POST a /v1/tiktok-shop/search e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
  4. 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 true

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

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.

Esplora altre piattaforme

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

TikTok Shop Search API — FAQ

TikTok Shop Search API trova i prodotti accessibili pubblicamente a partire da una parola chiave e da una regione di mercato. Restituisce campi normalizzati su prodotto, venditore, prezzo, media, categoria, SKU, valutazione, numero di recensioni e numero di vendite, quando esposti.

No. TikTok Shop Search è un endpoint commerciale indipendente per i prodotti pubblici, mentre TikTok Search scopre i video social pubblici e i contenuti dei creator.

query è obbligatoria, results_limit è un numero intero da 20 a 2.000 con valore predefinito 100 e region ha come valore predefinito US.

I valori supportati sono 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 in base al catalogo pubblico del mercato.

I risultati possono includere identità di prodotto e venditore, URL canonico, descrizione, immagini, dettagli sui prezzi, categorie, SKU, stato, valutazione, numero di recensioni, numero di vendite, regione, query e momento di raccolta.

Il mercato pubblico selezionato può avere meno prodotti corrispondenti e la raccolta si ferma quando, dopo la deduplicazione, non ci sono altre pagine della fonte. Un’attività riuscita può quindi contenere nessun elemento o meno elementi di quelli richiesti.

Interroga /v1/tasks/{task_id}, leggi data.results.items dopo il successo e richiedi la pagina successiva del risultato dell’attività con next_cursor finché has_more è true.

Ogni prodotto normalizzato restituito costa 0,7 crediti SocQ. I risultati vuoti non comportano alcun addebito.