TikTok Shop Category Products
I prodotti di una categoria TikTok Shop sono gli articoli archiviati sotto una categoria di un mercato, ognuno con titolo, descrizione, prezzo e valuta, unità vendute, valutazione, numero di recensioni, negozio e immagini. Raccolti categoria per categoria, rivelano le fasce di prezzo, i più venduti e i negozi attivi di un settore e come cambiano da una sottocategoria all’altra.
Funzionalità della TikTok Shop Category Products API
- Esplorazione per ID di categoria invece che per parola chiavecategory_id accetta l’ID numerico restituito da TikTok Shop Categories, così i prodotti di una categoria si leggono direttamente senza indovinare i termini di ricerca.
- Nove mercati, US come predefinitoregion copre US, SG, MY, PH, TH, VN, ID, JP e MX e usa US quando viene omesso.
- Fino a 500 prodotti per categoriaresults_limit va da 1 a 500 con un valore predefinito di 30, quindi una richiesta può prendere un campione rapido o una porzione ampia di una categoria.
- Campi commerciali su ogni prodottoOgni riga contiene title, text, price con importo e valuta, sold_count, rating, reviews_count, seller e le immagini in media, più url per la pagina del prodotto.
Parametri della TikTok Shop Category Products API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
category_id | Obbligatorio | ID numerico della categoria preso dal campo id di TikTok Shop Categories, come 601450. |
region | Facoltativo | Mercato della categoria: US, SG, MY, PH, TH, VN, ID, JP oppure MX. Il valore predefinito è US. |
results_limit | Facoltativo | Numero di prodotti da restituire, da 1 a 500. Il valore predefinito è 30. |
Come usare la TikTok Shop Category Products API
Prendi un ID di categoria da TikTok Shop Categories e leggi i prodotti che contiene.
- Invia con POST {"category_id": "601450", "region": "US", "results_limit": 30} a /v1/tiktok-shop/category-products.
- Interroga GET /v1/tasks/{task_id}; i prodotti sono pronti quando status diventa succeeded.
- Leggi i prodotti da results.items e, se has_more è true, richiedi la pagina successiva con results.next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/category-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category_id":"601450","region":"US","results_limit":30}'Casi d’uso della TikTok Shop Category Products API
- Confrontare le fasce di prezzo tra sottocategorie: Esegui una richiesta per ogni categoria figlia e confronta la distribuzione di price.amount per vedere a quali prezzi si collocano i prodotti di ciascuna sottocategoria.
- Seguire i più venduti di una categoria: Rilancia periodicamente una categoria e segui sold_count per ogni id di prodotto per trovare gli articoli che continuano a vendere unità.
- Mappare i negozi di un settore: Raggruppa i prodotti per seller.id e seller.name per trovare i negozi con più articoli e con le vendite più alte in una categoria.
Consigli degli esperti per la TikTok Shop Category Products API
- Usa la stessa region da cui hai letto l’ID della categoria in TikTok Shop Categories, perché ogni mercato ha il suo albero delle categorie.
- Salva il category_id inviato accanto a ogni prodotto che conservi, perché la categoria deriva dalla tua richiesta e non da un campo della riga del prodotto.
- Usa id come chiave dei prodotti quando unisci più categorie o esecuzioni ripetute, così un prodotto raccolto due volte viene contato una volta sola.
API correlate
Oltre alla TikTok Shop Category Products 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 Categories API — Recupera l’albero completo delle categorie di un mercato TikTok Shop con ID, nomi, slug inglesi, livelli, categorie madri e percorsi.