Recibe los AI Overviews de Google en Markdown

Lee AI Overviews en aioverview.markdown con los títulos, listas y tablas que organiza Google.

Qué cambia

• aioverview.markdown: el AI Overview en Markdown, con sus títulos, listas, tablas y negritas en su sitio.
• aioverview.text sigue igual y trae las mismas palabras, así que el código que lee el texto plano sigue funcionando.
• Las respuestas de Google AI Mode traen el mismo Markdown en markdown en cada resultado.

Cómo funciona

Google organiza un AI Overview con títulos, pasos numerados, listas y tablas comparativas. aioverview.text guarda las palabras, y aioverview.markdown conserva también la estructura, así que muestras el resumen tal como lo ven quienes buscan o lees su estructura en código. Las páginas citadas siguen en aioverview.sources.

Actívalo con include.aioverview.markdown: true. La opción común include.markdown: true, que ya leen otros motores, también lo activa.

Para qué sirve

• Muestra los AI Overviews en tus paneles e informes con su formato original.
• Descubre qué marcas incluye Google en los pasos, tablas y comparaciones de un resumen.
• Divide un resumen en sus secciones para ver qué temas trata Google primero.

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",
    "payload": {
      "query": "best robot vacuum for pet hair",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

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.include.markdownboolean

Con true se añade aioverview.markdown: la vista general con sus títulos, listas y tablas, tal como la muestra Google.

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.

{
  "success": true,
  "task": {
    "id": "8dcde5b1-2f53-40b3-b048-05075b03c4a9",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T17:16:57.237Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.",
      "markdown": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.\n\n### Top Robot Vacuums for Pet Hair\n\n**Roborock Saros Z70**\n\nNamed a top overall pick by experts for its strong hard-floor pickup, smart obstacle recognition, and self-emptying dock. It costs around $1,000.\n\n**MOVA V50**\n\nPraised as a top performer in dog hair tests and obstacle avoidance. It features a dual brush roller and app controls for auto-emptying frequency, usually priced under $700.\n\n…",
      "sources": [
        {
          "position": 2,
          "url": "https://www.rtings.com/robot-vacuum/reviews/best/pet-hair",
          "label": "RTINGS.com"
        },
        {
          "position": 3,
          "url": "https://www.forbes.com/sites/forbes-personal-shopper/article/best-robot-vacuum-for-pet-hair/",
          "label": "Forbes Vetted"
        }
      ]
    }
  }
}

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

La AI Overview con su text, sus sources y, si lo pides, markdown. null marca una búsqueda que Google responde únicamente con resultados.

response.aioverview.markdownstring

La overview en Markdown, con la estructura que muestra Google: títulos ###, listas, tablas y negritas.

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

El precio sigue en 2 créditos por tarea completada, con el Markdown incluido.