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ámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | Enlace 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.
- Envíe {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} por POST a /v1/youtube/related-videos.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- 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.
APIs relacionadas
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.
- 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 Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API