Recibe las respuestas conversacionales de Google AI Mode

Pregunta a Google AI Mode desde el mercado que elijas y recibe su respuesta conversacional con las páginas que cita.

Qué obtienes

• text: la respuesta completa de AI Mode, por lo general más larga y detallada que un AI Overview.
• sources: las páginas que cita la respuesta, con URL y título.
• Un tipo de tarea propio, AIMODE, para medir AI Mode y los AI Overviews como superficies separadas.

Cómo funciona

AI Mode es la búsqueda conversacional de Google: una pregunta recibe una respuesta escrita completa con enlaces a las páginas en las que se basa. Cada tarea hace tu consulta en AI Mode desde el país que indiques y devuelve la respuesta y sus fuentes tal como las ve la gente de ese mercado.

AI Mode responde a fondo las preguntas de comparación y recomendación y nombra las marcas que recomienda. Síguelo junto a los AI Overviews para ver cómo se comporta la misma consulta en ambas superficies.

Para qué sirve

• Sigue las consultas de recomendación y comparación en las que AI Mode nombra marcas.
• Compara las páginas que cita AI Mode con las de los AI Overviews para la misma consulta.

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

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.

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": "937d9eb6-4b33-49fd-b164-df8e2911b964",
    "taskType": "AIMODE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T17:16:57.384Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "markdown": "The **Dreame X50 Ultra** is the overall **best robot vacuum for pet hair**, offering a massive **20,000Pa of suction** and an anti-tangle dual-brush system specifically designed to prevent pet hair wrap.\n\nWhen shopping for a pet hair-focused robot vacuum, comparing suction power, brush design, and price helps identify the right model for your home and budget.\n\n| Model | Key Pet Hair Features | Approx. Price | Best For |\n| --- | --- | --- | --- |\n| **Dreame X50 Ultra** | 20,000Pa suction, Detangling DuoBrush | ~$900 | Heavy shedding & thick carpets |\n| **Roborock Saros Z70** | 5-axis mechanical arm, ultra-thin 7.98 cm body | ~$1,000 | Moving pet toys & low furniture |\n…",
    "shoppingCards": [
      {
        "position": 1,
        "title": "Dreame X50 Ultra",
        "price": { "raw": "$899.99", "value": 899.99, "currency": "$" },
        "store": "Dreametech",
        "rating": 4.5,
        "reviews": "538"
      }
    ],
    "inlineProducts": [
      {
        "position": 1,
        "title": "Dreame X50 Ultra",
        "productLink": "https://www.google.com/search?ibp=oshop&prds=pvt:hg,…"
      }
    ]
  }
}

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

La respuesta en texto plano.

response.markdownstring

La respuesta con sus títulos, listas y tablas, en cada resultado.

response.sourcesarray

Las páginas que cita la respuesta, en el orden del motor, con position, url y label.

response.shoppingCardsarray

Fichas de producto que acompañan la respuesta: nombre, precio, tienda, valoración y enlace.

response.inlineProductsarray

Nombres de producto enlazados dentro de las frases de la respuesta, con position y productLink.

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 de AI Mode completada usa 2 créditos.