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 eltask_iddevuelto, consulteGET /v1/tasks/{task_id}hasta questatusseasucceededy luego leadata.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.
| Endpoint | Qué devuelve | Precio |
|---|---|---|
| YouTube Trending Shorts API | Una muestra reciente de Shorts en tendencia con canal, vistas, me gusta, comentarios, duración y fecha de publicación | 0.5 créditos ($0.0025) por Short |
| YouTube Shorts Search API | Shorts para una palabra clave con enlace, texto, vistas y miniatura vertical | 0.6 créditos ($0.003) por Short |
| YouTube Channel Search API | Canales para una palabra clave con ID, nombre, suscriptores, avatar y fragmento de la descripción | 0.6 créditos ($0.003) por canal |
| YouTube Search Suggestions API | Sugerencias de autocompletado ordenadas para una consulta parcial, por idioma y región | 0.5 créditos ($0.0025) por llamada |
| YouTube Community Post API | Una publicación de comunidad: texto completo, todas las imágenes, me gusta y canal | 0.5 créditos ($0.0025) por llamada |
| YouTube Community Post Comments API | Comentarios de una publicación de comunidad con autor, me gusta y número de respuestas | 0.3 créditos ($0.0015) por comentario |
| YouTube Related Videos API | Los videos que YouTube recomienda junto a un video | 0.5 créditos ($0.0025) por video |
| YouTube Email Finder API | Correos comerciales públicos de un canal y las páginas donde se encontraron | 15 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.
¿Por qué dos ejecuciones de Trending Shorts devuelven Shorts distintos?
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