TikTok Shop Categories
Le categorie di TikTok Shop sono la tassonomia dei prodotti di un mercato, in cui ogni categoria ha un ID, un nome nella lingua locale, uno slug inglese, un livello di profondità, una categoria madre e la catena dei nomi che la precedono. Disposte ad albero, mostrano come un mercato raggruppa i suoi prodotti e forniscono gli ID necessari per mappare i cataloghi, pianificare ricerche per categoria ed esplorare un singolo ramo.
Funzionalità della TikTok Shop Categories API
- Tutte le categorie in una chiamataUna sola richiesta restituisce l’intero albero del mercato scelto, dai settori di primo livello fino alle sottocategorie più profonde, ognuna come riga a sé.
- Categoria madre, livello e foglieparent_id collega ogni riga alla categoria superiore, level conta la profondità partendo da 1 in cima, e is_leaf segnala le categorie senza sottocategorie.
- Nomi degli antenati in pathpath elenca dall’alto verso il basso i nomi di tutte le categorie sopra una riga, così una categoria profonda si mostra nel suo contesto senza percorrere l’albero.
- ID che aprono i prodotti di una categoriaOgni id può essere passato come category_id a TikTok Shop Category Products per elencare i prodotti archiviati in quella categoria.
Parametri della TikTok Shop Categories API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
region | Facoltativo | Mercato di cui restituire l’albero delle categorie: US, SG, MY, PH, TH, VN, ID, JP oppure MX. Il valore predefinito è US. |
Come usare la TikTok Shop Categories API
Richiedi l’albero di un mercato e ricostruiscilo dalle righe restituite.
- Invia con POST {"region": "US"} a /v1/tiktok-shop/categories, oppure ometti region per ottenere l’albero US.
- Interroga GET /v1/tasks/{task_id} finché l’attività non è riuscita.
- Raccogli tutte le righe da results.items, seguendo results.next_cursor finché has_more è true, poi annida le righe per parent_id.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region":"US"}'Casi d’uso della TikTok Shop Categories API
- Ricostruire il menu delle categorie: Annida le righe per parent_id e ordinale per level per ricreare la navigazione per categorie del mercato, usando name per le etichette e cover_url per le icone.
- Collegare le categorie al tuo catalogo: Confronta name, slug e path con le tue categorie di prodotto per tradurre la tua tassonomia in quella che TikTok Shop usa in quel mercato e viceversa.
- Pianificare una scansione per categoria: Filtra le righe sotto un settore scelto con is_leaf uguale a true per costruire l’elenco di ID da inviare a TikTok Shop Category Products.
Consigli degli esperti per la TikTok Shop Categories API
- Quando has_more è true, segui results.next_cursor fino all’ultima pagina prima di costruire l’albero, perché una pagina mancante lascia righe figlie senza la loro categoria madre.
- Considera radici dell’albero le righe con parent_id vuoto e level 1; il loro path è un elenco vuoto.
- Invia gli ID delle categorie a TikTok Shop Category Products con la stessa region usata per leggere l’albero, perché ogni albero appartiene a un solo mercato.
API correlate
Oltre alla TikTok Shop Categories 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 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 Category Products API — Elenca i prodotti di una categoria TikTok Shop per ID della categoria e mercato, con prezzo, unità vendute, valutazione, recensioni e negozio.