API de plataforma de EveryData

API de YouTube

Q: ¿Cómo llamo a la API de YouTube?

Envía POST /api/v1/social con `platform` igual a `youtube`, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

Q: ¿Qué devuelve la API de YouTube?

Devuelve JSON estructurado. Por ejemplo, el esquema de `search` incluye `title`, `text`, `author_name` y `author_username`. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.

Q: ¿Qué parámetros son obligatorios?

Depende de la acción. `search` requiere `keyword`; `profile` requiere `url`; `user_posts` requiere `url`; consulta las demás acciones en la lista de funciones.

Busca y consulta videos, canales, publicaciones, comentarios, Shorts y transcripciones públicas de YouTube. Palabra, URL y nombre de canal tienen contratos propios.

Suscriptores, vistas e interacciones son señales visibles, no Analytics ni historial. Una pista de subtítulos puede faltar y la acción no genera contenido privado.

Empieza gratis Ver el catálogo público

Endpoint: POST /api/v1/social
Funciones: 8
Por 1.000: 0,556 US$

Funciones disponibles

Compara las acciones de YouTube por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.

Acción	Obligatorios	Opcionales	Entrega	Límite	Por 1.000	Campos de respuesta
`search` Buscar videos en YouTube Busca videos de YouTube mediante `keyword` y orden opcional, devolviendo canal, texto y métricas visibles. No garantiza resultados completos ni una explicación del ranking.	keyword	sort	Entrega síncrona	El catálogo declara `defaultLimit = 10` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.	$0.56 por 1.000 solicitudes	id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · platform
`profile` Consultar un canal de YouTube Abre la `url` de un canal y recoge biografía, suscriptores, videos y vistas públicas. Fecha u orden compatibles no revelan Analytics ni listas nominales de suscriptores.	url	since, sort	Entrega síncrona	—	$0.56 por 1.000 solicitudes	channel_id · name · url · bio · subscriber_count · video_count · view_count · is_verified · location · avatar_url · banner_url · created_at · platform
`user_posts` Listar publicaciones de un canal Obtiene publicaciones o videos públicos de la `url` del canal, con fecha y orden opcionales. El lote no garantiza todo el archivo ni contenido privado.	url	since, sort	Entrega síncrona	El catálogo declara `defaultLimit = 10` y `maxLimit = 50` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.	$0.56 por 1.000 solicitudes	id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · platform
`video` Consultar un video de YouTube Consulta la `url` de un video con filtros compatibles de fecha, duración u orden y devuelve metadatos e interacciones. No añade comentarios o transcripción automáticamente.	url	date_range, duration, since, sort	Entrega síncrona	—	$0.56 por 1.000 solicitudes	id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · platform
`comments` Leer comentarios de un video Lee comentarios de la `url` del video y conserva autor, fecha, likes y relación de respuesta cuando existe. No publica ni promete el árbol completo.	url	since, sort	Entrega síncrona	El catálogo declara `defaultLimit = 20` y `maxLimit = 100` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.	$0.56 por 1.000 solicitudes	id · text · author_name · like_count · reply_count · posted_at · is_reply · reply_to_id · platform
`followers` Revisar métricas públicas del canal Recibe `username` y devuelve contadores y precisión de conexión, con `channel` compatible. No es una lista de suscriptores ni expone identidades privadas.	username	channel	Entrega síncrona	—	$0.56 por 1.000 solicitudes	id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform
`transcript` Obtener subtítulos y transcripción Extrae de la `url` texto y segmentos en el idioma solicitado cuando están disponibles. No garantiza subtítulos para cada video, traducción automática o precisión perfecta.	url	language, since, until	Entrega síncrona	—	$0.56 por 1.000 solicitudes	id · url · title · text · segments · language · available_languages · channel_id · channel_name · channel_username · view_count · like_count · comment_count · posted_at · platform · start · duration
`shorts` Listar Shorts de un canal Consulta Shorts del `username`, con canal, fecha u orden opcionales, y devuelve duración, vistas y autor. El lote no representa todos los videos cortos del canal.	username	channel, since, sort	Entrega síncrona	El catálogo declara `defaultLimit = 20` y `maxLimit = 100` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.	$0.56 por 1.000 solicitudes	id · url · title · thumbnail_url · view_count · like_count · duration · posted_at · author_name · author_id · author_url · platform

