API de resultados da Busca do Google (GOOGLE_SERP) - querying.ai

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 e custa menos. Use-o para acompanhar posições ou para encontrar páginas para ler com o 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.

Requisição

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.

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:

{
  "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 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.

Relacionados

Google AI Overviews para a mesma página com o AI Overview
Web scrape para ler a página de um resultado em Markdown
Regiões e localização