tiktok-shop/
categories

Recupera l’albero completo delle categorie di prodotto di un mercato TikTok Shop con un codice di regione facoltativo, una riga per categoria con ID, nome, slug inglese, livello, categoria madre e percorso.

TikTok Shop Categories API

Albero completo delle categorie
Regione facoltativa
Categoria madre e livello
ID delle categorie
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 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

ParametriObbligatorioDescrizione
regionFacoltativoMercato 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.

  1. Invia con POST {"region": "US"} a /v1/tiktok-shop/categories, oppure ometti region per ottenere l’albero US.
  2. Interroga GET /v1/tasks/{task_id} finché l’attività non è riuscita.
  3. 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.

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.

Esplora altre piattaforme

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

TikTok Shop Categories API — FAQ

TikTok Shop Categories API è un’interfaccia programmatica per ottenere l’albero completo delle categorie di prodotto di un mercato TikTok Shop, scelto con un codice di regione facoltativo. Per ogni categoria restituisce ID, nome, slug inglese, categoria madre, livello, flag di foglia, percorso degli antenati e URL dell’icona.

region accetta US, SG, MY, PH, TH, VN, ID, JP e MX, e se lo ometti viene usato US.

Seleziona le righe il cui parent_id è uguale all’id di quella categoria. Una riga con is_leaf impostato su true non ha sottocategorie e chiude il suo ramo.

name segue la lingua di visualizzazione del mercato, mentre slug fornisce un’etichetta URL in inglese per ogni categoria, utile quando leggi mercati in altre lingue.

Ogni chiamata costa 0,5 crediti e restituisce tutte le categorie del mercato, qualunque sia il numero di righe dell’albero.