Torna alle API
Dati pubblici di YouTube

YouTube Public Data API

Raccogli profili dei canali YouTube pubblici supportati, dettagli dei video, video dei canali, commenti, Shorts, risultati per parola chiave e hashtag e trascrizioni disponibili con un unico flusso di lavoro asincrono normalizzato.

API di YouTube disponibili

Scegli la ricerca diretta di canali o video, la raccolta di video e Shorts basata sui canali, i commenti pubblici, la scoperta per parola chiave o hashtag oppure il testo delle trascrizioni disponibili.

Quali dati di YouTube puoi recuperare?

SocQ trasforma i risultati pubblici supportati di YouTube in record normalizzati per arricchimento, monitoraggio, ricerca, analisi dei contenuti e reportistica.

Profili dei canali

Recupera identità del canale, descrizioni, immagini pubbliche, verifica e conteggi visibili di iscritti, video e visualizzazioni totali.

Metadati di video e Shorts

Raccogli titoli, descrizioni, contesto del canale, miniature, durata, dati di pubblicazione ed engagement visibile.

Discussione pubblica

Raccogli il testo dei commenti visibili pubblicamente, il contesto dell’autore, i Mi piace, il numero di risposte, i riferimenti ai video e le relazioni con i commenti padre.

Scoperta e trascrizioni

Cerca per parola chiave i video normali pubblici, raccogli i video associati ai feed di hashtag e recupera il testo semplice dei sottotitoli disponibili per URL noti.

SocQ vs YouTube Data API

SocQ si concentra sulla raccolta di dati pubblici supportati e su risultati normalizzati. YouTube Data API è la scelta adatta per OAuth ufficiale, gestione dei canali e operazioni autorizzate.

FunzionalitàSocQYouTube Data API
Uso principaleRaccolta e normalizzazione dei dati pubblici supportatiIntegrazione ufficiale con la piattaforma e risorse autorizzate
AutenticazioneChiave API di SocQOAuth di Google o credenziali API, a seconda dell’operazione
Gestione dei contenutiNon crea, modifica, elimina, non mette Mi piace, non commenta e non gestisce contenuti di YouTubeSupporta le operazioni autorizzate idonee
Dati privati o riservatiNon supportatiLimitati ai dati consentiti dall’autorizzazione concessa e dalla policy della piattaforma
Formato della rispostaRecord normalizzati di SocQRisorse native dell’API di YouTube

Come funziona l’API di YouTube

Tutti e otto gli endpoint condividono un ciclo di vita asincrono di invio, interrogazione e paginazione a cursore.

  1. 1. Invia input pubblici

    Invia con POST URL di canali supportati, URL di video, una query per parola chiave, hashtag e filtri facoltativi specifici dell’endpoint.

  2. 2. Interroga l’attività

    Usa l’ID attività restituito finché l’elaborazione non riesce o non fallisce, applicando un backoff dopo le risposte di pressione temporanea.

  3. 3. Leggi e pagina

    Leggi i record normalizzati da data.results.items e segui next_cursor finché has_more è true.

Inizia con una sola richiesta API

Autenticati con una chiave API di SocQ. Questa richiesta recupera il profilo di un canale pubblico; scegli un altro endpoint per video, commenti, Shorts, scoperta per parola chiave o hashtag oppure trascrizioni.

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 comuni dell’API di YouTube

Ricerca su creator e canali

Combina profili dei canali pubblici, video normali e Shorts per arricchire le directory e per analisi comparative.

Monitoraggio di contenuti e reazioni

Segui i metadati di video selezionati, le discussioni nei commenti pubblici e le istantanee dell’engagement al momento della raccolta.

Scoperta di argomenti

Cerca video pubblici per parola chiave o feed di hashtag, poi arricchisci gli URL selezionati o recupera il testo delle trascrizioni disponibili.

Pipeline di dati

Invia i record normalizzati a data warehouse, strumenti di revisione, classificatori, indici di ricerca e sistemi di reportistica.

Limiti e policy sui dati pubblici

I risultati pubblici di YouTube sono dinamici e dipendono da visibilità attuale, classificazione, disponibilità per area geografica e accesso pubblico a sottotitoli o commenti.

  • I contenuti privati, eliminati, riservati ai membri, limitati per area geografica o per età e comunque non accessibili possono non produrre record.
  • Contatori visibili, classifiche di ricerca, classificazioni, commenti e sottotitoli possono cambiare dopo la raccolta.
  • Un limite di risultati richiesto non garantisce che esistano tanti record pubblici idonei.
  • SocQ non è un’API ufficiale di YouTube e non gestisce, crea, modifica, elimina, non mette Mi piace né commenta contenuti di YouTube.

Domande frequenti sull’API di YouTube

SocQ è l’API ufficiale di YouTube?

No. SocQ raccoglie e normalizza i risultati pubblici supportati. Usa YouTube Data API per OAuth ufficiale, gestione dei canali e operazioni autorizzate.

Gli utenti devono collegare i propri account YouTube?

No, per questi endpoint di dati pubblici supportati non serve alcun OAuth YouTube del cliente. Le richieste si autenticano con una chiave API di SocQ.

Quali risorse di YouTube sono disponibili?

Sono disponibili Channels, Videos, Channel Videos, Comments, Shorts, Search, Hashtag Search e Transcripts, ciascuno con un proprio input documentato e una specifica del risultato normalizzato.

Come si calcola il costo di utilizzo?

La scheda di ogni endpoint mostra il prezzo attuale in crediti per risultato, e il Playground stima la richiesta inviata in base alle regole di fatturazione dell’endpoint.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.