Saltar al contenido
NovedadesNuevo

Social: lee YouTube, Instagram y Threads a través de la API

Social
Una solicitud SOCIAL en POST /v1/async/task para la búsqueda de YouTube wireless earbuds review y el primer vídeo de la respuesta con su canal, 62.618 visualizaciones y 957 me gusta

Busca en YouTube, Instagram y Threads y recibe vídeos, publicaciones, comentarios, perfiles y subtítulos de YouTube en JSON desde cualquier clave de API, por 0,5 créditos por solicitud completada.

Qué obtienes

  • platform youtube: resultados de búsqueda, las subidas más recientes de una búsqueda, la página de un vídeo, comentarios con sus respuestas, un canal, los vídeos, Shorts o directos de un canal, y subtítulos.
  • platform instagram: publicaciones y reels de una palabra clave, un perfil público con sus 12 publicaciones más recientes, una publicación o reel y sus comentarios.
  • platform threads: publicaciones de una palabra clave, un perfil público con sus publicaciones recientes, una publicación y sus respuestas.
  • Las cifras llegan como números, como viewCount, likeCount, commentCount y followerCount, con la hora publishedAt, así comparas publicaciones sin interpretar textos como 62K.

Cómo funciona

Envía taskType SOCIAL a POST /v1/async/task con una platform y una action. search, la acción por defecto, recibe query. Las demás acciones reciben videoId, channel, username o postUrl, y ahí puedes pegar la URL de la página.

Social lee páginas públicas. En Instagram son las 12 publicaciones más recientes de un perfil y una docena de comentarios por publicación, y en Threads unas 10 respuestas por publicación. Una página que no existe o que requiere iniciar sesión termina la tarea con PAGE_UNAVAILABLE.

Una búsqueda de vídeos de YouTube ordenada por relevance devuelve nextPageToken para la página siguiente. transcript devuelve el text de los subtítulos y segments con tiempos en los idiomas que indiques, y translateTo pide a YouTube que los traduzca. La herramienta read_social del servidor MCP de querying.ai ejecuta las mismas lecturas desde Claude Code, Codex, Cursor y otros clientes MCP.

Para qué sirve

  • Sigue día a día las visualizaciones, los me gusta y los comentarios de los vídeos de tu marca y de tus competidores.
  • Lee los comentarios y las respuestas a un lanzamiento en YouTube, Instagram y Threads, y anota lo que pregunta la gente.
  • Pasa a tu modelo la transcripción de un vídeo de reseña con sus marcas de tiempo y encuentra dónde nombra tu producto.
  • Pon lo que dicen los creadores en YouTube y Threads junto a lo que responden ChatGPT y Google AI Mode a la misma búsqueda.

Envía la solicitud

Envía la solicitud con tu clave de API en la cabecera Authorization.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "SOCIAL",
    "payload": {
      "platform": "youtube",
      "action": "search",
      "query": "wireless earbuds review",
      "limit": 10
    }
  }'

Campos de la solicitud

taskTypestringObligatorio
El motor que se ejecuta, como CHATGPT o GOOGLE.
payload.platformstringObligatorio
La plataforma que se lee: youtube, instagram o threads.
payload.actionstring
Qué se lee, como search, video, comments o transcript. Por defecto, search. Cada plataforma lista sus acciones en la documentación.
payload.querystring
La búsqueda para search y recent, escrita como la teclea un usuario en el buscador de la plataforma.
payload.limitinteger
Resultados que se devuelven. Una búsqueda en YouTube admite de 1 a 50; por defecto, 10.
webhook.urlstring
Una dirección HTTPS de tu servidor. La tarea terminada se envía allí en cuanto se completa.

Respuesta

Así llega una tarea terminada, recortada para que se lea mejor.

JSON
{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "SOCIAL",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": 0.5, "creditsCharged": 0.5 },
  "response": {
    "platform": "youtube",
    "action": "search",
    "query": "wireless earbuds review",
    "order": "relevance",
    "returnedCount": 10,
    "videos": [
      {
        "position": 1,
        "videoId": "YdJh6QdOGME",
        "url": "https://www.youtube.com/watch?v=YdJh6QdOGME",
        "title": "Earbuds Awards 2026 - Best Bluetooth Earbuds by Category!",
        "channelTitle": "Mike O'Brien",
        "channelHandle": "@MikeOBrienMedia",
        "publishedAt": "2026-11-17T15:39:37Z",
        "durationSeconds": 995,
        "viewCount": 62618,
        "likeCount": 957
      },
      "…"
    ],
    "nextPageToken": "eyJyIjpbIllkSmg2UWRPR01FIl19"
  }
}
task.statusstring
QUEUED, PROCESSING y al final COMPLETED con la respuesta o FAILED con error.
credits.creditsChargedinteger
Créditos cobrados por la tarea terminada. Una tarea fallida cobra 0.
response.returnedCountinteger
El número de productos en products.
response.videosarray
Los vídeos en el orden de YouTube: position, videoId, url, title, el canal, publishedAt, durationSeconds, viewCount y likeCount.

Recibe el resultado

La solicitud devuelve la tarea al instante con status QUEUED. Consulta GET /v1/async/task/{id} hasta que status sea COMPLETED o FAILED, o añade webhook.url y la tarea terminada llega a tu servidor con los mismos task, credits y response. Los resultados siguen disponibles 24 horas después de terminar la tarea.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

Precio

Cada solicitud completada usa 0,5 créditos, en todas las plataformas y acciones. Solo se cobran las solicitudes completadas. Planes y créditos: https://querying.ai/pricing

Más novedades

Recibe las novedades

Recibe las actualizaciones por correo.

Feed RSS