tiktok-shop/
user-showcase

Raccogli i prodotti esposti nella vetrina Shop di un utente TikTok pubblico per nome utente e regione, con campi su venditore, prezzo, media, valutazioni, recensioni e numero di vendite.

TikTok Shop User Showcase API

Input con nome utente
Prodotti della vetrina
Cataloghi regionali
0,7 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 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

ParametriObbligatorioDescrizione
usernameObbligatorioNome utente TikTok pubblico obbligatorio. Un’attività accetta un solo valore, con o senza @ iniziale.
results_limitFacoltativoLimite richiesto di prodotti unici della vetrina da 20 a 2.000. Il valore predefinito è 100.
regionFacoltativoRegione 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.

  1. Prepara un nome utente TikTok pubblico, scegli una region supportata e imposta results_limit da 20 a 2.000.
  2. Invia la richiesta con POST a /v1/tiktok-shop/user-showcase e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
  4. 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 true

Casi 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.

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.

Esplora altre piattaforme

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

TikTok Shop User Showcase API — FAQ

TikTok Shop User Showcase API raccoglie i prodotti Shop esposti pubblicamente per un nome utente TikTok e un mercato selezionato. Restituisce campi normalizzati su prodotto, venditore, prezzo, media, categoria, SKU, valutazione, numero di recensioni e numero di vendite, quando esposti.

Invia una sola stringa di nome utente non vuota. Sono accettati sia mrtiktokreviews sia @mrtiktokreviews, e la @ iniziale viene rimossa prima della raccolta.

results_limit accetta numeri interi da 20 a 2.000 e ha come valore predefinito 100. region ha come valore predefinito US e accetta anche GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP e IE.

I risultati possono includere identità di prodotto e venditore, URL canonico, titolo, descrizione, immagini, dettagli sui prezzi, categorie, SKU, stato, valutazione, numero di recensioni, numero di vendite, nome utente di input, regione e momento di raccolta.

Un profilo pubblico può non avere prodotti di vetrina disponibili nel mercato selezionato e la fonte può omettere valori di venditore, prezzo, media, categoria, SKU o metriche. Un’attività riuscita può quindi contenere nessun elemento o record con campi facoltativi vuoti.

Interroga /v1/tasks/{task_id}, leggi data.results.items dopo il successo e richiedi la pagina successiva del risultato dell’attività con next_cursor finché has_more è true.

Ogni prodotto normalizzato della vetrina restituito costa 0,7 crediti SocQ. I risultati vuoti non comportano alcun addebito.