tiktok-shop/
search-suggestions

Ottieni i completamenti che TikTok Shop suggerisce per l’inizio di una ricerca di prodotti in un mercato scelto, con fino a 20 frasi chiave in classifica da 1 insieme a query e regione.

TikTok Shop Search Suggestions API

Input con query parziale
Fino a 20 completamenti
Classifica da 1
0,5 crediti per richiesta
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 Suggestions

I suggerimenti di ricerca di TikTok Shop sono i completamenti che la casella di ricerca dello shop propone mentre chi acquista digita, ognuno una frase chiave completa con la sua posizione nell’elenco e il mercato in cui è stato suggerito. Poiché derivano da ciò che le persone cercano davvero, queste frasi fanno emergere varianti di prodotto, modelli compatibili e motivazioni d’acquisto da usare nei titoli degli articoli, negli annunci e nei contenuti.

Funzionalità della TikTok Shop Search Suggestions API

  • Completamenti per una ricerca parzialequery accetta le prime parole di una ricerca, come phone case, e ogni riga restituisce una frase più lunga, come phone cases 17 pro max, con cui chi acquista la completa.
  • L’ordine dei suggerimenti di TikTok Shoprank numera i suggerimenti da 1 nell’ordine in cui li mostra TikTok Shop, fino a 20 per query.
  • Suggerimenti per mercatoregion seleziona uno tra US, SG, MY, PH, TH, VN, ID, JP e MX, con US come predefinito, e ogni riga ripete query e regione così i risultati restano tracciabili.

Parametri della TikTok Shop Search Suggestions API

ParametriObbligatorioDescrizione
queryObbligatorioL’inizio di una ricerca di prodotti da completare, come phone case.
regionFacoltativoMercato della ricerca: US, SG, MY, PH, TH, VN, ID, JP oppure MX. Il valore predefinito è US.

Come usare la TikTok Shop Search Suggestions API

Invia le prime parole di una ricerca di prodotti e leggi i completamenti in ordine di classifica.

  1. Invia con POST {"query": "phone case", "region": "US"} a /v1/tiktok-shop/search-suggestions.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. Leggi keyword e rank da results.items; quando has_more è true, recupera il resto con results.next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"phone case","region":"US"}'

Casi d’uso della TikTok Shop Search Suggestions API

  • Scegliere le parole chiave per i titoli degli articoli: Scegli le frasi chiave che citano modelli, taglie o varianti e inseriscile nei titoli e nelle descrizioni dei prodotti.
  • Creare set di parole chiave per annunci e contenuti: Raccogli la colonna keyword da diverse query di partenza per comporre elenchi di parole chiave per annunci, didascalie dei video e pianificazione dei contenuti.
  • Seguire come cambiano i suggerimenti: Rilancia nel tempo la stessa query con la stessa regione e confronta il rank di ogni keyword per vedere quali frasi salgono, scendono o compaiono per la prima volta.
  • Confrontare come i mercati completano una ricerca: Invia una query a più regioni e affianca gli elenchi di keyword per vedere come chi acquista in ogni mercato completa le stesse parole.

Consigli degli esperti per la TikTok Shop Search Suggestions API

  • Parti da una radice breve invece che da una frase completa, perché i suggerimenti estendono l’inizio della query e una frase lunga lascia poco da completare.
  • Scendi di un livello reinviando una keyword restituita come nuova query, così un solo seme diventa un albero di frasi più lunghe.
  • Elimina i duplicati tra più semi su keyword, che è anche l’id della riga, perché radici simili possono restituire la stessa frase.
  • Passa una keyword promettente a TikTok Shop Search con la stessa regione per vedere i prodotti dietro quel suggerimento.

Oltre alla TikTok Shop Search Suggestions 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 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 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 Search Suggestions API — FAQ

TikTok Shop Search Suggestions API è un’interfaccia programmatica per ottenere i completamenti di ricerca che TikTok Shop propone per l’inizio di una ricerca di prodotti in un mercato. Restituisce fino a 20 frasi chiave suggerite, ciascuna con la sua posizione, la query originale e la regione.

Ogni richiesta accetta una sola query. Per coprire più parole chiave di partenza, invia una richiesta per ciascuna e unisci i risultati su keyword.

Ogni chiamata costa 0,5 crediti e restituisce fino a 20 suggerimenti; il prezzo è per chiamata, non per suggerimento.