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.
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.
JSON
{
"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 statusQUEUED. 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.
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.
Dale a tu agente búsqueda web en una sola llamada: cada resultado llega con los pasajes de su página que responden a la consulta, por 0,5 créditos la búsqueda.