> ## 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 resultados de búsqueda de Google (GOOGLE_SERP)

> Obtén una página de resultados orgánicos, anuncios y paneles SERP de google.com para una consulta, sin esperar a un AI Overview.

`GOOGLE_SERP` carga una página de resultados de google.com y devuelve sus resultados orgánicos y paneles. No espera a un AI Overview, así que responde más rápido que [`GOOGLE`](/es/engines/google-ai-overviews) y cuesta menos. Úsalo para seguir posiciones o para encontrar páginas que leer con [`WEB_SCRAPE`](/es/engines/web-scrape).

| | |
| - | - |
| `taskType` | `GOOGLE_SERP` |
| Entrada | `query` (obligatorio); `page`, `country`, `location`, `include` |
| Créditos | 1 por tarea |
| País | `US` por defecto. Cualquier código ISO 3166-1 alfa-2. |
| Ubicación | Admitida. 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_SERP", "payload": { "query": "best running shoes for flat feet", "country": "US", "page": 2 } }'
```

La tarea se ejecuta de forma asíncrona. Lee el resultado como se describe en [Tareas asíncronas](/es/concepts/async-tasks.md).

## Parámetros

| Campo | Obligatorio | Descripción |
| - | - | - |
| `query` | Sí | La consulta de búsqueda, de 1 a 100.000 caracteres. Se acepta `prompt` si falta `query`. |
| `page` | No | Página de resultados, un entero de 1 a 10. `1` por defecto. Cada página contiene diez resultados orgánicos. Otros valores devuelven `422 VALIDATION_ERROR`. |
| `country` | No | El mercado de Google en el que buscar. `US` por defecto. |
| `location` | No | `{ "latitude", "longitude" }` en grados decimales. Google responde como a un usuario situado en ese punto, y el resultado lo devuelve como `location`. |
| `include.rawResponse` | No | `true` añade el HTML de la página de resultados como `rawContent`. La página es grande, a menudo cerca de un megabyte. |

## Respuesta

Por ejemplo, la página 2 de una consulta:

```json theme={"theme":"css-variables"}
{
  "organicResults": [
    { "position": 11, "title": "...", "link": "https://...", "displayedLink": "...", "snippet": "...", "page": 2 }
  ],
  "peopleAlsoAsk": [{ "...": "..." }],
  "relatedSearches": [{ "...": "..." }],
  "ads": [{ "...": "..." }],
  "page": 2
}
```

| Campo | Descripción |
| - | - |
| `organicResults` | Siempre presente. `position` cuenta a través de las páginas, así que el primer resultado de la página 2 es `11`. Cada fila lleva la `page` de la que procede. |
| `page` | La página que se cargó. |
| `peopleAlsoAsk`, `relatedSearches`, `knowledgeGraph` | Los paneles de Google, cuando la página los muestra. |
| `ads` | Anuncios superiores e inferiores, cuando la página los muestra. |
| `map` | El paquete local: lugares con `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews` y más, cuando la página muestra uno. |
| `serp` | Otros paneles si existen: `topStories`, `videoResults`, `localMap`, `discussionsAndForums`. |
| `location` | El punto que enviaste, si enviaste uno. |
| `rawContent` | El HTML de la página de resultados, con `include.rawResponse: true`. |

Los paneles que la página no muestra se omiten, en lugar de devolverse como `null` o `[]`. Trata todos los campos salvo `organicResults` y `page` como opcionales. No hay `aioverview`, `text` ni `sources`; usa [`GOOGLE`](/es/engines/google-ai-overviews) para obtener el AI Overview.

## Límites y errores

* Un `organicResults` vacío en una tarea completada significa que el propio Google no devolvió resultados para la consulta. Se confirma en un segundo navegador antes de devolverlo.
* Un `page` fuera de 1-10 devuelve `422 VALIDATION_ERROR`.
* Un `location` mal formado devuelve `400 VALIDATION_ERROR`.
* Los demás errores de solicitud se enumeran en [Errores](/es/concepts/errors.md).

## Relacionado

* [Google AI Overviews](/es/engines/google-ai-overviews.md) para la misma página con su AI Overview
* [Web scrape](/es/engines/web-scrape.md) para leer la página de un resultado en Markdown
* [Regiones y ubicación](/es/engines/capacity.md)


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