youtube/
trending-videos

Obtenga los videos en tendencia de una categoría como noticias, videojuegos o deportes en cualquier país, ordenados por posición, con canal, vistas, duración y miniatura.

YouTube Trending Videos API

7 categorías
Cualquier país
Orden de la lista
0.5 créditos por resultado
Listo
README

Por SocQ · Actualizado el

YouTube Trending Videos

Las páginas de tendencias de YouTube ordenan, para cada país, los videos que más atención reciben en una categoría como noticias, videojuegos o deportes, y muestran de cada uno su posición, el canal, las vistas, la duración y cuánto tiempo pasó desde que se subió. Seguir estas listas permite ver qué noticias, juegos y creadores de contenido despegan en un mercado y con qué rapidez un video entra en la lista o sale de ella.

Funcionalidades de la YouTube Trending Videos API

  • Páginas de tendencias de siete categoríascategory elige la página de tendencias news, gaming, sports, learning, courses, fashion o shopping, de modo que cada tarea sigue la lista que ven quienes miran esa categoría.
  • Cualquier país con su código de dos letrasregion acepta un código como US, GB, JP o BR y devuelve la versión de la página de ese país, que a menudo ordena videos distintos para la misma categoría.
  • La posición de cada videorank registra la posición de cada video desde 1, junto con category y region, para que cada fila conserve su sentido aunque combine varias listas en una sola tabla.
  • El canal detrás de cada video en tendenciaauthor incluye el ID del canal, el nombre, el @handle, el enlace, el avatar y la insignia de verificación, así puede agrupar los videos en tendencia por canal sin otra consulta.
  • Vistas, duración y miniaturametrics.views_count, duration_seconds, thumbnail_url y el fragmento de descripción en text describen cada video tal como aparece en la página de tendencias.

Parámetros de la YouTube Trending Videos API

ParámetrosObligatorioDescripción
categoryObligatorioPágina de tendencias que se va a leer: news, gaming, sports, learning, courses, fashion o shopping.
regionOpcionalCódigo de país de dos letras de la página de tendencias, como US, GB o JP. El valor predeterminado es US.
results_limitOpcionalCantidad de videos que se devuelven desde el inicio de la lista, de 1 a 50. El valor predeterminado es 50.

Cómo usar la YouTube Trending Videos API

Elija una categoría y un país, envíelos a YouTube Trending Videos API y lea la lista ordenada en la tarea terminada.

  1. Envíe {"category": "news", "region": "US", "results_limit": 50} por POST a /v1/youtube/trending-videos y guarde el task_id.
  2. Consulte GET /v1/tasks/{task_id} cada pocos segundos hasta que status cambie a succeeded.
  3. Lea los videos en results.items, ordenados por rank; cuando results.has_more sea true, pase results.next_cursor para cargar la página siguiente.
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.

Casos de uso de la YouTube Trending Videos API

  • Resumen diario de tendencias de un mercado: Obtenga cada mañana las páginas de noticias y deportes de un país y entregue al equipo editorial los títulos, canales y vistas que están despegando, en orden de posición.
  • Seguimiento de las tendencias en videojuegos: Siga la página de gaming en los países donde publica para detectar los juegos, formatos y creadores de contenido en ascenso antes de planear videos o campañas.
  • Comparar una categoría entre países: Ejecute la misma categoría con varios códigos de region y cruce las listas por ID de video para ver qué videos viajan entre países y cuáles se quedan en lo local.
  • Armar una lista de canales para contactar: Reúna los canales que aparecen una y otra vez en la página de tendencias de una categoría, con su handle y su insignia de verificación, como lista inicial para alianzas.

Consejos de expertos para la YouTube Trending Videos API

  • Programe la misma categoría y región a una hora fija y una las ejecuciones por id; los cambios en rank muestran qué videos suben y cuáles pierden fuerza.
  • Lea published_time_text junto con collected_at: la página muestra la antigüedad como texto, por ejemplo “15 min ago”, así que réstela de la hora de recopilación cuando necesite una hora de subida aproximada.
  • Configure results_limit en 10 o 20 cuando solo necesite la parte alta de la lista; YouTube Trending Videos API cobra por cada video devuelto.
  • Pase los ID que recopile a YouTube Videos API para obtener Me gusta, comentarios y la descripción completa, o a YouTube Transcripts API para leer lo que se dice en cada video en tendencia.

Además de la YouTube Trending Videos API, use estas APIs cuando necesite otro tipo de datos públicos de YouTube.

  • YouTube Channel Videos API — Recolecta videos públicos regulares desde URLs de canales, sin incluir Shorts ni transmisiones en vivo.
  • YouTube Comments API — Recolecta comentarios públicos, autores, interacción, videos de origen y contexto de la conversación.
  • YouTube Transcripts API — Obtiene las transcripciones disponibles en texto plano, con selección de idioma opcional.
  • YouTube Channels API — Obtiene la identidad del canal público, imágenes, verificación y estadísticas visibles de audiencia.
  • YouTube Videos API — Obtiene metadatos, miniaturas, duración e interacción desde URLs conocidas de videos o Shorts.
  • YouTube Shorts API — Recolecta Shorts públicos por canal, con miniaturas, duración, datos de publicación e interacción.

Explorar otras plataformas

Combine los datos de YouTube con datos públicos de otras plataformas sociales compatibles.

YouTube Trending Videos API — FAQ

YouTube Trending Videos API es una interfaz programática para obtener los videos en tendencia de una categoría de YouTube, como noticias, videojuegos o deportes, en el país que elija. Devuelve de cada video la posición, el título, el canal, las vistas, la duración, la miniatura y cuánto tiempo pasó desde su publicación.

En julio de 2025, YouTube reemplazó su página única de Tendencias por listas de tendencias de cada categoría, y las tendencias de videojuegos quedaron en la página Explorar de Gaming. YouTube Trending Videos API lee esas páginas de categoría, así que usted elige la categoría que quiere seguir.

Configure region con el código de dos letras del país, por ejemplo JP para Japón o DE para Alemania. Cada país tiene su propia lista, por lo que la misma categoría puede ordenar videos distintos en cada mercado.

Noticias, videojuegos, deportes, aprendizaje, cursos, moda y compras. Envíe una categoría por tarea y ejecute varias tareas para cubrir más.

Hasta 50 desde el inicio de la lista, según results_limit. Una categoría con una lista más corta devuelve los videos que tiene, y solo paga por las filas que recibe.

YouTube Trending Videos API cobra 0.5 créditos por cada video devuelto, así que una lista completa de 50 cuesta 25 créditos y los 10 primeros cuestan 5.