youtube/
channel-videos

Raccogli i video pubblici regolari dagli URL dei canali YouTube, con titoli normalizzati, miniature, durata, dettagli di pubblicazione, contesto del canale e metriche di engagement.

YouTube Channel Videos API

Video dei canali
Caricamenti regolari
Metriche pubbliche
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 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

ParametriObbligatorioDescrizione
urlsObbligatorioURL di canali YouTube pubblici, separati da virgole o da a capo.
results_limitFacoltativoNumero 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.

  1. Prepara gli URL dei canali pubblici e decidi se ti serve un campione recente o un recupero più profondo dello storico.
  2. Invia con POST urls e results_limit a /v1/youtube/channel-videos; ricorda che il limite si applica per canale.
  3. Interroga /v1/tasks/{task_id} finché l’attività di inventario raggiunge succeeded o failed.
  4. 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=50

Casi 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.

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.

Esplora altre piattaforme

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

YouTube Channel Videos API — FAQ

YouTube Channel Videos API raccoglie i video pubblici regolari da uno o più URL di canali YouTube. Restituisce titoli, descrizioni, informazioni sul canale, miniature, durata, date di pubblicazione, metriche di engagement e momento della raccolta, tutti normalizzati.

Invia uno o più URL di canali YouTube pubblici e un results_limit facoltativo.

results_limit ha 100 come valore predefinito e si applica separatamente a ogni URL di canale. Il numero finale può essere inferiore quando un canale ha meno video regolari pubblici idonei.

No. Questo endpoint restituisce i video regolari dei canali. Usa Shorts per gli Shorts dei canali.

No. Visualizzazioni, Mi piace e commenti sono valori pubblici osservati nel momento della raccolta. Per costruire confronti storici servono raccolte ripetute.

L’utilizzo costa 0,5 crediti per ogni risultato di video normalizzato restituito.