youtube/
shorts

Recopile los Shorts públicos de URL de canales de YouTube, con títulos normalizados, contexto del canal, miniaturas, duración, datos de publicación e interacción visible.

YouTube Shorts API

Shorts
Descubrimiento por canal
Métricas públicas
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

YouTube Shorts

Los Shorts de YouTube son videos de formato corto con títulos, contexto del canal, miniaturas, duración, datos de publicación, clasificación de origen e interacción visible. Estas señales de contenido y rendimiento sirven para investigar formatos, comparar creadores, monitorear tendencias y analizar campañas.

Funcionalidades de la YouTube Shorts API

  • Recopilación de Shorts de varios canalesRecopila los Shorts públicos de varias URL de canales en una sola solicitud.
  • Límites de resultados por canalPermite definir un results_limit distinto para cada canal de entrada, con un valor predeterminado de 100.
  • Metadatos de Short normalizadosDevuelve la identidad del Short normalizada, los metadatos del contenido, las miniaturas, la duración, la fecha de publicación y el canal que lo publicó.
  • Métricas de interacción de un momento concretoIncluye las vistas, los Me gusta y los comentarios públicos con collected_at para compararlos más adelante.
  • Alcance de Shorts nativo de la plataformaUsa la clasificación de Shorts de YouTube en lugar de definir el contenido de formato corto solo por su duración u orientación.

Parámetros de la YouTube Shorts API

ParámetrosObligatorioDescripción
urlsObligatorioURL públicas de canales de YouTube, separadas por comas o saltos de línea.
results_limitOpcionalCantidad máxima de registros elegibles que se solicitan por cada URL de entrada. Debe ser un entero positivo y su valor predeterminado es 100.

Cómo usar la YouTube Shorts API

Cree un flujo limpio de contenido de formato corto para un conjunto de canales conocido. La tarea separa la clasificación de la plataforma de cualquier regla de formato personalizada que aplique después.

  1. Prepare URL de canales públicos; las URL de Shorts individuales corresponden a Videos cuando necesita una consulta directa.
  2. Envíe urls y results_limit por POST a /v1/youtube/shorts, teniendo en cuenta que el límite se aplica a cada canal.
  3. Consulte /v1/tasks/{task_id} hasta que termine el inventario de canales.
  4. Indexe los resultados por ID de Short, conserve el contexto del canal y de la recopilación, y pagine mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Casos de uso de la YouTube Shorts API

  • Monitoreo de la actividad en formato corto: Siga los Shorts públicos publicados por creadores, marcas, medios o competidores seleccionados.
  • Comparación del rendimiento de Shorts: Compare la frecuencia de publicación, la duración, las vistas, los Me gusta y los comentarios entre los canales seleccionados.
  • Catálogos de contenido de formato corto: Arme una colección normalizada de Shorts públicos para búsqueda interna, revisión o informes.
  • Análisis de temas y tendencias: Use títulos, descripciones, hashtags, datos del canal y métricas públicas en flujos de clasificación o investigación.

Consejos de expertos para la YouTube Shorts API

  • No reclasifique los resultados con un umbral de duración universal. La clasificación pública de formato de YouTube es la especificación de este endpoint.
  • El límite es por canal y es un tope, no una garantía. Algunos canales tienen pocos Shorts públicos elegibles o ninguno.
  • Use el ID devuelto para deduplicar; el mismo elemento puede aparecer con distintas formas de URL pública en otras partes de su sistema.
  • Conserve collected_at junto con las métricas, porque los contadores visibles de un Short pueden cambiar con rapidez tras su publicación.
  • Este endpoint no busca por palabra clave. Empiece por Search para descubrir temas y, si hace falta, envíe las URL de Shorts conocidas a Videos.
  • Recopile Channel Videos por separado cuando necesite una comparación limpia entre la publicación en formato corto y la regular.
  • Combine Channels por ID de canal para obtener los campos de perfil y de audiencia en lugar de repetir en cada elemento los metadatos mutables del canal.

Además de la YouTube 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 Channel Live Videos API — Recolecta registros de transmisiones públicas expuestas en las secciones en vivo de un canal, con contexto de origen y métricas visibles.

Explorar otras plataformas

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

YouTube Shorts API — FAQ

YouTube Shorts API recopila los Shorts de acceso público de una o más URL de canales de YouTube. Devuelve títulos normalizados, información del canal, miniaturas, duración, fechas de publicación, métricas de interacción y hora de recopilación.

Envíe una o más URL públicas de canales de YouTube y, de forma opcional, results_limit.

El endpoint sigue la clasificación de Shorts de YouTube en lugar de usar solo una regla fija de duración o de relación de aspecto.

results_limit tiene un valor predeterminado de 100 y se aplica por separado a cada URL de canal. El total final puede ser menor cuando un canal tiene menos Shorts públicos elegibles.

No. Las vistas, los Me gusta y los comentarios son valores públicos observados en el momento de la recopilación. Para una comparación histórica se necesitan recopilaciones repetidas.

El uso cuesta 0.5 créditos por cada resultado de Short normalizado devuelto.