# AI Overviews O `google_search` e `google_ads` as fontes podem retornar AI Overviews dos resultados do Google Search em todas as regiões globais suportadas. `ai_overviews` array de resultados suporta vários blocos de IA em uma única resposta, incluindo seções como “As pessoas também perguntam” e “Coisas que você precisa saber.” Para maximizar a chance de receber conteúdo de AI Overviews totalmente renderizado, você deve incluir os seguintes parâmetros: | Parâmetro | Valor | | ----------------- | ------------------------------- | | `source` | `google_search` ou `google_ads` | | `render` | `html` | | `user_agent_type` | `desktop` ou `mobile` | Usar esses parâmetros também permite receber tanto a resposta geral quanto o conteúdo de AI Overviews em uma única solicitação. {% hint style="danger" %} O Google gera esse conteúdo dinamicamente ou carrega uma versão em cache, então as respostas geradas por IA podem variar ao longo do tempo, mesmo com parâmetros idênticos. {% endhint %} {% hint style="success" %} Explorar[ **dicionário de dados**](#data-dictionary) para alguns dos recursos SERP de AI Overviews. {% endhint %} ## Disponibilidade regional de AI Overviews O Google AI Overviews está disponível na maioria dos países, com algumas exceções. Atualmente, os maiores países excluídos são: * França * Mônaco * China * Irã * Sudão * Síria * Cuba * Coreia do Norte {% hint style="warning" %} O recurso Google AI Overviews está sendo lançado continuamente, com mais países incluídos ao longo do tempo. {% endhint %} ## Exemplos de solicitação {% tabs %} {% tab title="cURL" %} ```shell curl 'https://realtime.oxylabs.io/v1/queries' \ --user 'USERNAME:PASSWORD' \ -H 'Content-Type: application/json' \ -d '{ "source": "google_search", "query": "how to sell on amazon", "render": "html", "user_agent_type": "desktop", "parse": true }' ``` {% endtab %} {% tab title="Python" %} ```python import requests from pprint import pprint # Updated payload. payload = { 'source': 'google_search', 'query': 'how to sell on amazon', 'render': 'html', 'user_agent_type': 'desktop', } # Get response. response = requests.request( 'POST', 'https://realtime.oxylabs.io/v1/queries', auth=('user', 'pass1'), json=payload, ) # Print prettified response to stdout. pprint(response.json()) ``` {% endtab %} {% tab title="PHP" %} ```php 'google_search', 'query' => 'how to sell on amazon', 'render' => 'html', 'user_agent_type' => 'desktop', ]; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params)); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_USERPWD, "user" . ":" . "pass1"); $headers = []; $headers[] = "Content-Type: application/json"; curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); $result = curl_exec($ch); echo $result; if (curl_errno($ch)) { echo 'Error:' . curl_error($ch); } curl_close($ch); ``` {% endtab %} {% tab title="HTTP" %} ```http https://realtime.oxylabs.io/v1/queries?source=google_search&query=Emporio%20Armani%20EA3192&render=html&user_agent_type=desktop&access_token=12345abcde ``` {% endtab %} {% tab title="JSON" %} ```json { "source": "google_search", "query": "how to sell on amazon", "render": "html", "user_agent_type": "desktop" } ``` {% endtab %} {% endtabs %} Usamos o método de integração síncrono [**Realtime**](https://developers.oxylabs.io/documentation/pt-br/solucoes-de-scraping/web-scraper-api/integration-methods/realtime) em nossos exemplos. Se você quiser usar [**Proxy Endpoint**](https://developers.oxylabs.io/documentation/pt-br/solucoes-de-scraping/web-scraper-api/integration-methods/proxy-endpoint) ou a integração assíncrona [**Push-Pull**](https://developers.oxylabs.io/documentation/pt-br/solucoes-de-scraping/web-scraper-api/integration-methods/push-pull) consulte a seção de [**métodos de integração**](https://developers.oxylabs.io/documentation/pt-br/solucoes-de-scraping/web-scraper-api/integration-methods) . ## Valores dos parâmetros de solicitação ### Genérico Configuração básica e opções de personalização para raspar resultados de pesquisa da Web do Google com AI Overviews.
ParâmetroDescriçãoValor padrão
sourceDefine o scraper. Use google_search ou google_ads.google_search
queryA palavra-chave ou frase a ser pesquisada.-
renderAtiva a renderização de JavaScript quando definido como html. Mais informações.-
context:
expand_aio		Defina como true para expandir o Google AI Overviews (renderização de JavaScript ativada).false
parseRetorna dados parseados quando definido como true.false
callback_urlURL para seu endpoint de callback. Mais informações.-
user_agent_typeTipo de dispositivo e navegador. Use desktop ou mobile.desktop
\- parâmetro obrigatório #### Operadores de pesquisa avançada do Google Ao raspar, pode ser útil combinar operadores avançados de pesquisa do Google com sua consulta. Isso permite personalizar o escopo da pesquisa, garantindo que os resultados sejam mais relevantes e focados. Explore esses comandos especiais [**aqui**](https://ahrefs.com/blog/google-advanced-search-operators/) e [**aqui**](https://www.semrush.com/kb/831-how-to-use-google-advanced-search-operators). Veja o exemplo de consulta abaixo. ```json { "source": "google_search", "query": "iphone 15 launch inurl:apple", "render": "html", "user_agent_type": "desktop" } ``` ### Localização Adapte os resultados da pesquisa para locais geográficos e idiomas específicos.
ParâmetroDescriçãoValor padrão
geo_locationA localização geográfica para a qual o resultado deve ser adaptado. Usar esse parâmetro corretamente é extremamente importante para obter os dados certos. Para mais informações, leia sobre nossas geo_location estruturas de parâmetros sugeridas aqui.-
localeAccept-Language valor do cabeçalho que altera o idioma da interface web da sua página de pesquisa do Google. Mais informações.-
context:
results_language		Idioma dos resultados. A lista de idiomas do Google suportados pode ser encontrada aqui.
Saiba como usar parâmetros de contexto aqui.		-
### Paginação Controles para gerenciar a paginação e a obtenção dos resultados de pesquisa.
ParâmetroDescriçãoValor padrão
start_pageNúmero da página inicial.1
pagesNúmero de páginas a recuperar.1
limitNúmero de resultados a recuperar em cada página.10
context:limit_per_pageRaspe várias páginas usando o mesmo endereço IP e sessão (conjunto de cookies). Ao especificar os números das páginas em um array JSON com a chave page e indicar o número de resultados orgânicos por página usando a chave limit você pode minimizar a chance de ver resultados orgânicos sobrepostos entre as páginas (por exemplo, o último resultado orgânico da primeira página ser o mesmo que o primeiro resultado orgânico da segunda página). Veja o exemplo.-
#### Suporte a rolagem contínua A Web Scraper API oferece suporte total à rolagem contínua do Google Search. Ela detecta automaticamente layouts de rolagem contínua, carregando com eficiência os resultados orgânicos solicitados sem necessidade de parâmetros extras. #### Limite por página {% hint style="warning" %} Devido a mudanças recentes nos limites do Google, ajustamos o comportamento da Web Scraper API. O máximo de resultados por página corresponderá à saída orgânica do Google, que normalmente é de 10 resultados. {% endhint %} Para usar este recurso, inclua um array JSON com objetos JSON contendo os seguintes dados:
ParâmetroDescriçãoExemplo
pageO número da página que você deseja raspar. Qualquer valor inteiro maior que 0 funcionará1
limitO número de resultados na página em questão. Qualquer valor inteiro entre 1 e 100 (inclusive) funcionará.90
#### Exemplo de solicitação ```json { "source": "google_search", "query": "how to sell on amazon", "render": "html", "user_agent_type": "dekstop", "parse": true, "context": [ { "key": "limit_per_page", "value": [ {"page": 1, "limit": 10}, {"page": 2, "limit": 90} ] }] } ``` ### Filtragem Opções para filtrar e refinar os resultados da pesquisa com base em vários critérios. Saiba como usar parâmetros de contexto [**aqui**](#context-parameters).
ParâmetroDescriçãoValor padrão
context:
filter		Definir o valor deste parâmetro como 0 permite ver resultados que, de outra forma, seriam excluídos por similaridade com outros resultados.1
context:
safe_search		Pesquisa segura. Defina como true para ativá-la.false
context:
udm		udm o parâmetro permite alternar entre diferentes abas de pesquisa, como imagens, locais ou vídeos, para personalizar o tipo de resultados exibidos. Encontre os valores aceitos aqui.-
context:
tbm		a ser correspondido ou tbm parâmetro. Os valores aceitos são: app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl-
context:
tbs		Este parâmetro funciona como um contêiner para parâmetros mais obscuros do Google, como limitar/classificar resultados por data, além de outros filtros, alguns dos quais dependem do parâmetro tbm (ex.: tbs=app_os:1 está disponível apenas com o valor tbm do parâmetro app). Mais informações aqui.-
{% hint style="warning" %} `udm` e `tbm` parâmetros de contexto não podem ser usados juntos em uma única solicitação de raspagem; selecione apenas um. Usar ambos simultaneamente pode levar a conflitos ou comportamento inesperado. {% endhint %} ### Outro Configurações e controles avançados adicionais para requisitos especializados.
ParâmetroDescriçãoValor padrão
context:
fpstate		Definir o valor de fpstate como aig fará o Google carregar mais apps. Este parâmetro só é útil se usado junto com o parâmetro render .-
context:
nfpr		true desativará a autocorreção ortográficafalse
### Parâmetros de contexto Todos os parâmetros de contexto devem ser adicionados ao array `context` como objetos com pares `key` e `do parâmetro` de, por exemplo: ```json ... "context": [ { "key": "filter", "value": "0" } ] ... ``` ## Estrutura e processamento de dados ### Dicionário de dados Todas as chaves disponíveis no recurso SERP de AI Overviews estão definidas na tabela abaixo:
Chave (results.ai_overview)DescriçãoTipo
answer_textInformações gerais sobre o termo de consulta do Google Search.array
bullet_listIndica informações sobre itens renderizados em uma lista com marcadores dentro do recurso SERP de AI Overviews.array
productsUma lista de produtos com seus respectivos detalhes.object
source_panelUma lista de fontes usadas para gerar o resultado do AI Overviews no recurso SERP do Google.object
additional_questionsUma lista de perguntas adicionais com seus respectivos detalhes.object
recipesUma lista de receitas com seus respectivos detalhes.object
info_listUma lista de informações mais frequentemente usadas para representar etapas de um processo relevante para a consulta de pesquisa.array
pos_overallUma indicação da posição do resultado do recurso SERP de AI Overviews entre todos os resultados SERP disponíveis do Google.integer
### Trabalhando com vários AI Overviews Como os AI Overviews agora são retornados como um array, você precisa iterar por eles: {% tabs %} {% tab title="JavaScript" %} ```javascript // Processando todos os AI Overviews em uma resposta response.results.ai_overviews.forEach((aiOverview, index) => { console.log(`Processando AI Overview #${index + 1}`); // Processar componentes individuais if (aiOverview.answer_text) { // Tratar o texto da resposta } if (aiOverview.bullet_list) { // Tratar listas com marcadores } // E assim por diante... }); ``` {% endtab %} {% tab title="Python" %} ```python # Processando todos os AI Overviews em uma resposta for index, ai_overview in enumerate(response['results']['ai_overviews']): print(f"Processando AI Overview #{index + 1}") # Processar componentes individuais if 'answer_text' in ai_overview: answer_texts = ai_overview['answer_text'] for answer in answer_texts: # Processar cada texto de resposta if 'text' in answer: for text_item in answer['text']: print(f"Texto da resposta: {text_item}") if 'bullet_list' in ai_overview: bullet_lists = ai_overview['bullet_list'] for bullet_list in bullet_lists: if 'list_title' in bullet_list: print(f"Título da lista: {bullet_list['list_title']}") if 'points' in bullet_list: for point in bullet_list['points']: print(f"- {point}") # Continue processando outros elementos... ``` {% endtab %} {% tab title="PHP" %} ```php $aiOverview) { $indexNumber = $index + 1; echo "Processando AI Overview #{$indexNumber}\n"; // Processar texto da resposta if (isset($aiOverview['answer_text']) && is_array($aiOverview['answer_text'])) { foreach ($aiOverview['answer_text'] as $answer) { if (isset($answer['text']) && is_array($answer['text'])) { foreach ($answer['text'] as $textItem) { echo "Texto da resposta: {$textItem}\n"; } } } } // Processar listas com marcadores if (isset($aiOverview['bullet_list']) && is_array($aiOverview['bullet_list'])) { foreach ($aiOverview['bullet_list'] as $bulletList) { if (isset($bulletList['list_title'])) { echo "Título da lista: {$bulletList['list_title']}\n"; } if (isset($bulletList['points']) && is_array($bulletList['points'])) { foreach ($bulletList['points'] as $point) { echo "- {$point}\n"; } } } } // Continue processando outros elementos... } } ?> ``` {% endtab %} {% endtabs %} Na maioria dos casos, haverá apenas um AI Overview, mas seu código deve estar preparado para lidar com várias entradas. Explore exemplos de resultados de AI Overviews abaixo, categorizados por diferentes consultas de pesquisa: [**Item**](#item), [**Receitas**](#recipe), [**Instrução**](#instruction). ### Item No exemplo a seguir, foi usada a consulta "Emporio Armani EA3192".
```json ... "ai_overviews": [ { "answer_text": [ { "text": [ "Emporio Armani é uma marca de luxo conhecida por seus designs atemporais e compromisso com o artesanato italiano.", "O Emporio Armani EA3192 é um par de óculos de grau projetado para homens.", "Eles têm uma armação retangular feita de plástico leve e hipoalergênico.", "As lentes são UV e antirreflexo.", "Aqui estão alguns insights das avaliações:", ], "pos": 1 } ], "bullet_list": [ { "list_title": "Prós", "points": [ "Confortável", "Marca discreta" ], "pos": 1 } ], "products": { "items": [ { "product_name": "Óculos de grau Emporio Armani masculino preto brilhante Tamanho: 53", "price": "$163.00", "previous_price": null, "seller": "Lenscrafters", "shipping": "Entrega grátis", "url": "https://www.lenscrafters.com/lc-us/emporio-armani/8056597975810?srsltid=AfmBOoqWO55KIJevhQp_c5OAp0JOM_8Uza3_gCvn9S4x4Vz342AUSQewzJI", "pos": 1 } ] }, "source_panel": { "items": [ { "url": "https://www.italist.com/magazine/what-is-emporio-armani/#:~:text=Emporio%20Armani%20is%20a%20luxury,reinforce%20the%20perception%20of%20luxury.", "source": "italist.com", "date": "May 5, 2023", "title": "O que é Emporio Armani e o Emporio Armani é uma marca de luxo?", "pos": 1 }, ... ] }, "additional_questions": { "items": [ { "question": "O Emporio Armani é o mesmo que Giorgio Armani?", "pos": 1 } ] }, "pos_overall": 1 } ], ... ``` #### Texto da resposta
Chave (results.ai_overviews.answer_text)DescriçãoTipo
textUma resposta curta para a consulta do Google Search.array
posUm indicador que denota a posição de um item entre todos os resultados de resposta de AI Overviews.integer
**Lista com marcadores**
Chave (results.ai_overviews.bullet_list)DescriçãoTipo
list_titleO título da lista com marcadores.string
pointsOs itens renderizados na lista com marcadores. Todos os itens são separados por vírgula.array
posUm indicador que denota a posição de um item entre todos os resultados de lista com marcadores de AI Overviews.integer
**Produtos**
Chave (results.ai_overviews.products)DescriçãoTipo
itemsUma lista de produtos com seus respectivos detalhes.array
items.product_nameO nome do produto.string
items.priceO preço atual do produto.string
items.previous_priceO preço inicial do produto (se aplicável).string
items.sellerO vendedor do produto.string
items.shippingO tipo de frete disponível para o produto.string
items.urlA URL do produto.string
items.posUm indicador que denota a posição de um item entre todos os resultados de produtos de AI Overviews.integer
#### Painel de fonte
Chave (results.ai_overviews.source_panel)DescriçãoTipo
itemsUma lista de fontes usadas para gerar o resultado do AI Overviews no recurso SERP do Google.object
items.urlA URL do site.string
items.sourceO nome do site.string
items.dateA data em que o artigo foi publicado.string
items.titleO título do artigo.string
items.posUm indicador que denota a posição de um item entre todos os resultados do painel de fontes de AI Overviews.integer
#### Perguntas adicionais
Chave (results.ai_overviews.additional_questions)DescriçãoTipo
items.questionUma lista de perguntas adicionais relevantes, separadas por vírgula, para a consulta de pesquisa original.array
items.posUm indicador que denota a posição de um item entre todos os resultados de perguntas adicionais de AI Overviews.integer
### Receita No exemplo a seguir, foi usada a consulta "recipe for an apple pie".
```json ... "ai_overviews": [ { "recipes": { "items": [ { "description": "Esta receita simples apresenta uma massa caseira, maçãs Granny Smith e especiarias quentes.", "image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/...", "source": "Allrecipes", "rating": "4.8", "rating_count": "13K", "duration": "90 min", "url": "https://www.allrecipes.com/recipe/12682/apple-pie-by-grandma-ople/", "title": "Apple Pie by Grandma Ople" }, ... ] } } ], ... ``` **Receitas**
Chave (results.ai_overviews.recipes)DescriçãoTipo
itemsUma lista de receitas com seus respectivos detalhes.array
items.descriptionUma breve descrição da receita.string
items.imageUma imagem em miniatura da receita codificada em base64.string
items.sourceO nome do site onde a receita é publicada.string
items.ratingA avaliação da receita.string
items.rating_countO número de avaliações.string
items.durationO tempo necessário para preparar o prato.string
items.urlA URL da receita completa.string
items.titleO título da receita.string
No exemplo a seguir, foi usada a consulta "recipe of a juicy succulent steak".
#### Lista de informações
Chave (results.ai_overviews.info_list)DescriçãoTipo
list_titleO título da lista.string
list_itemsContém uma lista de itens com seus respectivos detalhes.array
list_items.titleO título da seção dentro da lista.string
list_items.contentUma breve descrição da seção.array
list_item.posUm indicador que denota a posição de um determinado item entre todos os resultados da lista AI Overviews Info.integer
### Instrução No exemplo a seguir, a consulta "docker exec commands explained" foi usada.
```json ... "ai_overviews": [ { "answer_text": [ { "text": [ "O docker execExecEm computação, exec é uma funcionalidade de um sistema operacional que executa um arquivo executável no contexto de um processo já existente, substituindo o executável anterior...", "É uma ferramenta poderosa que pode ser usada para uma variedade de tarefas, como solucionar problemas de um contêiner, executar um script ou instalar software." ], "pos": 1 }, { "text": [ "A sintaxe do comando docker exec é a seguinte:" ], "command": [ "docker exec [OPTIONS] CONTAINER COMMAND [ARG...]" ], "pos": 2 }, ... } ] } ], ... ``` **Comando de texto da resposta** {% hint style="info" %} Observação: os detalhes são renderizados no mesmo array que para [**consulta de pesquisa relacionada ao item**](#answer-text), no entanto, um novo tipo de chave (command) aparece para tipo de consulta relacionado a instruções {% endhint %}
Chave (results.ai_overviews.answer_text)DescriçãoTipo
commandUma instrução dada a um computador ou software para executar uma tarefa específica.string
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://developers.oxylabs.io/documentation/pt-br/solucoes-de-scraping/web-scraper-api/targets/google/ai-overviews.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.