¿Qué acepta cada acción de YouTube?

Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.

Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.

¿Qué significan los parámetros de YouTube `search`?

Busca videos de YouTube mediante keyword y orden opcional, devolviendo canal, texto y métricas visibles. No garantiza resultados completos ni una explicación del ranking.

keywordObligatorio: Palabra clave para buscar vídeos en YouTube con la acción search. Si usas este parámetro con la acción shorts, buscará por nombre de canal, no en todos los Shorts de la plataforma.
sortOpcional: Criterio de orden. Para search, usa relevance (relevancia), newest (fecha), most_viewed (reproducciones) o top_rated (puntuación). Para vídeos de un canal y Shorts, usa newest, oldest o popular. Para comments, usa newest (más recientes) o popular (destacados). La presencia de este parámetro en llamadas a un vídeo único no implica que se pueda filtrar su contenido.
Valores permitidos:most_viewednewestrelevancetop_rated

¿Qué significan los parámetros de YouTube `profile`?

Abre la url de un canal y recoge biografía, suscriptores, videos y vistas públicas. Fecha u orden compatibles no revelan Analytics ni listas nominales de suscriptores.

urlObligatorio: Las acciones profile y user_posts usan la URL de un canal. Las acciones video, comments y transcript usan un enlace de vídeo específico (watch?v=...) o un enlace para compartir. La información del perfil se obtiene del contenido del canal. Los comentarios obtenidos no son los del muro del canal.
sinceOpcional: Fecha de publicación más antigua para vídeos de un canal o Shorts, o fecha del comentario más antiguo para comments. No se ha confirmado que este campo de fecha tenga efecto en llamadas a un vídeo único o a transcript.
sortOpcional: Criterio de orden. Para search, usa relevance (relevancia), newest (fecha), most_viewed (reproducciones) o top_rated (puntuación). Para vídeos de un canal y Shorts, usa newest, oldest o popular. Para comments, usa newest (más recientes) o popular (destacados). La presencia de este parámetro en llamadas a un vídeo único no implica que se pueda filtrar su contenido.
Valores permitidos:newestoldestpopular

¿Qué significan los parámetros de YouTube `user_posts`?

Obtiene publicaciones o videos públicos de la url del canal, con fecha y orden opcionales. El lote no garantiza todo el archivo ni contenido privado.

urlObligatorio: Las acciones profile y user_posts usan la URL de un canal. Las acciones video, comments y transcript usan un enlace de vídeo específico (watch?v=...) o un enlace para compartir. La información del perfil se obtiene del contenido del canal. Los comentarios obtenidos no son los del muro del canal.
sinceOpcional: Fecha de publicación más antigua para vídeos de un canal o Shorts, o fecha del comentario más antiguo para comments. No se ha confirmado que este campo de fecha tenga efecto en llamadas a un vídeo único o a transcript.
sortOpcional: Criterio de orden. Para search, usa relevance (relevancia), newest (fecha), most_viewed (reproducciones) o top_rated (puntuación). Para vídeos de un canal y Shorts, usa newest, oldest o popular. Para comments, usa newest (más recientes) o popular (destacados). La presencia de este parámetro en llamadas a un vídeo único no implica que se pueda filtrar su contenido.
Valores permitidos:newestoldestpopular

¿Qué significan los parámetros de YouTube `video`?

Consulta la url de un video con filtros compatibles de fecha, duración u orden y devuelve metadatos e interacciones. No añade comentarios o transcripción automáticamente.

