tiktok/
search-live

Cerca su TikTok LIVE per parola chiave e ottieni le dirette in onda in questo momento: ID della stanza, ID dell’host, titolo, spettatori attuali, Mi piace e orario di inizio, pronti per le ricerche di live shopping.

TikTok Live Search API

Ricerca per parola chiave
Solo dirette in onda
ID della stanza e dell’host
0,6 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 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

ParametriObbligatorioDescrizione
queryObbligatorioLa parola chiave per cui trovare dirette LIVE.
results_limitFacoltativoQuante 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.

  1. Invia con POST {"query": "deals", "results_limit": 20} a /v1/tiktok/search-live.
  2. Interroga GET /v1/tasks/{task_id} finché status è succeeded.
  3. 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.

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.

Esplora altre piattaforme

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

TikTok Live Search API — FAQ

TikTok Live Search API è un’interfaccia programmatica per trovare le dirette LIVE di TikTok in onda adesso che corrispondono a una parola chiave, con results_limit che stabilisce quante ne vengono restituite. Ogni record riporta ID della stanza, ID dell’host, titolo, spettatori attuali, Mi piace, immagine di copertina e orario di inizio.

Invia l’id di un risultato come room_id e il suo author.id come user_id a TikTok Live Shopping. Entrambi i valori devono provenire dallo stesso risultato.

results_limit accetta da 1 a 200, con 20 come valore predefinito, e l’elenco si chiude prima se corrispondono meno dirette. Ogni diretta restituita costa 0,6 crediti e una ricerca senza corrispondenze non viene addebitata.

No. Elenca le dirette in trasmissione nel momento in cui invii la ricerca e ogni record ha status live. Le trasmissioni passate non vengono restituite.

Le dirette iniziano e finiscono per tutto il giorno, quindi l’insieme in onda cambia da un’esecuzione all’altra. Usa id come chiave della diretta e collected_at come momento di ogni recupero.

La richiesta accetta solo query e results_limit. Leggi metrics.viewers_count nei risultati e filtra dalla tua parte.

Questo endpoint cerca per parola chiave. Per un account noto usa TikTok User Live, che accetta nomi utente e riporta lo stato della diretta di ciascuno.