YouTubeYouTube ShortsPublicaciones de comunidadContacto con creadoresGuía de API

Nuevos endpoints de la API de YouTube: Shorts en tendencia, publicaciones de comunidad, búsqueda de canales y correos

Ocho nuevos endpoints de YouTube en SocQ devuelven Shorts en tendencia, búsqueda de Shorts y de canales, sugerencias de búsqueda, publicaciones de comunidad y sus comentarios, videos relacionados y correos comerciales de canales.

SocQActualizado el 19 de noviembre de 20268 min de lectura

SocQ ya devolvía canales, videos, Shorts, comentarios, búsquedas, listas de reproducción y transcripciones públicas de YouTube. Las 7 mejores APIs de scraping de YouTube los compara, y la guía de transcripciones de YouTube cubre la descarga masiva de subtítulos. El 2026-11-17 se publicaron ocho endpoints más en la página de la plataforma YouTube. Cubren huecos en la investigación de Shorts, el descubrimiento de creadores y el contacto con ellos, y las publicaciones de comunidad que los creadores comparten entre un video y otro.

Esta guía agrupa los nuevos endpoints por tarea, muestra una solicitud para cada uno, indica el precio y explica cuándo usarlo.

Respuesta rápida: envíe un cuerpo JSON a POST https://api.socq.ai/v1/youtube/<endpoint>. Guarde el task_id devuelto, consulte GET /v1/tasks/{task_id} hasta que status sea succeeded y luego lea data.results.items.

Los nuevos endpoints de YouTube de un vistazo

1 crédito de SocQ = $0.005. Los endpoints que cobran por resultado no tienen tarifa base, así que un resultado vacío no cuesta nada.

EndpointQué devuelvePrecio
YouTube Trending Shorts APIUna muestra reciente de Shorts en tendencia con canal, vistas, me gusta, comentarios, duración y fecha de publicación0.5 créditos ($0.0025) por Short
YouTube Shorts Search APIShorts para una palabra clave con enlace, texto, vistas y miniatura vertical0.6 créditos ($0.003) por Short
YouTube Channel Search APICanales para una palabra clave con ID, nombre, suscriptores, avatar y fragmento de la descripción0.6 créditos ($0.003) por canal
YouTube Search Suggestions APISugerencias de autocompletado ordenadas para una consulta parcial, por idioma y región0.5 créditos ($0.0025) por llamada
YouTube Community Post APIUna publicación de comunidad: texto completo, todas las imágenes, me gusta y canal0.5 créditos ($0.0025) por llamada
YouTube Community Post Comments APIComentarios de una publicación de comunidad con autor, me gusta y número de respuestas0.3 créditos ($0.0015) por comentario
YouTube Related Videos APILos videos que YouTube recomienda junto a un video0.5 créditos ($0.0025) por video
YouTube Email Finder APICorreos comerciales públicos de un canal y las páginas donde se encontraron15 créditos ($0.075) por canal con correo; gratis si no se encuentra ninguno

Autenticación y flujo de tareas asíncronas

Todas las solicitudes se autentican con una clave de API. Se usa el mismo encabezado para el envío, el estado de la tarea y las solicitudes de resultados:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Cada recopilación se ejecuta como una tarea en segundo plano:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

La llamada de envío responde de inmediato con data.task_id y data.status. Consulte la tarea con ese ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Cuando status es succeeded, la respuesta incluye result_count, credits_amount y la primera página de registros normalizados en data.results.items. limit vale 50 por defecto y admite hasta 500. Si results.has_more es verdadero, pase results.next_cursor como cursor para leer la página siguiente. Una tarea fallida incluye error_message.

Todos los endpoints de abajo aceptan además un callback_url opcional. SocQ envía un POST con un resumen de la tarea cuando esta termina; lea los registros desde el endpoint de tareas. Un tiempo de espera agotado en el cliente no cancela la tarea, así que retome con el mismo ID de tarea en lugar de enviarla de nuevo. Un 402 significa que la cuenta se quedó sin créditos, y un 429 que la clave alcanzó un límite de solicitudes o de créditos.

Investigar Shorts y la demanda de búsqueda

Trending Shorts toma una muestra de los Shorts que YouTube destaca como tendencia en este momento, cada uno con título, canal, vistas, me gusta, comentarios, duración y fecha de publicación. Todos los campos son opcionales; results_limit vale 48 por defecto y admite hasta 200. Cada ejecución toma una muestra nueva, por lo que dos ejecuciones con pocos minutos de diferencia solo comparten unos cuantos Shorts. Por eso, una tarea programada ofrece una visión más amplia a lo largo del día que una sola llamada grande. (documentación)

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}'

Shorts Search devuelve Shorts para una palabra clave en el orden de búsqueda de YouTube, con enlace, texto, número de vistas y miniatura vertical. Los resultados de búsqueda solo incluyen esos datos básicos, así que pase los enlaces que conserve a YouTube Videos cuando también necesite me gusta, comentarios o detalles del canal. results_limit vale 25 por defecto (de 1 a 200). (documentación)

