youtube/
channel-live-videos

Raccogli le dirette pubbliche dalle sezioni live dei canali YouTube, con metadati dei video normalizzati, contesto del canale, miniature, dettagli di pubblicazione ed engagement visibile.

YouTube Channel Live Videos API

Sezione live del canale
Dirette pubbliche
Raccolta asincrona
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

YouTube Channel Live Videos

I video live di un canale YouTube sono voci di dirette pubbliche esposte nella sezione live di un canale specifico, con identità del video, contesto del canale, miniature, timestamp ed engagement visibile. A seconda di ciò che YouTube espone per quel canale, la raccolta può contenere dirette in corso, programmate o archiviate, senza garantire un’etichetta normalizzata dello stato live.

Funzionalità della YouTube Channel Live Videos API

  • Supporto degli URL canonici dei canaliRisolve gli URL pubblici di YouTube nei formati /@handle, /channel/{id}, /c/{name} e /user/{name}.
  • Scoperta dalla sezione live del canaleRaccoglie le voci di dirette rese disponibili nella sezione live di ogni canale inviato.
  • Profondità di raccolta per canaleRichiedi da 20 a 2.000 record per ogni canale in input, con 100 come valore predefinito.
  • Record delle dirette normalizzatiRestituisce identità del video, titolo, descrizione, canale, miniatura, durata, hashtag, ora di pubblicazione e contesto di origine, quando disponibili.
  • Istantanee dell’engagement visibileRileva il numero pubblico di visualizzazioni, Mi piace e commenti insieme a collected_at per analisi riferite a un momento preciso.
  • Consegna asincrona dei risultatiInterroga lo stato dell’attività, conserva l’ID attività e usa la paginazione a cursore per una consegna asincrona affidabile dei risultati.

Parametri della YouTube Channel Live Videos API

ParametriObbligatorioDescrizione
urlsObbligatorioURL di canali YouTube pubblici separati da virgole o da a capo. I percorsi supportati sono /@handle, /channel/{id}, /c/{name} e /user/{name}.
results_limitFacoltativoNumero massimo di record richiesti per ogni URL di canale. Deve essere un intero da 20 a 2.000 e ha 100 come valore predefinito.

Come usare la YouTube Channel Live Videos API

Invia gli URL canonici dei canali pubblici e scegli una profondità di raccolta per ciascuno. La richiesta crea un’attività asincrona, quindi il completamento e il recupero dei risultati sono passaggi separati.

  1. Prepara uno o più URL di canali YouTube pubblici con un percorso supportato: handle, ID del canale, nome personalizzato o utente.
  2. Invia con POST urls e results_limit a /v1/youtube/channel-live-videos e conserva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
  4. Leggi le pagine dei risultati da /v1/tasks/{task_id}?limit=50 e ripassa next_cursor come cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/channel-live-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@YouTube"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50&cursor={next_cursor}

Casi d’uso della YouTube Channel Live Videos API

  • Creazione di un inventario delle dirette: Crea un elenco strutturato delle dirette pubbliche associate ai canali selezionati.
  • Ricerca sulla programmazione delle dirette: Confronta titoli, orari, durata e schemi di pubblicazione tra canali con una programmazione live ricorrente.
  • Monitoraggio delle dirette dei creator: Tieni traccia di quali record di dirette pubbliche sono visibili nelle sezioni dei canali di creator, brand, editori o concorrenti.
  • Istantanee delle prestazioni dopo la diretta: Salva visualizzazioni, Mi piace e commenti visibili con il momento della raccolta per confronti successivi sulle tendenze.
  • Arricchimento di un catalogo multimediale pubblico: Aggiungi metadati normalizzati delle dirette e contesto del canale di origine a sistemi di ricerca, reportistica o classificazione.

Consigli degli esperti per la YouTube Channel Live Videos API

  • results_limit si applica a ogni canale. Cinque URL con un limite di 100 richiedono fino a 500 record prima della deduplicazione su tutta l’attività.
  • Usa URL canonici di canali con un handle, un ID del canale, un nome personalizzato o un nome utente non vuoti; un percorso /channel senza altro non permette di risolvere un’origine.
  • Considera la sezione live del canale come il confine di idoneità. La disponibilità di dirette in corso, programmate e archiviate può cambiare tra una raccolta e l’altra.
  • Non dedurre uno stato affidabile di in corso, programmata o archiviata da type o da extra.content_type; il payload normalizzato non ha un campo dedicato allo stato live.
  • La risposta contiene metadati e riferimenti alle miniature, non la chat dal vivo, l’URL di uno stream riproducibile, i sottotitoli o il testo della trascrizione.
  • Input di canale equivalenti possono scoprire lo stesso video. I risultati salvati dell’attività vengono deduplicati per ID video normalizzato e, in assenza di ID, per URL.
  • Il limite dei risultati dell’attività è separato da results_limit: richiedi da 1 a 500 righe salvate per pagina e riutilizza l’opaco next_cursor finché has_more è false.
  • I metadati pubblici non sbloccano la visione di contenuti privati o riservati ai membri. Conserva extra.is_members_only quando la fonte riporta questa classificazione.

Oltre alla YouTube Channel Live Videos API, usa queste API quando ti serve un altro tipo di dati pubblici di YouTube.

  • YouTube Channel Videos API — Raccoglie i video pubblici regolari dagli URL dei canali, esclusi Shorts e dirette.
  • YouTube Comments API — Raccoglie commenti pubblici, autori, engagement, video di origine e contesto della conversazione.
  • YouTube Transcripts API — Recupera le trascrizioni disponibili in testo semplice con scelta facoltativa della lingua.
  • YouTube Channels API — Recupera identità del canale pubblico, immagini, verifica e statistiche visibili del pubblico.
  • YouTube Videos API — Recupera metadati, miniature, durata ed engagement a partire dagli URL di video o Short noti.
  • YouTube Shorts API — Raccoglie Shorts pubblici, miniature, durata, dettagli di pubblicazione ed engagement per canale.

Esplora altre piattaforme

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

YouTube Channel Live Videos API — FAQ

YouTube Channel Live Videos API raccoglie record normalizzati di dirette pubbliche esposte nelle sezioni live di uno o più canali YouTube. Restituisce identità di video e canale, metadati descrittivi, miniature, timestamp, engagement visibile, contesto dell’input e momento della raccolta, quando disponibili.

Usa un URL pubblico di youtube.com con /@handle, /channel/{id}, /c/{name} o /user/{name}. Il segmento dell’identificatore non deve essere vuoto.

No. La sezione idonea del canale può esporre dirette in corso, programmate o archiviate, e la disponibilità può variare in base al canale e al momento della raccolta.

No. extra.content_type può conservare una classificazione di origine quando presente, ma non sostituisce in modo affidabile uno stato dedicato di in corso, programmata o archiviata.

results_limit ha 100 come valore predefinito, accetta da 20 a 2.000 e si applica separatamente a ogni URL di canale inviato. Le righe effettivamente salvate possono essere meno per la disponibilità del canale e la deduplicazione dei video su tutta l’attività.

No. L’endpoint restituisce i metadati delle dirette pubbliche e i riferimenti alle miniature; non restituisce i messaggi della chat dal vivo, i file dello stream riproducibili, i sottotitoli o le trascrizioni.

La richiesta viene stimata in base al numero di URL di canale moltiplicato per results_limit, poi riconciliata a 0,5 crediti per ogni risultato normalizzato salvato. Un risultato vuoto non ha alcun addebito per i risultati perché il costo base configurato è zero.