TikTok Live Room Info
TikTok Live Room Info rappresenta una vista puntuale di una diretta pubblica attiva, con titolo, stato, identità del proprietario, immagine di copertina e numero visibile di spettatori e di Mi piace. Questi campi supportano i controlli dello stato della diretta, le istantanee del pubblico, l’arricchimento delle dirette e la reportistica con timestamp per dirette già note.
Funzionalità della TikTok Live Room Info API
- Ricerca abbinata di stanza e proprietarioRisolve una diretta nota a partire da room_id e dallo user_id corrispondente del proprietario, restituendo al massimo un record live_room normalizzato.
- Contesto della diretta e del proprietarioRestituisce il titolo e lo stato attuali della diretta insieme a ID pubblico, nome utente e nome visualizzato del proprietario.
- Istantanea di pubblico e copertinaCattura numero visibile di spettatori, numero di Mi piace, immagine di copertina pubblica e timestamp di raccolta per un’interpretazione riferita a un dato momento.
Parametri della TikTok Live Room Info API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
room_id | Obbligatorio | Identificatore obbligatorio e non vuoto della diretta. Fornisci l’identificatore numerico come stringa, da una fonte che espone la sessione live TikTok in corso. |
user_id | Obbligatorio | Identificatore utente TikTok numerico obbligatorio e non vuoto del proprietario della diretta, fornito come stringa e abbinato alla stessa diretta. |
Come usare la TikTok Live Room Info API
Abbina gli identificatori di una diretta attiva nota, invia una ricerca asincrona, poi leggi l’istantanea normalizzata dai risultati dell’attività.
- Ottieni room_id da una fonte che espone la sessione live TikTok in corso e ottieni lo user_id corrispondente del proprietario dallo stesso contesto o da un risultato di TikTok Profiles.
- Invia con POST entrambi gli identificatori come stringhe non vuote a /v1/tiktok/live-room-info.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed.
- Leggi data.results.items da /v1/tasks/{task_id}?limit=50; una diretta risolta produce al massimo un record e il next_cursor standard si applica solo se results.has_more è true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-room-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id":"7523685855395842871","user_id":"6742945285876515845"}'
# Poll GET /v1/tasks/{task_id}, then read data.results.items from /v1/tasks/{task_id}?limit=50.Casi d’uso della TikTok Live Room Info API
- Controlli puntuali dello stato della diretta: Usa stato, titolo, ID della diretta e valore collected_at restituiti per confermare l’istantanea disponibile per una diretta nota.
- Report sulle istantanee del pubblico: Registra viewers_count e likes_count con collected_at per confrontare osservazioni fatte in momenti diversi durante una trasmissione nota.
- Arricchimento delle dirette: Associa ID del proprietario, nome utente, nome visualizzato, titolo della diretta, stato e immagine di copertina a un record di diretta esistente.
Consigli degli esperti per la TikTok Live Room Info API
- Mantieni room_id abbinato allo user_id del proprietario della stessa sessione attiva; un’associazione errata tra diretta e utente può non restituire alcun record o un errore della fonte specifico dell’input.
- Conserva entrambi gli identificatori come stringhe, così gli ID numerici lunghi di TikTok non vengono arrotondati da un client o da un database.
- Esegui la ricerca mentre la diretta dovrebbe essere in corso e considera un risultato vuoto come diretta terminata, non disponibile, non valida o non corrispondente, non come un record di diretta offline individuato.
- Usa collected_at come momento di osservazione per stato e metriche; created_at è null e url è vuoto nel record normalizzato.
API correlate
Oltre alla TikTok Live Room Info 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 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 Search Users API — Cerca account TikTok pubblici per parola chiave.
- TikTok Top Search API — Cerca per parola chiave video e post con immagini, con didascalie, creator e conteggi delle interazioni.
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs 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 Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API