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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL di canali YouTube pubblici separati da virgole o da a capo. I percorsi supportati sono /@handle, /channel/{id}, /c/{name} e /user/{name}. |
results_limit | Facoltativo | Numero 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.
- Prepara uno o più URL di canali YouTube pubblici con un percorso supportato: handle, ID del canale, nome personalizzato o utente.
- Invia con POST urls e results_limit a /v1/youtube/channel-live-videos e conserva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
- 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.
API correlate
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.
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API