youtube/
trending-videos

Recupera i video di tendenza di una categoria come notizie, gaming o sport in qualsiasi Paese, in ordine di classifica, con canale, visualizzazioni, durata e miniatura.

YouTube Trending Videos API

7 categorie
Qualsiasi Paese
Ordine di classifica
0,5 crediti per risultato
Pronto
README

A cura di SocQ · Aggiornato il

YouTube Trending Videos

Le pagine delle tendenze di YouTube mettono in classifica, Paese per Paese, i video che attirano più attenzione in una categoria come notizie, gaming o sport, mostrando per ciascuno posizione, canale, visualizzazioni, durata e quanto tempo è passato dalla pubblicazione. Seguire queste classifiche mostra quali notizie, giochi e creator stanno decollando in un mercato e con che velocità un video entra in classifica o ne esce.

Funzionalità della YouTube Trending Videos API

  • Le pagine di tendenza di sette categoriecategory sceglie la pagina di tendenza news, gaming, sports, learning, courses, fashion o shopping, così ogni attività segue la lista che vede chi guarda quella categoria.
  • Qualsiasi Paese tramite il codice a due lettereregion accetta un codice come US, GB, JP o BR e restituisce la versione della pagina di quel Paese, che spesso mette in classifica video diversi per la stessa categoria.
  • La posizione di ogni videorank registra la posizione di ogni video a partire da 1, insieme a category e region, così ogni riga resta leggibile anche quando unisci più classifiche in un’unica tabella.
  • Il canale dietro ogni video di tendenzaauthor contiene ID, nome, @handle, link, avatar e badge di verifica del canale, così puoi raggruppare i video di tendenza per canale senza una seconda richiesta.
  • Visualizzazioni, durata e miniaturametrics.views_count, duration_seconds, thumbnail_url e l’estratto della descrizione in text descrivono ogni video così come appare nella pagina di tendenza.

Parametri della YouTube Trending Videos API

ParametriObbligatorioDescrizione
categoryObbligatorioPagina di tendenza da leggere: news, gaming, sports, learning, courses, fashion o shopping.
regionFacoltativoCodice a due lettere del Paese della pagina di tendenza, per esempio US, GB o JP. Il valore predefinito è US.
results_limitFacoltativoQuanti video restituire partendo dalla cima della classifica, da 1 a 50. Il valore predefinito è 50.

Come usare la YouTube Trending Videos API

Scegli una categoria e un Paese, inviali a YouTube Trending Videos API e leggi la classifica dall’attività completata.

  1. Invia con POST {"category": "news", "region": "US", "results_limit": 50} a /v1/youtube/trending-videos e annota il task_id.
  2. Interroga GET /v1/tasks/{task_id} a intervalli di pochi secondi finché status diventa succeeded.
  3. Leggi i video in results.items, ordinati per rank; quando results.has_more è true, passa results.next_cursor per caricare la pagina successiva.
curl -X POST "https://api.socq.ai/v1/youtube/trending-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"gaming","region":"GB","results_limit":10}'

# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the ranked videos once status is succeeded.

Casi d’uso della YouTube Trending Videos API

  • Rassegna quotidiana delle tendenze di un mercato: Recupera ogni mattina le pagine notizie e sport di un Paese e passa alla redazione, in ordine di classifica, i titoli, i canali e le visualizzazioni che stanno decollando.
  • Seguire le tendenze del gaming: Segui la pagina gaming nei Paesi in cui pubblichi per individuare giochi, formati e creator in crescita prima di pianificare video o campagne.
  • Confrontare una categoria tra Paesi: Esegui la stessa categoria con diversi codici region e allinea le liste per ID video per vedere quali video viaggiano tra Paesi e quali restano locali.
  • Creare un elenco di canali da contattare: Raccogli i canali che tornano spesso nella pagina di tendenza di una categoria, con handle e badge di verifica, come elenco di partenza per le collaborazioni.

Consigli degli esperti per la YouTube Trending Videos API

  • Pianifica la stessa categoria e lo stesso Paese a un orario fisso e unisci le esecuzioni per id; la variazione di rank mostra quali video salgono e quali perdono terreno.
  • Leggi published_time_text insieme a collected_at: la pagina mostra l’età del video come testo, per esempio “15 min ago”, quindi sottrailo dall’orario di raccolta quando ti serve un orario di caricamento approssimativo.
  • Imposta results_limit su 10 o 20 quando ti serve solo la parte alta della classifica; YouTube Trending Videos API addebita ogni video restituito.
  • Passa gli ID raccolti a YouTube Videos API per ottenere Mi piace, commenti e descrizione completa, oppure a YouTube Transcripts API per leggere cosa si dice in ogni video di tendenza.

Oltre alla YouTube Trending Videos 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 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.

Esplora altre piattaforme

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

YouTube Trending Videos API — FAQ

YouTube Trending Videos API è un’interfaccia programmatica per raccogliere i video di tendenza di una categoria di YouTube, come notizie, gaming o sport, in un Paese a scelta. Restituisce per ogni video posizione, titolo, canale, visualizzazioni, durata, miniatura e quanto tempo è passato dalla pubblicazione.

A luglio 2025 YouTube ha sostituito la pagina Tendenze unica con classifiche di tendenza per le singole categorie, mentre le tendenze del gaming sono rimaste nella pagina Esplora dedicata al gaming. YouTube Trending Videos API legge queste pagine di categoria, quindi scegli tu la categoria da seguire.

Imposta region con il codice a due lettere del Paese, per esempio JP per il Giappone o DE per la Germania. Ogni Paese ha la propria classifica, quindi la stessa categoria può mettere in classifica video diversi in ogni mercato.

Notizie, gaming, sport, apprendimento, corsi, moda e shopping. Invia una categoria per attività ed esegui più attività per coprirne altre.

Fino a 50 dalla cima della classifica, impostati con results_limit. Una categoria con una classifica più corta restituisce i video che contiene e paghi solo le righe che ricevi.

YouTube Trending Videos API addebita 0,5 crediti per ogni video restituito, quindi una classifica completa di 50 video costa 25 crediti e i primi 10 ne costano 5.