Los AI Overviews de Google ya están disponibles

Envía una búsqueda y recibe el AI Overview de Google con sus páginas citadas, junto con los resultados orgánicos, las preguntas relacionadas y las búsquedas relacionadas de la misma página.

Qué obtienes

• aioverview.text y aioverview.sources: el AI Overview y las páginas que cita.
• organicResults: los resultados normales de la misma página, con posición, título, enlace y fragmento.
• peopleAlsoAsk, relatedSearches, knowledgeGraph y ads cuando Google los muestra.

Cómo funciona

Cada tarea busca tu consulta en Google desde el país que indiques y lee la página de resultados completa. Google decide en cada búsqueda si muestra un AI Overview, y cada resultado completado registra si apareció: llega en aioverview, que vale null en una página con solo resultados orgánicos.

Ese registro se convierte en una métrica. En un conjunto de palabras clave, la proporción de búsquedas con AI Overview es tu cobertura, y los propios overviews muestran qué marcas y páginas pone Google por delante.

Para qué sirve

• Mide cuántas de tus palabras clave activan un AI Overview, mercado por mercado.
• Comprueba si tus páginas aparecen citadas en el overview o en los resultados orgánicos de debajo.
• Extrae nuevos prompts para seguir de las preguntas y búsquedas relacionadas.

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 wireless earbuds for commuting",
      "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.

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.

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": "310ab45d-209e-4a15-8379-9379ab041d48",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:53:21.022Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Anker Soundcore Space A40 is the best wireless earbud for commuting due to its strong adaptive noise cancellation, long battery life, and compact value.",
      "sources": [
        {
          "position": 1,
          "url": "https://www.soundcore.com/products/space-a40-a3936011",
          "label": "Anker Soundcore Space A40"
        },
        {
          "position": 2,
          "url": "https://www.techtimes.com/articles/313618/20260101/best-wireless-bluetooth-earbuds-under-100-are-they-really-worth-price.htm",
          "label": "Tech Times"
        }
      ],
      "shoppingCards": [
        {
          "position": 1,
          "title": "Anker Soundcore Space A40",
          "price": { "raw": "$54.99", "value": 54.99, "currency": "$" },
          "store": "soundcore US",
          "rating": 4.4,
          "reviews": "1.2K"
        }
      ]
    },
    "organicResults": [
      {
        "position": 1,
        "title": "Highest Rated Wireless Earbuds",
        "link": "https://www.amazon.com/Highest-Rated-Wireless-Earbuds/s?k=Highest+Rated+Wireless+Earbuds",
        "snippet": "Soundcore by Anker P20i True Wireless Earbuds, 10mm Drivers with Big Bass, Bluetooth 5.3, 30H Long Playtime, Water-Resistant, 2 Mics for AI Clear Calls, ..."
      }
    ],
    "peopleAlsoAsk": [
      { "question": "What are the best wireless earbuds for office work?" }
    ],
    "relatedSearches": [
      { "query": "Best wireless earbuds for commuting reddit" },
      { "query": "Best wireless earbuds for commuting iphone" }
    ]
  }
}

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

Fichas de producto de la overview: nombre, precio, tienda, valoración, reseñas y enlace.

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.

response.relatedSearchesarray

Las búsquedas relacionadas al pie de la página.

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 2 créditos.