douyin/
live-room-detail

Recupera una diretta pubblica di Douyin da un room_id numerico noto, con titolo, stato, identità del conduttore, media, conteggi visibili di spettatori e Mi piace e orario di raccolta.

Douyin Live Room Detail API

Ricerca di una diretta nota
Contesto del conduttore
Istantanea del pubblico
0,1 crediti per richiesta
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

Douyin Live Room Detail

Le dirette di Douyin sono sessioni di trasmissione pubbliche con titolo, stato attuale, identità del conduttore, media e conteggi visibili di spettatori e Mi piace. Questi campi supportano l’arricchimento del catalogo delle dirette, il monitoraggio dello stato delle sessioni e il confronto in un preciso momento.

Funzionalità della Douyin Live Room Detail API

  • Ricerca dei dettagli di una diretta notaTrasforma un room_id numerico noto in al massimo un record live_room normalizzato con una sola richiesta alla fonte, senza paginazione della fonte.
  • Contesto della diretta e del conduttoreMantiene insieme, in un’unica struttura coerente, titolo, stato, identità del conduttore, URL di origine e orario di raccolta disponibili.
  • Istantanea visibile della sessioneAcquisisce i conteggi disponibili di spettatori e Mi piace insieme ai media pubblici, per una vista della diretta con data e ora.

Parametri della Douyin Live Room Detail API

ParametriObbligatorioDescrizione
room_idObbligatorioIdentificatore obbligatorio di una diretta di Douyin, composto da sole cifre. Invialo come stringa, così gli identificatori lunghi non vengono arrotondati da un client.

Come usare la Douyin Live Room Detail API

Parti da un ID numerico noto di una diretta, invia l’attività asincrona di dettaglio e leggi il relativo risultato normalizzato salvato.

  1. Ricava room_id da un contesto di diretta che espone l’identificatore numerico; questo endpoint non individua gli ID delle dirette.
  2. Invia con POST l’identificatore come stringa non vuota di sole cifre a /v1/douyin/live-room-detail.
  3. Interroga /v1/tasks/{task_id} finché status diventa succeeded o failed.
  4. Leggi data.results.items da /v1/tasks/{task_id}?limit=50; una diretta risolta produce al massimo un elemento, mentre next_cursor riguarda solo la paginazione dei risultati salvati da SocQ.
# Set DOUYIN_ROOM_ID to a known numeric room_id before sending.
curl -X POST "https://api.socq.ai/v1/douyin/live-room-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"room_id\":\"${DOUYIN_ROOM_ID}\"}"

# Poll GET /v1/tasks/{task_id}, then read data.results.items from /v1/tasks/{task_id}?limit=50.

Casi d’uso della Douyin Live Room Detail API

  • Arricchimento del catalogo delle dirette: Aggiungi titolo, stato, conduttore, media, metriche visibili e orario di raccolta disponibili a un catalogo che conserva già l’ID della diretta.
  • Monitoraggio delle istantanee dello stato della sessione: Conserva i record raccolti separatamente con collected_at per distinguere le osservazioni dello stato della diretta e del pubblico in momenti diversi.
  • Verifica del contesto conduttore e diretta: Esamina l’identità disponibile del conduttore accanto a titolo, stato, media e conteggi visibili della sessione in un unico record normalizzato.

Consigli degli esperti per la Douyin Live Room Detail API

  • Invia room_id come stringa tra virgolette di sole cifre, non come numero JavaScript, così un identificatore lungo mantiene tutte le cifre.
  • Ottieni un room_id noto prima di chiamare l’endpoint, perché la richiesta recupera dettagli e non individua dirette.
  • Conserva il room_id inviato nel tuo record; il risultato canonico della diretta non garantisce che la fonte lo restituisca come id.
  • Tratta titolo, stato, autore, metriche, media, URL e timestamp come nullable, perché la fonte può omettere singoli campi pubblici.
  • Non inviare results_limit né un cursore di origine; next_cursor, quando presente, pagina gli elementi di risultato salvati da SocQ e non la richiesta al provider.

Oltre alla Douyin Live Room Detail API, usa queste API quando ti serve un altro tipo di dati pubblici di Douyin.

Esplora altre piattaforme

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

Douyin Live Room Detail API — FAQ

Douyin Live Room Detail API recupera una diretta pubblica nota a partire dal suo room_id numerico. Restituisce i campi disponibili di diretta, conduttore, media, pubblico e orario di raccolta come record normalizzato in un preciso momento.

Usa un contesto di diretta pubblica che espone l’identificatore numerico della diretta e conservalo nel tuo record. Questo endpoint non cerca dirette e non individua gli ID delle dirette.

Il validatore del runtime richiede una stringa che rispetti il formato dell’ID della diretta composto da sole cifre. Mantenere il valore come testo evita inoltre che gli ID lunghi vengano arrotondati dai client numerici.

Il record normalizzato può includere titolo, stato, autore, URL, media, viewers_count e likes_count visibili, created_at e collected_at. Qualsiasi campo facoltativo della fonte può essere null o assente.

No. Esegue una sola richiesta di dettaglio e produce al massimo un record normalizzato; il next_cursor dei risultati dell’attività è soltanto il cursore standard per gli elementi già salvati da SocQ.

Un’attività riuscita ha un costo fisso di 0,10 crediti SocQ. L’addebito non cambia con il numero di risultati o con le impostazioni di paginazione.