YouTube Channel Videos
I video di un canale YouTube sono i caricamenti regolari di un canale specifico, con titoli, descrizioni, miniature, durata, dettagli di pubblicazione ed engagement visibile. Questi record supportano la catalogazione dei canali, l’analisi delle pubblicazioni, il monitoraggio dei contenuti e la reportistica storica.
Funzionalità della YouTube Channel Videos API
- Raccolta di video da più canaliRaccogli i video pubblici regolari da più URL di canali in una sola richiesta.
- Limiti dei risultati per canaleImposta un results_limit separato per ogni canale in input, con 100 come valore predefinito.
- Metadati dei video normalizzatiRestituisce identità del video normalizzata, metadati dei contenuti, miniature, durata, data di pubblicazione e canale che pubblica.
- Metriche di engagement riferite a un momento precisoInclude il numero pubblico di visualizzazioni, Mi piace e commenti con collected_at per confronti successivi.
- Ambito dei video regolariEsclude gli Shorts e le dirette, per mantenere il risultato concentrato sui video regolari dei canali.
Parametri della YouTube Channel Videos API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL di canali YouTube pubblici, separati da virgole o da a capo. |
results_limit | Facoltativo | Numero massimo di record idonei da richiedere per ogni URL in input. Deve essere un intero positivo e ha 100 come valore predefinito. |
Come usare la YouTube Channel Videos API
Scegli quanto in profondità esaminare ogni canale, poi raccogli un inventario pulito dei video regolari. Un batch può contenere più canali, ma il limite richiesto viene applicato a ciascuno.
- Prepara gli URL dei canali pubblici e decidi se ti serve un campione recente o un recupero più profondo dello storico.
- Invia con POST urls e results_limit a /v1/youtube/channel-videos; ricorda che il limite si applica per canale.
- Interroga /v1/tasks/{task_id} finché l’attività di inventario raggiunge succeeded o failed.
- Raggruppa gli elementi restituiti per ID del canale, deduplica per ID del video e scorri le pagine finché has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/channel-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Casi d’uso della YouTube Channel Videos API
- Feed dei contenuti dei canali: Costruisci un feed strutturato dei video pubblici regolari dei canali selezionati.
- Analisi di pubblicazione e prestazioni: Confronta frequenza di pubblicazione, durata, argomenti ed engagement pubblico tra i canali.
- Monitoraggio di creator e concorrenti: Tieni traccia dell’attività dei video regolari di creator, editori, brand o concorrenti.
- Creazione di un catalogo di video: Alimenta flussi di lavoro di classificazione, riassunto, ricerca o reportistica senza raccogliere a mano l’URL di ogni video.
Consigli degli esperti per la YouTube Channel Videos API
- Il limite si moltiplica sugli input. Dieci canali con results_limit 100 richiedono fino a 1.000 record di video regolari.
- Parti con una profondità ridotta quando inserisci un nuovo gruppo di canali, controlla l’idoneità e alza il limite solo dove serve uno storico più profondo.
- Meno risultati possono significare che il canale ha meno caricamenti pubblici idonei. Non indica automaticamente un’attività fallita.
- Non presentare la risposta come un archivio completo garantito; la disponibilità e l’inventario pubblico del canale possono cambiare.
- Usa l’ID del video per la deduplicazione e conserva sia l’ID del canale di origine sia collected_at per l’analisi longitudinale.
- Esegui gli Shorts separatamente se conta il mix di formati. Combinare i due solo dopo la raccolta mantiene esplicita la classificazione.
- Usa Channels per i campi attuali del profilo invece di copiare bio e contatori del canale in ogni riga di caricamento.
API correlate
Oltre alla YouTube Channel Videos API, usa queste API quando ti serve un altro tipo di dati pubblici di YouTube.
- 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 Channel Live Videos API — Raccoglie i record pubblici delle trasmissioni presenti nelle sezioni live dei canali, con contesto della fonte e metriche visibili.
- 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