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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL 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.
- Costruisci un elenco deduplicato di URL di canali pubblici o @handle, non URL di visione dei video.
- Invia con POST l’array urls a /v1/youtube/channels e salva il task_id restituito.
- Interroga /v1/tasks/{task_id}; queued e running sono normali stati intermedi.
- 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=50Casi 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.
API correlate
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.
- YouTube Videos API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies 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 Trending Videos API