Video · YouTube
API dati video YouTube
API dati video YouTube: ricevi dati YouTube live nel momento in cui li chiedi, in forma pulita e strutturata – pronti per la tua app, un foglio di calcolo o un assistente AI. Niente scraping, niente da mantenere.
100 richieste gratuite ogni mese · nessuna carta di credito · una chiave API per tutte le piattaforme
Dati chiave
Aggiornato il
Ogni pagina di visualizzazione di YouTube contiene un ricco blocco di metadati pubblici: titolo e descrizione, il canale che ha pubblicato il video, i totali di visualizzazioni, like e commenti, data di pubblicazione, durata, categoria, tag, miniature e le tracce di sottotitoli disponibili. L'API dati video YouTube di everydata.io restituisce quel blocco come un unico oggetto JSON per qualsiasi ID o URL di video. Nessuna schermata di consenso OAuth, nessun progetto Google Cloud e nessuna quota giornaliera di unità da razionare: solo una GET HTTPS con la tua chiave everydata.io, con la risposta presa dalla pagina live.
- Piattaforma
- YouTube
- Endpoint principale
- /youtube-video-details
- Quota per chiamata
- 1 richiesta
- Piano gratuito
- 100 rich. / mesepoi da 30 € / mese
Dati YouTube pronti all'uso
GET /ytb/youtube-video-details accetta id come semplice ID video (kJQP7kiw5Fk), come short link youtu.be o come URL completo di visualizzazione, così puoi passargli qualunque cosa incollino i tuoi utenti. La risposta contiene videoId, title, description, channelId, channelName, channelUrl e subscriberCountText di chi ha caricato il video, poi i dati di engagement come interi: viewCount, likeCount e commentCount, con likeCountText per il valore arrotondato mostrato. publishedAt e uploadDate sono timestamp ISO con offset, duration è in secondi con durationText nel formato m:ss, e category, keywords e tags riportano la classificazione scelta da chi ha caricato il video.
Alcuni flag booleani descrivono lo stato del video: isLive, isLiveNow, isFamilySafe, isUnlisted, isPrivate, isShortsEligible e allowRatings. availableCountries elenca i paesi in cui la riproduzione è consentita, embedUrl è pronto per un iframe e captions[] contiene ogni traccia di sottotitoli con languageCode, name e isTranslatable.
- ID video, link youtu.be o URL completo di visualizzazione accettati nello stesso parametro id
- viewCount, likeCount, commentCount come semplici interi più le varianti leggibili *Text
- publishedAt, uploadDate, duration, durationText, category, keywords[] e tags[]
- Contesto del canale incluso: channelId, channelName, channelUrl, channelThumbnails, subscriberCountText
- Flag di stato: isLive, isLiveNow, isFamilySafe, isUnlisted, isPrivate, isShortsEligible, allowRatings
- thumbnails[] in più dimensioni, embedUrl, availableCountries[] e captions[] con lingua e traducibilità
- Endpoint complementari per ricerca per parola chiave, video correlati e tendenze: tutti con paginazione a cursore, senza chiave API Google
Cosa costruiscono i team
Report su influencer e campagne
Recupera periodicamente viewCount, likeCount e commentCount dei video sponsorizzati e traccia la curva dalla data di pubblicazione in poi, senza un budget di unità da dividere tra i clienti.
Monitoraggio dei contenuti e brand safety
Risolvi ogni URL inviato da un utente, salva title, channelName, category e isFamilySafe e segnala i video che in seguito diventano privati o non in elenco tramite la risposta 404.
Monitoraggio di ricerche e tendenze
Esegui ogni giorno la stessa parola chiave su youtube-search-videos con diversi valori di countryCode e misura quali canali e formati dominano i risultati in ogni mercato.
Anteprime di link ed embed
Trasforma un link YouTube incollato in una scheda con miniatura, titolo, canale e durata, e incorporalo con embedUrl: il classico caso d'uso oEmbed senza credenziali Google.
Richiesta e risposta di esempio
Una sola chiamata restituisce l'intero blocco della pagina di visualizzazione; l'esempio usa Despacito, quindi i contatori sono reali e grandi. Per la scoperta di contenuti, GET /ytb/youtube-search-videos?query=lofi+hip+hop restituisce items[] con videoId, title, channelName, viewCount, duration e isLive più un cursor; /ytb/youtube-video-related-contents elenca i video consigliati nella barra laterale e /ytb/youtube-trending-videos restituisce la scheda Tendenze.
GET /ytb/youtube-video-details
curl "https://api.everydata.io/ytb/youtube-video-details?id=kJQP7kiw5Fk&languageCode=en&countryCode=US" \
-H "x-api-key: YOUR_API_KEY"Risposta (abbreviata)
{
"responseStatus": "PAGE_FOUND",
"responseMessage": "Page successfully found!",
"videoId": "kJQP7kiw5Fk",
"title": "Luis Fonsi - Despacito ft. Daddy Yankee",
"channelId": "UCLp8RBhQHu9wSsq62j_Md6A",
"channelName": "LuisFonsiVEVO",
"subscriberCountText": "32.5M subscribers",
"viewCount": 9125159593,
"likeCount": 56673581,
"likeCountText": "56M",
"commentCount": 4300000,
"publishedAt": "2017-01-12T21:00:02-08:00",
"duration": 282,
"durationText": "4:42",
"category": "Music",
"keywords": [
"Luis",
"Fonsi"
],
"tags": [
"Calypso",
"Despacito"
],
"thumbnails": [
{
"url": "https://i.ytimg.com/vi/kJQP7kiw5Fk/hqdefault.jpg",
"width": 168,
"height": 94
}
],
"isLive": false,
"isFamilySafe": true,
"embedUrl": "https://www.youtube.com/embed/kJQP7kiw5Fk"
}responseStatus è PAGE_FOUND quando la pagina di visualizzazione è stata generata. Un video privato, eliminato o bloccato nella regione produce un 404 con un body vnd.error invece di un oggetto compilato a metà, quindi controlla lo stato HTTP prima del parsing. viewCount è il valore esatto presente sulla pagina al momento della richiesta; YouTube stesso lo aggiorna con un leggero ritardo, quindi due chiamate a pochi minuti di distanza possono restituire lo stesso numero per i video che crescono lentamente.
Le risposte di ricerca e dei contenuti correlati sono paginate con una stringa cursor opaca. Passa il valore cursor di una risposta come parametro cursor della chiamata successiva per proseguire; omettilo per la prima pagina. Ogni pagina è una richiesta. estimatedResults nella ricerca è la stima approssimativa di YouTube stesso, non una garanzia di quante pagine puoi scorrere.
languageCode e countryCode (predefiniti en, US) influenzano ciò che YouTube mostra: titoli localizzati quando chi ha caricato il video ha fornito traduzioni, e l'elenco delle tendenze del paese. Ogni richiesta è in tempo reale; sugli endpoint YouTube non c'è cacheTtl perché i contatori cambiano di continuo.
Endpoint correlati
Dettagli video. Metadati per un ID o URL di video.
Cerca video. Ricerca per parola chiave con paginazione a cursore.
Video correlati. Contenuti correlati a un video.
Tendenze. Video di tendenza.
Paghi a richiesta, tutte le piattaforme incluse
Una chiamata ai dettagli di un video, una pagina di ricerca o una pagina di contenuti correlati equivalgono a una richiesta. Poiché non c'è una quota Google separata, l'unico limite è il tuo piano everydata.io: le 100 richieste al mese del livello gratuito bastano per un test di integrazione; Starter (5.000 richieste, 30 €) monitora circa 160 video al giorno; Production (50.000, 80 €) supporta report su scala di agenzia per centinaia di canali. Gli errori 5xx upstream non vengono mai scalati dalla quota.
- Free
- 100 rich. / mese
- Starter
- 5000 rich. · 30 €
- Production
- 50.000 rich. · 80 €
- Business
- 300.000 rich. · 300 €
API dati video YouTube: domande frequenti
Mi serve una chiave API Google o un token OAuth?
No. Le richieste si autenticano solo con la tua chiave everydata.io. I dati provengono dalle pagine pubbliche di visualizzazione, ricerca e canale di YouTube, quindi non sono coinvolti progetti Google Cloud, flussi di consenso o la quota giornaliera di 10.000 unità.
Quali formati di id sono accettati?
L'ID video di 11 caratteri, uno short link youtu.be, un URL completo www.youtube.com/watch?v= e gli URL degli Shorts. Lo stesso parametro id li gestisce tutti; la risposta contiene sempre il videoId normalizzato.
Posso ottenere il numero di dislike o le statistiche sul tempo di visualizzazione?
No. YouTube ha rimosso i dislike pubblici nel 2021 e il tempo di visualizzazione è visibile solo al proprietario del canale in YouTube Studio. L'API restituisce i contatori pubblici: viewCount, likeCount e commentCount.
Come scorro le pagine dei risultati di ricerca?
Ogni risposta di ricerca include una stringa cursor. Rimandala come parametro cursor per recuperare la pagina successiva e continua finché non viene più restituito un cursor. Le pagine contengono di solito circa 20 elementi, incluse le live contrassegnate con isLive.
Sono supportati i video con limiti di età o privati?
I video privati restituiscono 404 perché la loro pagina non è pubblica. I video con limiti di età restituiscono i metadati dove YouTube li espone senza login; dove la pagina richiede l'accesso, anche la chiamata restituisce 404.
Casi d'uso correlati
Consulta il tuo primo video
Crea un account gratuito e chiama GET /ytb/youtube-video-details?id=kJQP7kiw5Fk: metadati completi in un'unica risposta JSON, 100 richieste al mese offerte da noi.