TikTok Live Search
Una stanza LIVE di TikTok è una singola trasmissione in corso, identificata da un ID della stanza e con un titolo, un host, un numero di spettatori aggiornato, i Mi piace accumulati e un orario di inizio. Abbinare queste stanze a una parola chiave mostra chi è in diretta su un argomento in questo momento e quanto è grande ogni pubblico, il punto di partenza per la ricerca sul live shopping, lo scouting di host e il monitoraggio dell’attività in diretta intorno a un brand.
Funzionalità della TikTok Live Search API
- Una parola chiave in ingresso, le dirette in onda in uscitaquery accetta una parola chiave e restituisce le dirette in trasmissione in quel momento, ciascuna con status impostato su live.
- ID della stanza e ID dell’host nello stesso recordid è l’ID della stanza e author.id l’ID utente dell’host, i due valori di cui TikTok Live Shopping ha bisogno per elencare i prodotti di quella diretta.
- Pubblico al momento della raccoltametrics.viewers_count è il numero di persone presenti nella stanza e metrics.likes_count i Mi piace raccolti, con l’orario indicato in collected_at.
- Titolo, orario di inizio, copertina e pagina LIVEOgni record contiene il titolo della diretta, l’orario di inizio in published_at, l’immagine di copertina in media e il link alla pagina LIVE dell’host in url, oltre a handle, nome visualizzato e avatar dell’host.
Parametri della TikTok Live Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | La parola chiave per cui trovare dirette LIVE. |
results_limit | Facoltativo | Quante dirette restituire, da 1 a 200. Il valore predefinito è 20. |
Come usare la TikTok Live Search API
Cerca una parola chiave e leggi le dirette in onda adesso.
- Invia con POST {"query": "deals", "results_limit": 20} a /v1/tiktok/search-live.
- Interroga GET /v1/tasks/{task_id} finché status è succeeded.
- Leggi le dirette da results.items e ripassa results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"deals","results_limit":20}'
# id is the room ID; author.id is the host ID for TikTok Live Shopping.Casi d’uso della TikTok Live Search API
- Osservare le vendite in diretta dei concorrenti: Cerca le parole di prodotto che chi vende pronuncia in diretta, come deals, poi passa l’id e l’author.id di ogni stanza a TikTok Live Shopping per leggere che cosa c’è nel carrello.
- Misurare l’attività in diretta intorno a una parola chiave: Esegui la stessa query a intervalli regolari e registra quante dirette sono in onda e il loro viewers_count, per vedere quando un argomento o un brand attira pubblico in diretta.
- Selezionare host per le collaborazioni: Raccogli gli host in diretta sul tuo argomento e ordinali per viewers_count e likes_count prima di contattarli.
Consigli degli esperti per la TikTok Live Search API
- Cerca più formulazioni della stessa nicchia e unisci gli elenchi tramite id, perché ogni parola chiave restituisce il proprio insieme di dirette e una diretta può corrispondere a più di una.
- Salva id e author.id separatamente: id identifica una singola trasmissione e author.id l’host, quindi segui un host nei diversi giorni tramite author.id.
- Per seguire nel tempo gli spettatori di una singola stanza, passa dalle ricerche ripetute a TikTok Live Room Info con quel room_id e quello user_id.
API correlate
Oltre alla TikTok Live Search 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 Search API — Cerca video pubblici per parola chiave con ordinamento e filtri di pubblicazione supportati.
- 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 Search Users API — Cerca account TikTok pubblici per parola chiave.
- TikTok Live Shopping API — Elenca i prodotti nel carrello di una diretta LIVE, con prezzi attuali e unità vendute.
- TikTok Comments API
- TikTok Videos 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 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