youtube/
channels

Recupera i profili pubblici dei canali YouTube a partire dagli URL dei canali, con identità normalizzata, descrizioni, immagini, verifica e statistiche visibili del pubblico.

YouTube Channels API

Canali
Profili pubblici
Metriche visibili
0,26 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 Channels

I canali YouTube sono pagine pubbliche di creator, brand od organizzazioni con identità, descrizioni, immagini, verifica, link del profilo e totali visibili di iscritti, video e visualizzazioni. Questi segnali dei canali supportano la ricerca sui creator, il confronto dei pubblici, l’arricchimento di directory e l’analisi di mercato.

Funzionalità della YouTube Channels API

  • Raccolta di profili da più canaliRaccogli i profili pubblici di più URL di canali in una sola richiesta.
  • Identità del canale normalizzataRestituisce ID del canale, handle, nome visualizzato, URL canonico, descrizione, avatar e banner in una struttura coerente.
  • Metriche pubbliche del canaleInclude lo stato di verifica, il numero pubblico di iscritti, il numero di video pubblicati e le visualizzazioni totali del canale.
  • Campi di contesto del profiloConserva la località pubblica, i link del profilo, la data di creazione del canale e l’URL del canale inviato.
  • Timestamp di raccoltaAggiunge collected_at a ogni risultato, così i record salvati possono essere confrontati tra date di raccolta diverse.

Parametri della YouTube Channels API

ParametriObbligatorioDescrizione
urlsObbligatorioURL di canali YouTube pubblici, separati da virgole o da a capo.

Come usare la YouTube Channels API

Trasforma un elenco di pagine di canali pubblici in record di identità duraturi. La richiesta è asincrona, quindi conserva l’ID attività finché ogni canale inviato non è stato risolto.

  1. Costruisci un elenco deduplicato di URL di canali pubblici o @handle, non URL di visione dei video.
  2. Invia con POST l’array urls a /v1/youtube/channels e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id}; queued e running sono normali stati intermedi.
  4. Quando l’attività ha successo, indicizza data.results.items per id e continua con next_cursor se has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"]}'

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

Casi d’uso della YouTube Channels API

  • Directory di creator e brand: Arricchisci una directory con ID dei canali stabili, dettagli del profilo, immagini, link e metriche pubbliche del pubblico.
  • Qualificazione dei creator: Esamina descrizioni dei canali, verifica, dimensione del pubblico, attività di pubblicazione e link del profilo quando valuti potenziali partner.
  • Confronto tra canali: Confronta il numero pubblico di iscritti, video e visualizzazioni tra creator, brand, testate o concorrenti.
  • Monitoraggio dei profili: Raccogli gli stessi canali nel tempo per seguire i cambiamenti nei dettagli pubblici del profilo e nelle statistiche del pubblico.

Consigli degli esperti per la YouTube Channels API

  • Salva id come chiave primaria. Un handle è utile per la visualizzazione e il routing, ma può cambiare senza creare un nuovo canale.
  • Non convertire in 0 un numero di iscritti nascosto. Null significa che il valore non era disponibile pubblicamente, e questo è un segnale di business diverso.
  • Tratta i link delle descrizioni come URL esterni non attendibili. Convalidali e ripuliscili prima di mostrarli in uno strumento interno.
  • Confronta i contatori del pubblico solo quando collected_at è presente e usa una cadenza di raccolta coerente per i calcoli delle tendenze.
  • Un batch riuscito può comunque contenere meno record degli URL se un canale è stato eliminato, è limitato o non è più pubblico.
  • Collega Channels a Channel Videos o Shorts tramite l’ID del canale, invece di ripetere i campi del profilo su ogni riga di contenuto.

Oltre alla YouTube Channels 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 Shorts API — Raccoglie Shorts pubblici, miniature, durata, dettagli di pubblicazione ed engagement per canale.
  • YouTube Community Posts API — Raccoglie i post pubblici della scheda Community dagli URL dei canali, inclusi testo, identità del canale, date, riferimenti alle immagini e contesto della fonte.
  • YouTube Email Finder API — Trova le email business pubbliche a partire dall’URL di un canale, con le pagine in cui compare ogni indirizzo.

Esplora altre piattaforme

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

YouTube Channels API — FAQ

YouTube Channels API recupera i dati di profilo visibili pubblicamente da uno o più URL di canali YouTube. Restituisce identità normalizzata, descrizioni, immagini, verifica, statistiche del pubblico, località, link del profilo e momento della raccolta.

Invia uno o più URL di canali YouTube pubblici nell’array urls. Ogni canale accessibile viene restituito come risultato normalizzato separato.

Sì. Aggiungi più URL di canali pubblici allo stesso array urls per raccogliere insieme i loro record di profilo.

Un canale può nascondere il proprio numero di iscritti e i campi facoltativi del profilo pubblico non sono presenti su ogni canale. I valori pubblici mancanti restano vuoti e non vengono riportati come zero.

No. Questo endpoint restituisce i dati del profilo del canale e le statistiche aggregate. Usa Channel Videos per i caricamenti regolari e Shorts per gli Shorts dei canali.

L’utilizzo costa 0,26 crediti per ogni risultato di canale normalizzato restituito.