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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | L’inizio di una ricerca di prodotti da completare, come phone case. |
region | Facoltativo | Mercato 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.
- Invia con POST {"query": "phone case", "region": "US"} a /v1/tiktok-shop/search-suggestions.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- 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.
API correlate
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.