urlObligatorio: Las acciones profile y user_posts usan la URL de un canal. Las acciones video, comments y transcript usan un enlace de vídeo específico (watch?v=...) o un enlace para compartir. La información del perfil se obtiene del contenido del canal. Los comentarios obtenidos no son los del muro del canal.
date_rangeOpcional: Filtro por fecha de publicación para descubrir vídeos. Valores: last_hour (última hora), today (hoy), this_week (esta semana), this_month (este mes), this_year (este año). No se ha confirmado que este filtro funcione en llamadas a un vídeo específico.
Valores permitidos:last_hourthis_monththis_weekthis_yeartoday
durationOpcional: Filtro por duración del vídeo. Valores: under_4_minutes (menos de 4 minutos), 4_20_minutes (entre 4 y 20 minutos), over_20_minutes (más de 20 minutos). No se refiere a la longitud de la transcripción devuelta ni al tiempo de espera de la API. No se ha confirmado su aplicabilidad en llamadas a un vídeo específico.
Valores permitidos:4_20_minutesover_20_minutesunder_4_minutes
sinceOpcional: Fecha de publicación más antigua para vídeos de un canal o Shorts, o fecha del comentario más antiguo para comments. No se ha confirmado que este campo de fecha tenga efecto en llamadas a un vídeo único o a transcript.
sortOpcional: Criterio de orden. Para search, usa relevance (relevancia), newest (fecha), most_viewed (reproducciones) o top_rated (puntuación). Para vídeos de un canal y Shorts, usa newest, oldest o popular. Para comments, usa newest (más recientes) o popular (destacados). La presencia de este parámetro en llamadas a un vídeo único no implica que se pueda filtrar su contenido.
Valores permitidos:most_viewednewestrelevancetop_rated

¿Qué significan los parámetros de YouTube `comments`?

Lee comentarios de la url del video y conserva autor, fecha, likes y relación de respuesta cuando existe. No publica ni promete el árbol completo.

urlObligatorio: Las acciones profile y user_posts usan la URL de un canal. Las acciones video, comments y transcript usan un enlace de vídeo específico (watch?v=...) o un enlace para compartir. La información del perfil se obtiene del contenido del canal. Los comentarios obtenidos no son los del muro del canal.
sinceOpcional: Fecha de publicación más antigua para vídeos de un canal o Shorts, o fecha del comentario más antiguo para comments. No se ha confirmado que este campo de fecha tenga efecto en llamadas a un vídeo único o a transcript.
sortOpcional: Criterio de orden. Para search, usa relevance (relevancia), newest (fecha), most_viewed (reproducciones) o top_rated (puntuación). Para vídeos de un canal y Shorts, usa newest, oldest o popular. Para comments, usa newest (más recientes) o popular (destacados). La presencia de este parámetro en llamadas a un vídeo único no implica que se pueda filtrar su contenido.
Valores permitidos:newestpopular

¿Qué significan los parámetros de YouTube `followers`?

Recibe username y devuelve contadores y precisión de conexión, con channel compatible. No es una lista de suscriptores ni expone identidades privadas.

usernameObligatorio: Handle de un canal para las acciones followers y shorts. Puede incluir el símbolo @. La acción followers devuelve el número de suscriptores, no la lista de suscriptores. La acción shorts prioriza el uso del handle sobre el ID de canal (formato UC…).
YouTube: handle del canal y nombre visibleYouTube define el handle como un identificador único que empieza por `@` y lo distingue del nombre visible del canal. Conviene conservar esa diferencia al resolver `username` y atribuir resultados.Consultada 2026-09-04
channelOpcional: Parámetro compatible para el handle de un canal. Las URL completas de canal (/channel/UC…) no se procesan correctamente en algunas acciones; prioriza el uso del handle o de la url que la acción requiera explícitamente.

¿Qué significan los parámetros de YouTube `transcript`?

Extrae de la url texto y segmentos en el idioma solicitado cuando están disponibles. No garantiza subtítulos para cada video, traducción automática o precisión perfecta.

