TikTok Shop User Showcase
Le vetrine utente di TikTok Shop sono esposizioni di prodotti collegate ai profili pubblici degli utenti TikTok, con identità di prodotto e venditore, prezzi, media, valutazioni, numero di recensioni e numero di vendite, quando esposti. Questi segnali commerciali supportano la revisione degli assortimenti, le istantanee regionali, il confronto tra prodotti e l’arricchimento dei dataset di ricerca.
Funzionalità della TikTok Shop User Showcase API
- Raccolta della vetrina di un solo nome utenteRaccogli i prodotti pubblici esposti per un solo nome utente TikTok, accettando l’handle con o senza @ iniziale.
- Selezione della regione di mercatoScegli uno dei 16 valori di region supportati, così la raccolta della vetrina punta al mercato pubblico di TikTok Shop desiderato.
- Risultati limitati di prodotti uniciRichiedi da 20 a 2.000 prodotti della vetrina mentre le pagine raccolte vengono deduplicate in base all’identità pubblica del prodotto.
- Contesto normalizzato di prodotto e venditoreRestituisce ID dei prodotti, titoli, descrizioni, link canonici, immagini, campi del venditore, prezzi, categorie e strutture SKU, quando esposti.
- Segnali commerciali visibili e confini pubbliciConserva valutazioni, numero di recensioni, numero di vendite, stato, regione e momento di raccolta disponibili, lasciando vuoti i campi pubblici non disponibili.
Parametri della TikTok Shop User Showcase API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio | Nome utente TikTok pubblico obbligatorio. Un’attività accetta un solo valore, con o senza @ iniziale. |
results_limit | Facoltativo | Limite richiesto di prodotti unici della vetrina da 20 a 2.000. Il valore predefinito è 100. |
region | Facoltativo | Regione di mercato: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP o IE. Il valore predefinito è US. |
Come usare la TikTok Shop User Showcase API
Invia un nome utente pubblico e un mercato come attività asincrona, poi leggi i prodotti della vetrina salvati con la paginazione a cursore.
- Prepara un nome utente TikTok pubblico, scegli una region supportata e imposta results_limit da 20 a 2.000.
- Invia la richiesta con POST a /v1/tiktok-shop/user-showcase e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
- Leggi data.results.items. Quando has_more è true, continua con next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/user-showcase" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"mrtiktokreviews","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della TikTok Shop User Showcase API
- Esaminare l’assortimento della vetrina di un utente: Usa ID dei prodotti, titoli, link, contesto del venditore, immagini e categorie per ispezionare i prodotti pubblici esposti per un nome utente.
- Confrontare prezzi e segnali di domanda visibili: Confronta prezzi, valute, sconti, valutazioni, numero di recensioni e numero di vendite disponibili nei prodotti della vetrina restituiti.
- Creare istantanee regionali delle vetrine: Salva input_username, region, identità dei prodotti, campi commerciali pubblici e collected_at per una revisione ripetibile in un dato momento.
- Arricchire un dataset di ricerca sui prodotti: Aggiungi URL canonici dei prodotti, identità del venditore, media, categorie, contesto SKU e metriche visibili a un insieme di ricerca già basato su nomi utente.
Consigli degli esperti per la TikTok Shop User Showcase API
- Usa una grafia stabile del nome utente in tutte le esecuzioni; l’endpoint accetta @handle o handle e registra con ogni prodotto il nome utente di input normalizzato.
- Scegli il mercato che corrisponde al catalogo desiderato, perché region ha come valore predefinito US e la disponibilità pubblica fuori dagli Stati Uniti può variare.
- Imposta results_limit tra 20 e 2.000 in base alla copertura necessaria, invece di presumere che ogni vetrina contenga i 100 prodotti predefiniti.
- Dopo il successo segui next_cursor finché has_more è true, così la paginazione del risultato dell’attività non lascia prodotti salvati non letti.
- Deduplica le istantanee per id del prodotto e considera le attività vuote o i campi mancanti di venditore, prezzo, media, categoria, SKU e metriche come esiti validi della fonte pubblica.
API correlate
Oltre alla TikTok Shop User Showcase 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.