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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
room_id | Obbligatorio | ID numerico della stanza LIVE, preso dal campo id di un risultato di TikTok Live Search. |
user_id | Obbligatorio | ID utente TikTok numerico dell’host, preso dal campo author.id dello stesso risultato di Live Search. |
results_limit | Facoltativo | Quanti 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.
- Esegui TikTok Live Search con una parola chiave legata allo shopping e prendi id e author.id di un risultato.
- Invia con POST {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} a /v1/tiktok/live-products.
- 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.
API correlate
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.
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API