urlObligatorio: Las acciones profile y user_posts usan la URL de un canal. Las acciones video, comments y transcript usan un enlace de vídeo específico (watch?v=...) o un enlace para compartir. La información del perfil se obtiene del contenido del canal. Los comentarios obtenidos no son los del muro del canal.
languageOpcional: Código de idioma de los subtítulos o la transcripción para la acción transcript. Se obtiene según los idiomas disponibles. No se garantiza la traducción automática ni que todas las rutas de ejecución respeten este parámetro.
sinceOpcional: Fecha de publicación más antigua para vídeos de un canal o Shorts, o fecha del comentario más antiguo para comments. No se ha confirmado que este campo de fecha tenga efecto en llamadas a un vídeo único o a transcript.
untilOpcional: Fecha de fin para la acción transcript. Actualmente solo se envía la URL de un vídeo, y no se ha confirmado que este parámetro pueda recortar el vídeo o limitar el intervalo de tiempo de los subtítulos. No lo trates como un segundo de finalización.

¿Qué significan los parámetros de YouTube `shorts`?

Consulta Shorts del username, con canal, fecha u orden opcionales, y devuelve duración, vistas y autor. El lote no representa todos los videos cortos del canal.

usernameObligatorio: Handle de un canal para las acciones followers y shorts. Puede incluir el símbolo @. La acción followers devuelve el número de suscriptores, no la lista de suscriptores. La acción shorts prioriza el uso del handle sobre el ID de canal (formato UC…).
YouTube: handle del canal y nombre visibleYouTube define el handle como un identificador único que empieza por `@` y lo distingue del nombre visible del canal. Conviene conservar esa diferencia al resolver `username` y atribuir resultados.Consultada 2026-09-04
channelOpcional: Parámetro compatible para el handle de un canal. Las URL completas de canal (/channel/UC…) no se procesan correctamente en algunas acciones; prioriza el uso del handle o de la url que la acción requiera explícitamente.
sinceOpcional: Fecha de publicación más antigua para vídeos de un canal o Shorts, o fecha del comentario más antiguo para comments. No se ha confirmado que este campo de fecha tenga efecto en llamadas a un vídeo único o a transcript.
sortOpcional: Criterio de orden. Para search, usa relevance (relevancia), newest (fecha), most_viewed (reproducciones) o top_rated (puntuación). Para vídeos de un canal y Shorts, usa newest, oldest o popular. Para comments, usa newest (más recientes) o popular (destacados). La presencia de este parámetro en llamadas a un vídeo único no implica que se pueda filtrar su contenido.
Valores permitidos:newestoldestpopular

Cómo usar la API de YouTube

01Consulta el catálogo público y elige una acción de la plataforma.
02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
04Guarda los campos de la respuesta estructurada que necesita tu aplicación.

youtube_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"youtube","action":"search","params":{"keyword":"<keyword>"}}'

Preguntas sobre la API de YouTube

¿Cómo llamo a la API de YouTube?

Envía POST /api/v1/social con platform igual a youtube, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

¿Qué devuelve la API de YouTube?

Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, text, author_name y author_username. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.

¿Qué matiz de la documentación oficial conviene conservar al usar datos de YouTube?

YouTube define el handle como un identificador único que empieza por @ y lo distingue del nombre visible del canal. Conviene conservar esa diferencia al resolver username y atribuir resultados.

¿Qué parámetros son obligatorios?

Depende de la acción. search requiere keyword; profile requiere url; user_posts requiere url; consulta las demás acciones en la lista de funciones.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douban API Douyin API Ver el catálogo público →

API de YouTube

Funciones disponibles

¿Qué acepta cada acción de YouTube?

¿Qué significan los parámetros de YouTube search?

¿Qué significan los parámetros de YouTube profile?

¿Qué significan los parámetros de YouTube user_posts?

¿Qué significan los parámetros de YouTube video?

¿Qué significan los parámetros de YouTube comments?

¿Qué significan los parámetros de YouTube followers?

¿Qué significan los parámetros de YouTube transcript?

¿Qué significan los parámetros de YouTube shorts?