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ámetros | Obligatorio | Descripción |
|---|---|---|
category | Obligatorio | Página de tendencias que se va a leer: news, gaming, sports, learning, courses, fashion o shopping. |
region | Opcional | Código de país de dos letras de la página de tendencias, como US, GB o JP. El valor predeterminado es US. |
results_limit | Opcional | Cantidad 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.
- Envíe {"category": "news", "region": "US", "results_limit": 50} por POST a /v1/youtube/trending-videos y guarde el task_id.
- Consulte GET /v1/tasks/{task_id} cada pocos segundos hasta que status cambie a succeeded.
- 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.
APIs relacionadas
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.
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts 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 Email Finder API