curl -X POST "https://api.socq.ai/v1/youtube/search-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "meal prep", "results_limit": 25}'

Search Suggestions devuelve los autocompletados que propone el cuadro de búsqueda de YouTube para el inicio de una consulta, en el orden en que los ven los usuarios. language vale en por defecto y region vale US; cámbielos para ver cómo la misma consulta inicial se ramifica en otro mercado. Cada llamada se cobra una sola vez, sin importar cuántas sugerencias devuelva. Úselo para investigación de palabras clave, títulos y etiquetas. (documentación)

curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "iphone 17"}'

Descubrir creadores y encontrar su correo de contacto

Channel Search encuentra canales para una palabra clave, en el orden de YouTube, con ID del canal, nombre, número de suscriptores, avatar y el fragmento de descripción que se muestra en los resultados. results_limit vale 20 por defecto (de 1 a 200). Es el primer paso del descubrimiento de creadores: haga aquí una lista corta y luego obtenga los detalles con YouTube Channels o los videos subidos con YouTube Channel Videos. (documentación)

curl -X POST "https://api.socq.ai/v1/youtube/search-channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "home cooking", "results_limit": 20}'

Email Finder busca los correos comerciales que un creador ha publicado: en la descripción del canal, en perfiles sociales enlazados, en páginas de link in bio o en el sitio web del propio creador. Cada dirección de emails va acompañada de las source_urls donde se encontró. url acepta un enlace de canal con el formato @handle o /channel/UC.... Un canal con al menos un correo público devuelve un resultado con todas las direcciones encontradas y cuesta 15 créditos ($0.075); un canal que no publica ninguno devuelve un resultado vacío sin cargo. (documentación)

curl -X POST "https://api.socq.ai/v1/youtube/channel-email" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/@mkbhd"}'

Ejemplo de costo: busque 20 canales (12 créditos) y luego ejecute Email Finder sobre los 20. Si 8 publican un correo, son 120 créditos, para un total de 132 créditos ($0.66). No paga nada por los 12 canales sin correo público.

Leer publicaciones de comunidad y sus comentarios

Community Post lee una publicación a partir de su enlace: texto completo, todas las imágenes adjuntas, número de me gusta y el canal que la publicó. url acepta un enlace https://www.youtube.com/post/{post_id} o un enlace a la pestaña Publicaciones del canal que incluya ?lb={post_id}. Úselo cuando ya tenga la URL de una publicación, por ejemplo de un resultado de YouTube Community Posts. (documentación)

curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'

Community Post Comments recopila los comentarios de una publicación, como una encuesta, un anuncio o una publicación de imágenes, con el canal de cada comentarista, metrics.likes_count y metrics.replies_count. Los comentarios de publicaciones están separados de los comentarios de videos, así que esta es la forma de leer la reacción a las novedades que un creador comparte entre un video y otro. Funcionan los mismos formatos de URL; results_limit vale 100 por defecto (de 1 a 1000). (documentación)

curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ", "results_limit": 100}'

Ver qué recomienda YouTube a continuación

Related Videos devuelve la lista que YouTube coloca junto a un video como sugerencias para ver a continuación: títulos, canales, número de vistas y miniaturas. url acepta un enlace de reproducción, de youtu.be, de Shorts o de directo. Una ejecución devuelve la lista completa de recomendaciones, normalmente unos 20 videos, con cobro por video, así que una llamada típica cuesta unos 10 créditos ($0.05). Ejecútelo sobre sus propios videos o los de un competidor para ver qué videos y canales considera YouTube como sus vecinos. (documentación)

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"}'

Guías relacionadas de YouTube

Para comparar SocQ con otros proveedores de datos de YouTube, consulte Las 19 mejores alternativas a la API de YouTube. El mismo flujo de descubrimiento y contacto para TikTok, incluidos los países de los seguidores y la detección de vistas falsas, está en la guía de los nuevos endpoints de TikTok.

Preguntas frecuentes

¿Pago por los canales sin correo público?

No. Un canal sin correo público devuelve un resultado vacío, que es gratuito. Un canal con al menos un correo cuesta 15 créditos, sin importar cuántas direcciones publique.

Cada ejecución toma una muestra de lo que es tendencia en ese momento, así que las ejecuciones con pocos minutos de diferencia solo comparten unos cuantos Shorts. Programe varias ejecuciones si quiere una cobertura más amplia.

¿Qué URLs de publicaciones de comunidad se aceptan?

https://www.youtube.com/post/{post_id}, o un enlace a la pestaña Publicaciones del canal que incluya ?lb={post_id}.

¿Shorts Search devuelve me gusta y comentarios?

No. Los resultados de búsqueda incluyen el enlace, el texto, el número de vistas y la miniatura. Pase los enlaces a YouTube Videos para obtener me gusta, comentarios y detalles del canal.

¿Cómo se cobra Search Suggestions?

0.5 créditos por llamada, sin importar cuántas sugerencias devuelva.

YOUTUBE API

Probar el flujo de trabajo con una URL pública de YouTube

Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.

Ver las API de YouTube