API de Google AI Overviews: texto del resumen, fuentes y SERP

GOOGLE busca en google.com y devuelve el AI Overview junto con la página de resultados de búsqueda en la que aparece.


taskType	`GOOGLE`
Alias	`GOOGLE_AIO`
Lee	`query` (recurre a `prompt`)
Créditos	1,25
País	Opcional, por defecto `US`. `CN` pregunta al mercado de EE. UU. de Google desde un dispositivo en Pekín.
Ubicación	Acepta `payload.location`. Consulta Regiones y ubicación.

Solicitud

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 CRM for a small team", "country": "US" } }'

Respuesta

La respuesta es un sobre de resultados de búsqueda que incluye el AI Overview como un miembro anulable, aioverview.

aioverview: null significa que Google no mostró un AI Overview para la consulta. No es un error: la tarea se completa y los campos de resultados de alrededor siguen rellenados.

Campo	Tipo	Descripción
`aioverview`	object o `null`	El AI Overview. Campos más abajo.
`organicResults`	array	Resultados orgánicos.
`peopleAlsoAsk`	array	El panel “Otras preguntas de los usuarios”.
`relatedSearches`	array	Búsquedas relacionadas.
`knowledgeGraph`	object	El panel de conocimiento.
`ads`	array	Anuncios superiores e inferiores.
`map`	array	El paquete local: `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews`, `category`, `price`, `snippet`, `image`.
`serp`	object	Otros paneles: `topStories`, `videoResults`, `localMap`, `discussionsAndForums`.
`rawContent`	string	El HTML renderizado de la página de resultados. Solo con `include.rawResponse`.
`text`, `sources`		Copias obsoletas de `aioverview.text` y `aioverview.sources`. En código nuevo lee `aioverview.*`.

Los paneles de resultados se omiten cuando la página no los tiene; nunca se envían como null ni []. Trata cada uno como opcional.

`aioverview`

Campo	Tipo	Descripción
`text`	string	El texto del resumen. Conserva los títulos de las tarjetas de producto.
`sources`	array	`position`, `url`, `label` y `description`.
`markdown`	string	El resumen en Markdown. Solo con `include.markdown` o `include.aioverview.markdown`.
`shoppingCards`	array	Fichas de producto junto a la respuesta: `title`, `position`, `price`, `oldPrice`, `store`, `rating`, `reviews`, `thumbnail`, `productLink`.
`inlineProducts`	array	Nombres de producto enlazados en la respuesta: `title`, `position`, `productLink`.
`citationPills`	array	Una entrada por cada fuente detrás de cada chip de cita.
`videos`	array	Vídeos que muestra el resumen: `title`, `link`, `platform`, `channel`, `duration`.
`sponsored`	array	Elementos patrocinados dentro del resumen: `label`, `title`, `advertiser`.

Los campos de productos, chips, vídeos y patrocinados solo aparecen cuando el resumen los muestra. price.currency es el símbolo tal como se muestra ($, €), reviews conserva la abreviatura de Google (2.3K) y productLink es la página de producto de Google. En citationPills, las fuentes del mismo chip comparten un citationPillId, numerado en el orden de la respuesta, y position apunta a la entrada correspondiente de aioverview.sources. Una página que solo cita un chip también está en aioverview.sources, después de las páginas que lista la vista general, y su label queda vacío cuando Google no muestra un título. Cada entrada tiene label, url, domain y, cuando Google los muestra, site, description y thumbnail. Cuando la respuesta incluye markdown, markdownOffset da la posición del chip en él; las entradas de sponsored llevan labelOffset, markdownOffset y noteOffset de la misma forma. Por ejemplo:

{
  "aioverview": {
    "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
    "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }],
    "citationPills": [
      { "label": "CRM guide for small teams", "citationPillId": 1, "url": "https://www.example.com/crm-guide", "domain": "example.com", "position": 1 }
    ]
  },
  "organicResults": [
    { "position": 1, "title": "The best CRM for small teams", "link": "https://www.example.com/crm-guide", "snippet": "..." }
  ],
  "relatedSearches": [{ "query": "free crm for small team" }],
  "text": "Popular CRMs for small teams include HubSpot CRM and Pipedrive ...",
  "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide" }]
}

Flags include

Flag	Efecto
`markdown`	Añade `aioverview.markdown`. `include.aioverview.markdown` hace lo mismo.
`rawResponse`	Añade `rawContent`, la página de resultados renderizada.
`html`	Añade `html`, la página de resultados como un archivo que puedes compartir. Consulta Páginas HTML.
`analysis`	Añade `analysis`, 1 crédito. Consulta Análisis de la respuesta.
`citationAnalysis`	Ejecuta un Citation Analysis sobre el resumen.

searchQueries, ads y shopping no tienen efecto. Consulta Respuestas en Markdown y en bruto. Para obtener los resultados orgánicos sin el resumen, más rápido y por 1 crédito, usa Google Search.

China

Google no muestra AI Overview al mercado de China. Por eso, una tarea CN pregunta al mercado de EE. UU. de Google (gl=us) desde un dispositivo ubicado en Pekín, como acceden a Google las personas en China continental. Una tarea con su propia payload.location usa esa ubicación en su lugar.

Primeros pasos

Conceptos clave

Motores de respuesta

Búsqueda y datos web

Opciones de solicitud

Investigación

Monitorización GEO

Cuenta y datos

API de Google AI Overviews: texto del resumen, fuentes y SERP

Solicitud

Respuesta

`aioverview`

Flags include

China

Relacionado

​Solicitud

​Respuesta

​aioverview

​Flags include

​China

​Relacionado

Solicitud

Respuesta

`aioverview`

Flags include

China

Relacionado