TikTok User Live
Lo stato live di un account TikTok descrive se sta trasmettendo in un dato momento, mentre una diretta attiva può avere un titolo della stanza, una copertina e un numero di spettatori. Conservare insieme a quello stato l’identità del creator e l’orario aiuta a capire quale account era in diretta e quanto sono recenti le informazioni.
Funzionalità della TikTok User Live API
- Scopri se la ricerca ha trovato un account live o offlineOgni ricerca riuscita restituisce is_live come true per live o false per offline, così un account che non trasmette ha comunque un record di stato invece di sparire semplicemente dai risultati.
- Vedi i dettagli della stanza di una diretta attivaUn record live può includere il titolo della stanza, il nome del creator, l’immagine di copertina e il numero di spettatori, dandoti informazioni sulla diretta e non solo uno stato sì o no.
- Parti dagli handle degli account e non dagli identificatori delle stanzeCerca più nomi utente pubblici in una sola richiesta senza dover prima trovare room_id e user_id, necessari per la ricerca separata dei dettagli della stanza live.
Parametri della TikTok User Live API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Elenco obbligatorio di almeno un handle di account pubblico, con o senza @; nel Playground inserisci un nome utente per riga, mentre in JSON usa un array come ["thejustalex", "@tiktok"] e non URL di profili. |
Come usare la TikTok User Live API
La richiesta avvia un’attività di raccolta in background, quindi la prima risposta contiene un ID attività e non i dati finali; usa quell’ID per controllare l’avanzamento e recuperare i risultati.
- Prepara uno o più nomi utente pubblici e non link a profili o a stanze live; puoi copiare l’handle dopo la @ dal profilo di un account.
- Prima di eseguire l’esempio, sostituisci $SOCQ_API_KEY con la tua chiave API oppure imposta quella variabile d’ambiente. Invia l’input JSON a POST /v1/tiktok/user-live con l’intestazione Authorization mostrata qui sotto, poi salva il task_id dalla risposta.
- Usa GET /v1/tasks/{task_id} con l’ID salvato per controllare l’avanzamento. queued significa in attesa, running significa raccolta in corso e retrying significa che è in corso un nuovo tentativo. Attendi succeeded prima di leggere i risultati; se l’attività è failed, leggi error_message per conoscere il motivo.
- Quando l’attività riesce, leggi data.results.items: ogni elemento di questo elenco descrive lo stato di un account controllato con successo. Un elenco vuoto significa che l’attività è terminata senza restituire alcun record.
- Se data.results.has_more è true, il valore next_cursor è il segnaposto per un’altra pagina di risultati salvati. Copialo senza modifiche nel parametro cursor di GET /v1/tasks/{task_id}?cursor=... e continua finché has_more è false.
curl -X POST "https://api.socq.ai/v1/tiktok/user-live" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["thejustalex"]}'Casi d’uso della TikTok User Live API
- Prepara una bacheca dello stato live degli account: Crea una tabella con ogni creator, lo stato live o offline e l’orario di raccolta, così chiunque può controllare quali degli account forniti erano in diretta all’ultima osservazione.
- Crea un elenco di revisione delle dirette attive: Seleziona i record con is_live=true e combina i link alle stanze, i titoli e i numeri di spettatori in un elenco di stanze attive da aprire e rivedere.
Consigli degli esperti per la TikTok User Live API
- Prima di inviare un elenco ripetuto di handle, rimuovi le @ iniziali e deduplica senza distinguere maiuscole e minuscole, così tiktok e @TikTok non gonfiano la stima del numero di input.
- Quando un record indica is_live=false, mostralo come offline e lascia vuoti i campi mancanti della stanza invece di segnalare che la ricerca dell’account è fallita.
- Per una bacheca di stato che aggiorni tu stesso, mostra collected_at accanto allo stato, così un risultato precedente non viene scambiato per un’osservazione appena effettuata.
- Se hai già un room_id e uno user_id corrispondenti e vuoi una ricerca separata della stanza, usa TikTok Live Room Info invece di inviare quegli ID nel campo usernames.
API correlate
Oltre alla TikTok User Live 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 Videos API — Recupera creator, didascalia, media, musica, tag, menzioni ed engagement dagli URL dei video.
- TikTok User Videos API — Raccoglie i video pubblici del feed di un profilo a partire dal nome utente con didascalie, creator, media, date, engagement e contesto dell’account di origine.
- 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 Trending Feed API — Raccoglie il feed video pubblico attuale di una regione con creator, didascalia, copertina, data ed engagement visibile.
- TikTok Live Shopping API — Elenca i prodotti nel carrello di una diretta LIVE, con prezzi attuali e unità vendute.
- TikTok Hashtags API
- TikTok Comments API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List 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 Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live 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