Los resultados de búsqueda y Reddit llegan a la API

Recibe en JSON los resultados de búsqueda de Google, Bing y Naver y las conversaciones de Reddit, con la misma API que usas para las respuestas de IA.

Qué obtienes

• GOOGLE_SERP: resultados orgánicos con posición, título, enlace y fragmento, más preguntas relacionadas, búsquedas relacionadas y anuncios. Indica page del 1 al 10 para páginas más profundas.
• BING_SEARCH: los resultados de Bing con el resumen de IA que Bing escribe encima, en aioverview con sus fuentes.
• NAVER_SERP: los documentos web de Naver, 15 por página, con page del 1 al 10.
• REDDIT: una búsqueda de publicaciones, una publicación con sus comentarios o las publicaciones más recientes de un subreddit.

Cómo funciona

Los motores de IA construyen sus respuestas a partir de la web, así que las páginas que se posicionan en búsqueda y los hilos que la gente escribe en Reddit son la materia prima de la visibilidad en IA. Estos motores llevan esos datos al flujo que ya usas: la misma solicitud, el mismo webhook y el mismo formato JSON.

Las posiciones se cuentan a lo largo de las páginas, así que el primer resultado de Google en la página 2 tiene la posición 11. Cada tarea lee los resultados en vivo en el momento de la recogida.

Para qué sirve

• Compara quién se posiciona en búsqueda con quién aparece citado en las respuestas de IA para la misma consulta.
• Sigue los hilos de Reddit que forman la opinión en tu categoría.

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": "GOOGLE_SERP",
    "payload": {
      "query": "best project management software for small teams",
      "country": "US"
    }
  }'

Envía BING_SEARCH y NAVER_SERP de la misma forma, con query en el payload.

Campos de la solicitud

taskTypestringObligatorio

El motor que se ejecuta, como CHATGPT o GOOGLE.

payload.querystringObligatorio

La búsqueda, escrita como la teclea un usuario en el buscador.

payload.countrystring

Código de país de dos letras del mercado desde el que se pregunta, como US, KR o JP. Por defecto US.

payload.pageinteger

Página de resultados que se lee, de 1 a 10. Por defecto 1. position sigue contando entre páginas.

webhook.urlstring

Una dirección HTTPS de tu servidor. La tarea terminada se envía allí en cuanto se completa.

idempotencyKeystring

Tu propio ID para la solicitud. Cada clave crea una sola tarea por cuenta, así que un reenvío sigue siendo una sola tarea.

Respuesta

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

{
  "success": true,
  "task": {
    "id": "323287e6-d4ef-4797-a337-f6c3b574b7ab",
    "taskType": "GOOGLE_SERP",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:45:07.237Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "page": 1,
    "organicResults": [
      {
        "position": 1,
        "title": "8 Easy-to-Use Project Management Software Platforms for ...",
        "link": "https://ones.com/blog/8-easy-to-use-project-management-software-platforms-for-small-teams/?primary_category=knowledge",
        "snippet": "1 day ago — ONES.com came out on top for teams that need Jira-like power without the complexity, while Trello and Asana hold their ground for basic, visual ...",
        "page": 1
      }
    ],
    "peopleAlsoAsk": [
      { "question": "Does Microsoft Teams have a project management tool?" },
      {
        "question": "What is the best project management software for a small construction company?"
      }
    ]
  }
}

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.organicResultsarray

Los resultados de búsqueda de la página: position, title, link, snippet y page.

response.peopleAlsoAskarray

Las preguntas relacionadas que Google muestra en la página.

Busca en Reddit

Envía REDDIT con un query para buscar publicaciones, añade subreddit para quedarte en una comunidad, o envía la url de una publicación para leerla con su primera página de comentarios.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "REDDIT",
    "payload": {
      "query": "best mechanical keyboard for programming",
      "country": "US"
    }
  }'

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

{
  "success": true,
  "task": {
    "id": "fe0a46a2-7bf1-4cd0-8183-d299dc421c70",
    "taskType": "REDDIT",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:47:44.384Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "results": [
      {
        "url": "https://www.reddit.com/r/MechanicalKeyboardsUK/comments/1qz6da6/best_silent_mechanical_keyboard_for_programming/",
        "title": "Best silent mechanical keyboard for programming?",
        "postId": "1qz6da6",
        "preview": "I currently have a mechanical keyboard but I often wake up in the middle of the night and it is quite loud so I can't use my computer because …",
        "subreddit": "MechanicalKeyboardsUK"
      }
    ]
  }
}

payload.subredditstring

Busca dentro de un subreddit; indica el nombre que va después de r/.

payload.urlstring

La dirección de un post, https://www.reddit.com/r/{subreddit}/comments/{postId}/…. Lee el post con su primera página de comentarios.

payload.commentSortstring

Orden de los comentarios: top (por defecto), new, controversial, old o qa.

response.resultsarray

Los posts que coinciden con la búsqueda: postId, title, url, subreddit y preview.

response.postobject

Con la url de un post: título, cuerpo, autor, puntuación y número de comentarios.

response.commentsobject

La primera página de comentarios, unos 20 a 25, con autor, cuerpo, puntuación y profundidad.

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 tarea completada usa 1 crédito.