tiktok/
live-room-info

Recupera una diretta TikTok pubblica tramite gli ID abbinati di stanza e proprietario, con titolo, stato, identità del proprietario, immagine di copertina, numero di spettatori, numero di Mi piace e momento di raccolta.

TikTok Live Room Info API

Diretta nota
Istantanea del pubblico
Contesto del proprietario
0,5 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 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

ParametriObbligatorioDescrizione
room_idObbligatorioIdentificatore obbligatorio e non vuoto della diretta. Fornisci l’identificatore numerico come stringa, da una fonte che espone la sessione live TikTok in corso.
user_idObbligatorioIdentificatore 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à.

  1. 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.
  2. Invia con POST entrambi gli identificatori come stringhe non vuote a /v1/tiktok/live-room-info.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded o failed.
  4. 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.

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.

Esplora altre piattaforme

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

TikTok Live Room Info API — FAQ

TikTok Live Room Info API è un’interfaccia programmatica per recuperare una diretta pubblica nota tramite il suo room_id e lo user_id del proprietario. Restituisce titolo e stato della diretta, identità del proprietario, immagine di copertina, numero di spettatori e di Mi piace e momento di raccolta come istantanea puntuale.

Usa una fonte di sessioni live che espone room_id e tienilo abbinato allo user_id numerico del proprietario della diretta. Un risultato di TikTok Profiles può fornire user_id nel suo campo normalizzato id, ma il catalogo TikTok attuale di SocQ non individua room_id.

La diretta può essere terminata, essere diventata non disponibile o non corrispondere più al proprietario inviato, oppure uno dei due identificatori può non essere valido. SocQ salva un risultato solo quando la fonte risolve un room_id non vuoto.

No. Esegue una sola ricerca per una diretta che conosci già e non cerca le dirette di tendenza, non attende che un account vada in diretta, non registra video, non raccoglie eventi live né crea un monitoraggio continuo.

Sono valori puntuali esposti nel momento in cui la richiesta viene raccolta e possono cambiare subito. Salva collected_at insieme ai conteggi invece di trattarli come un feed continuo.

Ogni record normalizzato di diretta salvato costa 0,5 crediti, senza costo base per l’attività. La stima presuppone un risultato, mentre un risultato vuoto non comporta alcun addebito.