youtube/
trending-shorts

Obtenga una muestra de los Shorts que son tendencia en YouTube en este momento, sin datos de entrada, con títulos, canales, vistas, Me gusta, comentarios, duración y hora exacta de publicación.

YouTube Trending Shorts API

Sin datos de entrada
Muestra nueva en cada ejecución
Vistas, Me gusta y comentarios
0.5 créditos por resultado
Listo
README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
results_limitOpcionalNú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.

  1. Envíe {"results_limit": 48} por POST a /v1/youtube/trending-shorts; el cuerpo también puede ir vacío.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. 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.

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.

Explorar otras plataformas

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

YouTube Trending Shorts API — FAQ

YouTube Trending Shorts API es una interfaz programática para obtener, sin ninguna búsqueda de entrada, una muestra de los Shorts que YouTube promueve actualmente como tendencia. Devuelve de cada Short el título, el canal, los conteos de vistas, Me gusta y comentarios, la duración y la hora de publicación.

Cada ejecución toma una muestra nueva del grupo de tendencias, por lo que dos ejecuciones separadas por pocos minutos solo comparten unos cuantos Shorts. Programar varias ejecuciones y combinarlas por id ofrece una visión más amplia de lo que es tendencia.

Asigne a results_limit cualquier valor de 1 a 200; el valor predeterminado es 48, que equivale aproximadamente a una extracción del grupo de tendencias.

Las vistas y los Me gusta sí: views_count y likes_count son números enteros completos tomados de cada Short. comments_count sigue la cifra que muestra YouTube, por lo que los conteos superiores a mil se redondean, por ejemplo 4800 para 4.8K, y los Me gusta o los comentarios son null cuando un creador los oculta.

No hay un parámetro de país. Cada ejecución devuelve los Shorts que están en el grupo de tendencias en ese momento, así que programe ejecuciones y combínelas por id para seguir cómo cambia el grupo.

Cada Short devuelto cuesta 0.5 créditos, por lo que los 48 Shorts predeterminados cuestan 24 créditos.