youtube/
related-videos

Enumere a partir de su URL los videos que YouTube recomienda junto a un video, con el título, el canal, el número de vistas y la miniatura de cada recomendación en una sola ejecución.

YouTube Related Videos API

Entrada por URL de video
Recomendaciones a continuación
Canal y vistas
0.5 créditos por resultado
Listo
README

Por SocQ · Actualizado el

YouTube Related Videos

Los videos relacionados son las recomendaciones que YouTube coloca junto a un video como lo siguiente para ver, cada una con su título, canal, número de vistas y miniatura. Esa lista revela qué videos y canales ubica YouTube en el mismo entorno, lo que sirve para mapear un nicho, encontrar canales competidores y planificar contenido que aparezca junto a un video objetivo.

Funcionalidades de la YouTube Related Videos API

  • Cualquier enlace de video habitualSe lee el ID de video de las URL de reproducción, los enlaces cortos youtu.be, los enlaces de Shorts y los enlaces de transmisiones en vivo.
  • La lista completa en una ejecuciónUna tarea devuelve la lista completa de recomendaciones que YouTube muestra para ese video, por lo general alrededor de 20 videos.
  • Quién creó cada recomendaciónauthor contiene el ID, el nombre y la URL del canal de cada video recomendado.
  • Vistas y miniaturametrics.views_count se obtiene del conteo que muestra YouTube, como 2.2M, y media ofrece la miniatura más grande.

Parámetros de la YouTube Related Videos API

ParámetrosObligatorioDescripción
urlObligatorioEnlace de un video de YouTube: una URL de reproducción, un enlace youtu.be, un enlace de Shorts o un enlace de transmisión en vivo.

Cómo usar la YouTube Related Videos API

Envíe el enlace de un video y lea las recomendaciones devueltas.

  1. Envíe {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} por POST a /v1/youtube/related-videos.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea las recomendaciones de results.items y continúe con results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

# Each item is one recommended video with author and metrics.views_count.

Casos de uso de la YouTube Related Videos API

  • Mapeo de un nicho en torno a un video: Parta de un video sólido, recopile sus recomendaciones y repita el proceso con esos resultados para trazar el grupo de videos que YouTube reúne.
  • Búsqueda de canales competidores: Cuente cuántas veces aparece cada author.id junto a sus propias subidas para ver qué canales recomienda YouTube una y otra vez a su lado.
  • Verificación de dónde se recomienda su video: Ejecute el endpoint con los videos populares de la competencia y busque los ID de sus propios videos en esas listas.

Consejos de expertos para la YouTube Related Videos API

  • Trate views_count como una aproximación: proviene de un texto redondeado como 2.2M.
  • Las recomendaciones cambian con el tiempo, así que guarde collected_at con cada lista cuando compare ejecuciones.
  • Envíe las URL de los videos que conserve a YouTube Videos para obtener conteos exactos, fechas de publicación y duraciones.

Además de la YouTube Related 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 Related Videos API — FAQ

YouTube Related Videos API es una interfaz programática para enumerar, a partir de la URL de un video, los videos que YouTube recomienda junto a él. Devuelve el título, el canal, el número de vistas y la miniatura de cada recomendación.

Devuelve la lista completa que YouTube muestra para ese video, por lo general alrededor de 20 videos.

Sí. Se aceptan enlaces de Shorts, enlaces youtu.be, enlaces de transmisiones en vivo y URL de reproducción normales.

Ya no. La Data API oficial dejó de admitir el parámetro de búsqueda relatedToVideoId el 7 de agosto de 2023, así que este endpoint es la forma de leer la lista que YouTube muestra junto a un video.

Cada video recomendado devuelto cuesta 0.5 créditos, por lo que una lista típica de 20 cuesta 10 créditos.