> ## 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 da Busca do Google (GOOGLE_SERP)

> Receba uma página de resultados orgânicos, anúncios e painéis da SERP do google.com para uma consulta, sem esperar por um AI Overview.

`GOOGLE_SERP` carrega uma página de resultados do google.com e retorna seus resultados orgânicos e painéis. Como não espera por um AI Overview, responde mais rápido que o [`GOOGLE`](/pt/engines/google-ai-overviews) e custa menos. Use-o para acompanhar posições ou para encontrar páginas para ler com o [`WEB_SCRAPE`](/pt/engines/web-scrape).

| | |
| - | - |
| `taskType` | `GOOGLE_SERP` |
| Entrada | `query` (obrigatório); `page`, `country`, `location`, `include` |
| Créditos | 1 por tarefa |
| País | Padrão `US`. Qualquer código ISO 3166-1 alfa-2. |
| Localização | Suportada. Veja [Regiões e localização](/pt/engines/capacity.md). |

## Requisição

```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 } }'
```

A tarefa roda de forma assíncrona. Leia o resultado como descrito em [Tarefas assíncronas](/pt/concepts/async-tasks.md).

## Parâmetros

| Campo | Obrigatório | Descrição |
| - | - | - |
| `query` | Sim | A consulta de busca, de 1 a 100.000 caracteres. `prompt` é aceito quando `query` está ausente. |
| `page` | Não | Página de resultados, um inteiro de 1 a 10. Padrão `1`. Cada página tem dez resultados orgânicos. Outros valores retornam `422 VALIDATION_ERROR`. |
| `country` | Não | O mercado do Google a buscar. Padrão `US`. |
| `location` | Não | `{ "latitude", "longitude" }` em graus decimais. O Google responde como a um usuário naquele ponto, e o resultado o devolve como `location`. |
| `include.rawResponse` | Não | `true` adiciona o HTML da página de resultados como `rawContent`. A página é grande, muitas vezes perto de um megabyte. |

## Resposta

Por exemplo, a página 2 de uma consulta:

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

| Campo | Descrição |
| - | - |
| `organicResults` | Sempre presente. `position` conta através das páginas, então o primeiro resultado da página 2 é `11`. Cada linha traz a `page` de onde veio. |
| `page` | A página carregada. |
| `peopleAlsoAsk`, `relatedSearches`, `knowledgeGraph` | Os painéis do Google, quando a página os mostra. |
| `ads` | Anúncios do topo e do rodapé, quando a página os mostra. |
| `map` | O pacote local: lugares com `name`, `position`, `placeId`, `location`, `mapsUrl`, `reviews` e mais, quando a página mostra um. |
| `serp` | Outros painéis, quando presentes: `topStories`, `videoResults`, `localMap`, `discussionsAndForums`. |
| `location` | O ponto que você enviou, quando enviou um. |
| `rawContent` | O HTML da página de resultados, com `include.rawResponse: true`. |

Os painéis que a página não mostra são omitidos, em vez de vir como `null` ou `[]`. Trate todo campo, exceto `organicResults` e `page`, como opcional. Não há `aioverview`, `text` nem `sources`; use o [`GOOGLE`](/pt/engines/google-ai-overviews) para o AI Overview.

## Limites e erros

* Um `organicResults` vazio em uma tarefa concluída significa que o próprio Google não retornou resultados para a consulta. Isso é confirmado em um segundo navegador antes de ser retornado.
* `page` fora de 1-10 retorna `422 VALIDATION_ERROR`.
* Uma `location` malformada retorna `400 VALIDATION_ERROR`.
* Os demais erros de requisição estão em [Erros](/pt/concepts/errors.md).

## Relacionados

* [Google AI Overviews](/pt/engines/google-ai-overviews.md) para a mesma página com o AI Overview
* [Web scrape](/pt/engines/web-scrape.md) para ler a página de um resultado em Markdown
* [Regiões e localização](/pt/engines/capacity.md)


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