tiktok-shop/
category-products

Elenca i prodotti di una categoria TikTok Shop partendo dal suo ID e dal mercato, con titolo, prezzo e valuta, unità vendute, valutazione, recensioni e negozio, fino a 500 per chiamata.

TikTok Shop Category Products API

Input con ID della categoria
9 mercati
Fino a 500 prodotti
0,5 crediti per risultato
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 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

ParametriObbligatorioDescrizione
category_idObbligatorioID numerico della categoria preso dal campo id di TikTok Shop Categories, come 601450.
regionFacoltativoMercato della categoria: US, SG, MY, PH, TH, VN, ID, JP oppure MX. Il valore predefinito è US.
results_limitFacoltativoNumero 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.

  1. Invia con POST {"category_id": "601450", "region": "US", "results_limit": 30} a /v1/tiktok-shop/category-products.
  2. Interroga GET /v1/tasks/{task_id}; i prodotti sono pronti quando status diventa succeeded.
  3. 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.

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.

Esplora altre piattaforme

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

TikTok Shop Category Products API — FAQ

TikTok Shop Category Products API è un’interfaccia programmatica per elencare i prodotti di una categoria TikTok Shop, identificata dal suo ID e dal mercato. Per ogni prodotto restituisce titolo, descrizione, prezzo e valuta, unità vendute, valutazione, numero di recensioni, negozio, immagini e URL della pagina.

Esegui TikTok Shop Categories e copia l’id della categoria che ti interessa. Gli ID sono composti solo da cifre, come 601450.

Qualsiasi ID di categoria dell’albero è accettato. La richiesta di esempio in Come si usa invia 601450, la categoria di primo livello Beauty & Personal Care, mentre un ID più profondo concentra l’elenco su un solo ramo.

Ogni prodotto costa 0,5 crediti, quindi i 30 prodotti predefiniti costano 15 crediti e 500 prodotti ne costano 250.