tiktok/
live-products

Elenca i prodotti nel carrello di una diretta LIVE di TikTok a partire dall’ID della stanza e dall’ID dell’host: titolo, prezzo attuale, unità vendute, ID del venditore, link al prodotto e immagine.

TikTok Live Shopping API

ID della stanza e dell’host
Prodotti nel carrello
Fino a 500 prodotti
0,1 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 Live Shopping

Il carrello di una diretta LIVE di TikTok è l’insieme dei prodotti che un host vende durante una trasmissione, e ogni prodotto al suo interno ha un titolo, un prezzo in una valuta indicata, un numero di unità vendute, un venditore e un’immagine. Leggere un carrello mostra che cosa sta spingendo una diretta, a che prezzo sono proposti quegli articoli mentre l’host è in onda e quali di essi vendono già in grandi quantità.

Funzionalità della TikTok Live Shopping API

  • Ogni prodotto nel carrelloroom_id insieme allo user_id dell’host restituisce ogni prodotto del carrello della stanza come record a sé, fino ai 500 consentiti da results_limit.
  • Prezzo come importo, valuta e testo visualizzatoprice.amount, price.currency e price.formatted forniscono il numero, il codice della valuta e la stringa che vedono gli spettatori, per esempio 41,6 come importo, USD come valuta e $41.60 come testo visualizzato.
  • Unità vendute come numero interosold_count è un numero intero come 101600, quindi i carrelli si possono ordinare e confrontare direttamente.
  • Link al prodotto, ID del venditore e immagineOgni record contiene la pagina del prodotto in url, l’ID del venditore in seller.id e l’immagine del prodotto con larghezza e altezza in media.

Parametri della TikTok Live Shopping API

ParametriObbligatorioDescrizione
room_idObbligatorioID numerico della stanza LIVE, preso dal campo id di un risultato di TikTok Live Search.
user_idObbligatorioID utente TikTok numerico dell’host, preso dal campo author.id dello stesso risultato di Live Search.
results_limitFacoltativoQuanti prodotti restituire, da 1 a 500. Il valore predefinito è 100.

Come usare la TikTok Live Shopping API

Trova una diretta di live shopping, poi elenca il suo carrello mentre è in onda.

  1. Esegui TikTok Live Search con una parola chiave legata allo shopping e prendi id e author.id di un risultato.
  2. Invia con POST {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} a /v1/tiktok/live-products.
  3. Interroga GET /v1/tasks/{task_id} finché status è succeeded, poi leggi i prodotti da results.items e ripassa results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_id":"7704767945901132575","user_id":"7153432386608251946","results_limit":100}'

# Each item is one product with title, price and sold_count.

Casi d’uso della TikTok Live Shopping API

  • Leggere il carrello LIVE di un concorrente: Prendi room_id e user_id di un host concorrente da Live Search ed elenca l’intero carrello per vedere quali prodotti e fasce di prezzo sta proponendo.
  • Seguire le variazioni di prezzo durante una trasmissione: Leggi la stessa stanza a distanza di pochi minuti e confronta price.amount per ogni id di prodotto per cogliere i ribassi che l’host annuncia in diretta.
  • Trovare i più venduti di un carrello: Ordina un carrello per sold_count per vedere quali articoli hanno già venduto più unità, poi mettili a confronto con il loro prezzo.

Consigli degli esperti per la TikTok Live Shopping API

  • Controlla price.currency prima di confrontare i prezzi di stanze diverse, perché l’importo ha senso solo insieme alla sua valuta.
  • Abbina lo stesso prodotto tra una lettura e l’altra tramite il suo id; price.amount e sold_count sono i campi che cambiano.

Oltre alla TikTok Live Shopping API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok.

  • TikTok Profiles API — Recupera identità del profilo pubblico, bio, flag dell’account e conteggi del pubblico a partire dal nome utente.
  • TikTok Hashtags API — Raccoglie video pubblici, creator, media, suoni ed engagement per gli hashtag indicati.
  • TikTok Comments API — Raccoglie i commenti pubblici di primo livello, autori, engagement, menzioni e flag di interazione del creator.
  • TikTok Videos API — Recupera creator, didascalia, media, musica, tag, menzioni ed engagement dagli URL dei video.
  • TikTok Live Room Info API — Consulta una diretta nota tramite la coppia di ID della stanza e del proprietario, restituendo stato, contesto del proprietario, immagine di copertina e conteggi del pubblico.
  • TikTok Live Search API — Trova per parola chiave le dirette LIVE in onda in questo momento, con host, titoli e spettatori attuali.

Esplora altre piattaforme

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

TikTok Live Shopping API — FAQ

TikTok Live Shopping API è un’interfaccia programmatica per elencare i prodotti nel carrello di una diretta LIVE di TikTok, a partire dal room_id della diretta e dallo user_id dell’host. Restituisce per ogni prodotto titolo, prezzo, unità vendute, ID del venditore, link e immagine.

Esegui TikTok Live Search e prendi l’id di un risultato come room_id e il suo author.id come user_id. La coppia deve provenire dallo stesso risultato.

results_limit accetta da 1 a 500, con 100 come valore predefinito, e si ferma prima se il carrello è più piccolo. Ogni prodotto restituito costa 0,1 crediti, quindi un carrello completo di 500 prodotti costa 50 crediti.

L’host non ha un carrello in quella stanza oppure la stanza non è più in onda. Un risultato vuoto non viene addebitato.

No, la stanza deve essere in onda quando richiedi il carrello. Leggilo mentre la diretta è in corso e salvalo se ti serve l’assortimento in seguito.

sold_count è il numero di unità vendute che TikTok riporta per il prodotto ed è null quando non ne viene riportato nessuno. Per vedere che cosa si vende durante una trasmissione, leggi il carrello due volte e calcola la differenza.