> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Busca en Google y obtén el AI Overview con sus fuentes, productos y chips de cita, además de la página de resultados que lo rodea.

`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](/es/engines/capacity.md). |

## Solicitud

```bash theme={"theme":"css-variables"}
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`.

> [!WARNING]
>
> `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:

```json theme={"theme":"css-variables"}
{
  "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](/es/engines/html-pages.md). |
| `analysis` | Añade `analysis`, 1 crédito. Consulta [Análisis de la respuesta](/es/engines/answer-analysis.md). |
| `citationAnalysis` | Ejecuta un [Citation Analysis](/es/research/citation-analysis.md) sobre el resumen. |

`searchQueries`, `ads` y `shopping` no tienen efecto. Consulta [Respuestas en Markdown y en bruto](/es/engines/response-options.md). Para obtener los resultados orgánicos sin el resumen, más rápido y por 1 crédito, usa [Google Search](/es/engines/google-serp.md).

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

## Relacionado

* [Página de producto de Google AI Overviews](https://querying.ai/es/engines/google-ai-overviews)
* [Google AI Mode](/es/engines/google-ai-mode.md)
* [Resumen de motores](/es/engines/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.