YouTube Trending Shorts
Los Shorts en tendencia son los videos verticales que YouTube está mostrando a una audiencia amplia en este momento, cada uno con su título, el canal que lo publicó, los conteos de vistas, Me gusta y comentarios, la duración y la hora exacta en que se subió. Leídas en conjunto, esas señales muestran qué temas, formatos y creadores de contenido están despegando, y con qué rapidez un Short acumula vistas después de publicarse.
Funcionalidades de la YouTube Trending Shorts API
- Directo del grupo de tendenciasNo hay nada que completar: cada ejecución toma los Shorts que YouTube promueve en ese momento, alrededor de 48 por extracción, y las extracciones repetidas se combinan sin duplicados hasta llegar a results_limit.
- Tres conteos de interacción por Shortmetrics incluye los conteos exactos de vistas y Me gusta junto con el conteo de comentarios que muestra YouTube, de modo que un Short con mucha conversación se distingue de uno que solo se está viendo.
- Canal asociado a cada Shortauthor contiene el ID, el handle, el nombre, la URL y el avatar del canal, listos para pasarlos a las API de canales.
- Hora de publicación y duraciónpublished_at es la hora exacta de subida en UTC y duration_seconds la duración, que juntas indican qué tan nuevo y qué tan largo es un Short en tendencia.
- Hashtags extraídos de la descripciónLas etiquetas escritas en el título o la descripción se enumeran en hashtags, sin el # inicial.
Parámetros de la YouTube Trending Shorts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
results_limit | Opcional | Número de Shorts en tendencia que se devuelven, de 1 a 200. El valor predeterminado es 48. |
Cómo usar la YouTube Trending Shorts API
Envíe un número de resultados opcional y lea los Shorts cuando termine la tarea.
- Envíe {"results_limit": 48} por POST a /v1/youtube/trending-shorts; el cuerpo también puede ir vacío.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea los Shorts de results.items y continúe con results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"results_limit":48}'
# Each item is one Short with metrics.views_count and author.
# Read them from GET /v1/tasks/{task_id}.Casos de uso de la YouTube Trending Shorts API
- Instantáneas diarias de tendencias: Ejecute el endpoint a horas fijas y guarde cada lote para ver qué temas y formatos siguen apareciendo entre los Shorts en tendencia.
- Detección de creadores emergentes: Compare views_count con published_at para encontrar canales cuyas subidas recientes reúnen millones de vistas en pocos días.
- Seguimiento de hashtags en Shorts: Cuente los hashtags de los Shorts en tendencia para ver qué etiquetas acompañan a los videos cortos virales de esta semana.
Consejos de expertos para la YouTube Trending Shorts API
- Cada ejecución es una muestra nueva, así que conserve el id de cada Short que guarde y omita los repetidos al combinar ejecuciones separadas por pocos minutos.
- Divida views_count entre las horas transcurridas desde published_at para clasificar los Shorts por velocidad y no por vistas totales.
- Envíe author.url a YouTube Channels cuando también necesite el número de suscriptores y la descripción del canal.
APIs relacionadas
Además de la YouTube Trending Shorts 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 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
- YouTube Trending Videos API