Pesquisa na Web
Raspador completo da Pesquisa Google com dados analisados para resultados orgânicos, anúncios, snippets, painéis de conhecimento, principais notícias e mais.
O google_search source foi projetado para recuperar resultados do Google Search (SERPs) e do Google AI Overviews. Esta subpágina apresenta especificamente informações relacionadas à Pesquisa Web do Google. Para explorar outros tipos de resultado, leia Pesquisa de imagens ou Pesquisa de notícias.
Exemplos de solicitação
Nos exemplos abaixo, fazemos uma solicitação para obter 2 páginas de resultados, da número 11 até a número 12 , para o termo de pesquisa adidas. A API retornará resultados analisados.
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
"source": "google_search",
"query": "adidas",
"start_page": 11,
"pages": 2,
"parse": true,
}'import requests
from pprint import pprint
# Estruture o payload.
payload = {
'source': 'google_search',
'query': 'adidas',
'start_page': 11,
'pages': 2,
'parse': True,
}
# Obtenha a resposta.
response = requests.request(
'POST',
'https://realtime.oxylabs.io/v1/queries',
auth=('USERNAME', 'PASSWORD'),
json=payload,
)
# Imprima a resposta formatada em stdout.
pprint(response.json())Usamos o método de integração Realtime síncrona em nossos exemplos. Se você quiser usar Proxy Endpoint ou a integração assíncrona Push-Pull , consulte a seção métodos de integração .
Valores dos parâmetros da solicitação
Genérico
Opções básicas de configuração e personalização para raspar resultados da Pesquisa Web do Google.
source
Define o scraper.
google_search
query
A palavra-chave ou frase para pesquisar.
-
- parâmetro obrigatório
Operadores avançados de pesquisa 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 estes comandos especiais aqui e aqui. Veja um exemplo abaixo.
Localização
Adapte os resultados da pesquisa para locais geográficos, localidades e idiomas específicos.
geo_location
A localização geográfica para a qual o resultado deve ser adaptado. Usar este parâmetro corretamente é extremamente importante para obter os dados certos. Para mais informações, leia sobre nossas geo_location estruturas de parâmetros aqui.
-
Paginação
Controles para gerenciar a paginação e a recuperação dos resultados da pesquisa.
start_page
Número da página inicial.
1
pages
Número de páginas para recuperar.
1
limit
Número de resultados para recuperar em cada página.
10
context:limit_per_page
Raspe várias páginas usando o mesmo endereço IP e sessão (cookie definido). 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 na primeira página ser o mesmo que o primeiro resultado orgânico na segunda página). Veja o exemplo.
-
Suporte a rolagem contínua
Web Scraper API oferece suporte total à rolagem contínua da Pesquisa Google. Ele 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
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.
Para usar este recurso, inclua um array JSON com objetos JSON contendo os dados a seguir:
page
O número da página que você deseja raspar. Qualquer valor inteiro maior que 0 funcionará
1
limit
O número de resultados na página em questão. Qualquer valor inteiro entre 1 e 100 (inclusive) funcionará.
90
Exemplo de solicitação
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:
filter
Definir o valor deste parâmetro como 0 permite ver resultados que, de outra forma, seriam excluídos devido à semelhança 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
To-be-matched ou tbm parâmetro. Os valores aceitos são: app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl
-
context:
tbs
Este parâmetro é como um contêiner para parâmetros mais obscuros do Google, como limitar/ordenar resultados por data, bem como outros filtros, alguns dos quais dependem do parâmetro tbm (por exemplo, tbs=app_os:1 só está disponível com o valor tbm ). Mais informações app. aqui.
-
udm e tbm os 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.
Outros
Configurações e controles avançados adicionais para requisitos especializados.
context:
fpstate
Definir o valor de fpstate como aig fará o Google carregar mais apps. Este parâmetro só é útil se usado em conjunto com o parâmetro render .
-
context:
nfpr
true desativará a autocorreção ortográfica
false
Parâmetros de contexto
Todos os parâmetros de contexto devem ser adicionados ao array context como objetos com pares key e ). Mais informações , por exemplo:
Dados estruturados
A Web Scraper API é capaz de extrair um objeto HTML ou JSON que contém resultados da pesquisa Google, oferecendo dados estruturados sobre vários elementos da página de resultados.
A composição dos elementos pode ser diferente dependendo de se foi uma desktop ou mobile pesquisa.
Para ajudar você a identificar certos elementos, consulte os dicionários de dados de cada tipo de resultado de pesquisa do Google, seja obtido de pesquisas em desktop ou mobile.
Dicionário de dados de saída
Navegue pelos detalhes usando a navegação à direita ou rolando para baixo na página.
Exemplo de HTML
Estrutura JSON
A saída estruturada da Pesquisa na Web do Google inclui campos como URL, page, resultados, e outros. A tabela abaixo apresenta uma lista detalhada de cada recurso de SERP que analisamos, junto com sua descrição e tipo de dado. A tabela também inclui alguns metadados.
O número de itens e campos para um tipo de resultado específico pode variar dependendo da consulta de pesquisa.
url
A URL da página de pesquisa do Google.
string
page
Número da página relativo à paginação da SERP do Google.
integer
resultados
Um dicionário contendo os resultados da pesquisa.
object
results.pla
Uma lista de anúncios de listagem de produtos com seus respectivos detalhes.
object
results.paid
Uma lista de resultados patrocinados com seus respectivos detalhes.
array
results.images
Uma lista de resultados de imagens com seus respectivos detalhes.
object
results.flights
Uma lista de voos com seus respectivos detalhes.
object
results.organic
Uma lista de listagens não pagas com seus respectivos detalhes.
array
results.organic_videos
Uma lista de vídeos orgânicos com seus respectivos detalhes.
array
results.top_sights
Uma lista de pontos turísticos ou atrações notáveis com seus respectivos detalhes.
array
results.jobs
Uma lista de vagas de emprego com seus respectivos detalhes.
object
results.local_service_ads
Uma lista de provedores de serviços locais patrocinados.
object
results.video_boxes
Caixas de vídeo na SERP com seus respectivos detalhes.
array
results.recipes
Uma lista de receitas com seus respectivos detalhes.
object
results.twitter
Uma lista de resultados do Twitter (X) com seus respectivos detalhes.
array
results.knowledge
Uma lista de informações relevantes recuperadas do painel de conhecimento.
object
results.local_pack
Uma lista contendo listagens de empresas locais relevantes para a pesquisa.
object
results.item_carousel
Uma lista de itens ilustrativos para consultas informativas com seus respectivos detalhes.
object
results.videos
Uma lista de vídeos com seus respectivos detalhes.
object
results.hotels
Uma lista de hotéis relevantes para a localização usada na consulta de pesquisa.
object
results.apps
Uma lista de aplicativos com seus respectivos detalhes.
array
results.finance
Um resumo de dados financeiros de empresas, incluindo preços de ações, valor de mercado e outras métricas importantes.
object
results.sports_games
Informações sobre jogos esportivos recentes, detalhando placares, equipes, tipos de jogo e destaques.
object
results.discussions_and_forums
Uma lista de tópicos de discussão e posts de fóruns com URLs, títulos, fontes e contagens de comentários.
object
results.featured_snippet
Uma lista de resultados específicos recuperados da parte orgânica das SERPs.
array
results.top_stories
Uma lista de artigos com seus respectivos detalhes quando uma consulta de pesquisa é identificada como voltada para notícias.
object
results.popular_products
Uma lista de exibições não pagas e orgânicas de listagens de produtos do Google Shopping com seus respectivos detalhes.
object
results.related_searches
Uma lista de um ou mais blocos de pesquisas relacionadas apresentados em diferentes posições na página de pesquisa.
array
results.related_questions
Uma lista de consultas de pesquisa interrogativas relacionadas com seus respectivos detalhes.
object
results.what_people_are_saying
Uma lista de tópicos de discussão e posts de fóruns com URLs, títulos, fontes, principais comentários, nível de engajamento e períodos de tempo.
array
results.search_information
Uma lista de detalhes para a consulta de pesquisa enviada.
object
total_results_count
O número total de resultados encontrados para a consulta de pesquisa.
string
last_visible_page
Valor que identifica o número máximo de página visível na página de resultados da consulta de pesquisa. (-1 quando o carregamento de mais resultados é iniciado pela rolagem).
integer
parse_status_code
O código de status do trabalho de análise. Você pode ver os códigos de status do parser descritos aqui.
integer
created_at
O timestamp em que o trabalho de scraping foi criado.
timestamp
updated_at
O timestamp em que o trabalho de scraping foi concluído.
timestamp
job_id
O ID do trabalho associado ao trabalho de scraping.
string
status_code
O código de status do trabalho de scraping. Você pode ver os códigos de status do scraper descritos aqui.
integer
parser_type
O tipo de parser usado para dividir o conteúdo HTML.
string
Nas seções a seguir, os trechos de código JSON analisados são abreviados quando há mais de um item disponível para o tipo de resultado.
Anúncios de Listagem de Produtos (PLA)
O pla a seção de resultados de pesquisa refere-se a Anúncios de Listagem de Produtos, também conhecidos como anúncios do Google Shopping, exibidos em destaque no topo da página de pesquisa em formato de carrossel.
itens
Todos os PLAs disponíveis na página.
array
Desktop e mobile
items.pos
Um indicador que denota a posição de um item entre os resultados de PLA.
integer
Desktop e mobile
items.url
A URL do produto.
string
Desktop e mobile
items.price
O preço do produto no anúncio de listagem.
string
Desktop e mobile
items.title
O título do produto no anúncio de listagem.
string
Desktop e mobile
items.seller
O vendedor do produto no anúncio de listagem.
string
Desktop e mobile
items.url_image
A URL da imagem do produto.
string
Desktop
items.image_data
A imagem em miniatura do produto codificada em base64.
string
Desktop e mobile
pos_overall
Uma indicação da posição do recurso SERP de PLA dentro da SERP.
integer
Desktop e mobile
Pago
O paid a seção refere-se a anúncios veiculados pelo Google Ads, geralmente aparecendo acima dos resultados orgânicos (não pagos).

pos
Um indicador que denota a posição de um item entre os resultados pagos.
integer
Desktop e mobile
url
A URL do resultado pago.
string
Desktop e mobile
desc
Uma breve descrição do resultado pago.
string
Desktop e mobile
title
O título do resultado pago.
string
Desktop e mobile
data_rw
URL de redirecionamento do resultado pago.
string
Desktop e mobile
sitelinks
Um objeto que contém informações sobre links internos para um site que aparece abaixo do primeiro resultado de pesquisa no Google.
object
Desktop e mobile
sitelinks.inline/expanded
Uma lista de URLs com seus respectivos detalhes. O nome da chave (`inline`/`expanded`) especifica o tipo do sitelinks elemento.
array
Desktop e mobile
sitelinks.inline.url
A URL do site vinculado.
string
Desktop e mobile
sitelinks.inline.title
O título do site vinculado.
string
Desktop e mobile
sitelinks.inline.description
Uma breve descrição do site vinculado.
string
Desktop
url_shown
A URL abreviada visível logo abaixo da descrição.
string
Desktop e mobile
pos_overall
Uma indicação da posição do resultado pago dentro da SERP.
integer
Desktop e mobile
Imagens
O images a seção refere-se a resultados de imagens exibidos em diferentes seções de uma página SERP, seja como uma seção dedicada ou no topo. É importante observar que a estrutura dos dados coletados dos resultados da Pesquisa Google pode diferir da dos dados coletados dos resultados da Pesquisa de Imagens do Google.
itens
Uma lista de imagens com seus respectivos detalhes.
array
Desktop e mobile
items.alt
O texto alt da imagem.
string
Desktop e mobile
items.pos
Um indicador exclusivo que denota a posição da imagem na lista.
integer
Desktop e mobile
items.url
A URL da página da web que contém a imagem.
string
Desktop e mobile
pos_overall
Uma indicação da posição do recurso SERP de Imagens dentro da SERP.
integer
Desktop e mobile
Orgânico
O organic a seção refere-se a listagens não pagas nos resultados orgânicos da Pesquisa Google, determinadas pela relevância por meio do algoritmo do Google. Essas listagens aparecem abaixo dos anúncios pagos nas páginas de pesquisa.
Exemplo 1

Exemplo 2

pos
Um indicador que denota a posição de um item entre os resultados orgânicos.
integer
Desktop e mobile
url
A URL do resultado orgânico.
string
Desktop e mobile
desc
Uma breve descrição do resultado orgânico.
string
Desktop e mobile
title
O título do resultado orgânico.
string
Desktop e mobile
images
As imagens em miniatura do resultado orgânico codificadas em base64.
string
Desktop e mobile
sitelinks
O objeto contém um elemento `expanded` ou `inline` com mais detalhes sobre os sitelinks.
object
Desktop e mobile
sitelinks.expanded/inline
Uma lista de sitelinks do resultado orgânico. O nome da chave (inline/expanded) especifica o tipo do elemento sitelinks.
array
Desktop e mobile
sitelinks.expanded.url
A URL do site vinculado.
string
Desktop e mobile
sitelinks.expanded.title
O título do site vinculado.
string
Desktop e mobile
url_shown
A URL abreviada visível logo abaixo da descrição.
string
Desktop e mobile
pos_overall
Uma indicação da posição do resultado Orgânico dentro da SERP.
integer
Desktop e mobile
favicon_text
O texto ou nome associado ao favicon (ícone do site).
string
Desktop
rating
A avaliação média do produto ou conteúdo.
float
Desktop
review_count
O número de avaliações associadas ao produto ou conteúdo.
integer
Desktop
additional_info
Contém detalhes sobre preços, disponibilidade, avaliações do produto, opções de entrega e políticas de devolução.
lista de strings
Desktop
Vídeos orgânicos
O results.organic_videos contém uma matriz de listagens de vídeos exibidas organicamente nos resultados de pesquisa, ou seja, não são anúncios pagos. Cada listagem de vídeo inclui detalhes relevantes, como título do vídeo, URL e descrição.

pos
Um indicador que denota a posição de um item entre os resultados de Vídeos Orgânicos.
integer
Desktop
url
A URL do vídeo.
string
Desktop
desc
Breve descrição do vídeo.
string
Desktop
title
O título do vídeo.
string
Desktop
pos_overall
Uma indicação da posição do resultado de Vídeo Orgânico dentro da SERP.
integer
Desktop
Principais atrações
O results.top_sights contém uma lista de marcos ou atrações proeminentes normalmente associados à localização ou ao tópico da pesquisa. Cada item inclui detalhes como a posição na lista e o título.
itens
Uma lista de principais atrações com seus respectivos detalhes.
array
Desktop
items.pos
A posição do resultado de Principais atrações dentro do recurso SERP de Principais atrações.
integer
Desktop
items.title
O título da atração turística.
string
Desktop
pos_overall
Uma indicação da posição do resultado de Principais atrações dentro da SERP.
integer
Desktop
Vagas
O results.jobs contém vagas extraídas dos resultados de pesquisa. Cada listagem inclui detalhes como a URL que direciona para a vaga, título da vaga, fonte, empregador e localização. As listagens são provenientes de vários sites de empregos, plataformas de carreira e outras plataformas indexadas pelo Google.

listagens
Uma matriz de todas as vagas disponíveis na página.
array
Desktop
listings.url
A URL para a listagem completa da vaga.
string
Desktop
listings.title
O título da vaga.
string
Desktop
listings.source
A fonte que contém a publicação original da vaga.
string
Desktop
listings.employer
A organização contratando para a posição identificada.
string
Desktop
listings.location
A localização da vaga.
string
Desktop
pos_overall
Uma indicação da posição do recurso SERP de Vagas dentro da SERP.
integer
Desktop
Twitter (X)
O twitter o recurso aparece com frequência para marcas, filmes, músicos e outras celebridades, normalmente posicionado diretamente abaixo do resultado de pesquisa do site da marca. Este recurso oferece um link direto para o feed do Twitter da marca, exibindo um carrossel de seus tweets mais recentes.

pos
Um indicador que denota a posição de um item entre os resultados orgânicos.
integer
Desktop
url
A URL do perfil que contém as publicações do Twitter (X).
string
Desktop
itens
Uma lista de publicações do Twitter (X) com seus respectivos detalhes.
array
Desktop
items.pos
Um indicador que denota a posição de um tweet dentro do recurso SERP do Twitter (X).
string
Desktop
items.url
A URL da publicação do Twitter (X).
string
Desktop
items.content
Uma breve descrição que denota todo o texto da publicação relevante do Twitter (X).
string
Desktop
items.timeframe
Descreve há quanto tempo o tweet foi criado.
string
Desktop
title
O título do perfil do Twitter (X).
string
Desktop
pos_overall
Uma indicação da posição do resultado do Twitter dentro da SERP.
integer
Desktop
Conhecimento
O knowledge a seção nos resultados de pesquisa mostra dados do Painel de conhecimento do Google no lado direito ao pesquisar pessoas, lugares, organizações ou entidades integradas ao Knowledge Graph.

title
O título do painel de conhecimento.
string
Desktop e mobile
images
Uma lista de imagens usadas logo ao lado do título.
array
Desktop
factoids
Uma lista de todos os fatos usados no painel de conhecimento.
array
Desktop e mobile
factoids.links
Uma lista de todos os links relacionados a um item factoid específico.
array
Desktop e mobile
factoids.links.href
Um hiperlink para a página de resultados da Pesquisa Google para o factoid fornecido.
string
Desktop e mobile
factoids.links.title
A descrição de quaisquer páginas vinculadas relacionadas ao factoid.
string
Desktop e mobile
factoids.title
O nome da seção factoid.
string
Desktop e mobile
factoids.content
A descrição do factoid.
string
Desktop e mobile
profiles
Uma lista de perfis de mídia social listados no painel de conhecimento.
string
Desktop
profiles.url
Um link para o perfil de mídia social.
string
Desktop
profiles.title
O título do perfil de mídia social.
string
Desktop
subtitle
Uma breve explicação sobre a entidade descrita no título.
string
Desktop e mobile
description
Uma descrição que indica as principais informações sobre a entidade no painel de conhecimento.
string
Desktop e mobile
related_searches
Uma lista de pesquisas relacionadas com seus respectivos detalhes.
array
Desktop
related_searches.url
A URL da página de pesquisa relacionada.
string
Desktop
related_searches.title
O título da página de pesquisas relacionadas.
string
Desktop
related_searches.section_title
O nome da seção de pesquisas relacionadas.
string
Desktop
Pacote Local
O local_pack exibe os três principais resultados de pesquisa locais com base na localização do usuário ou na localização de pesquisa especificada, incluindo um mapa e informações adicionais.
itens
Uma lista de locais com seus respectivos detalhes.
array
Desktop e mobile
items.cid
Um número de identificação único atribuído a uma listagem comercial específica.
string
Desktop e mobile
items.pos
A posição do resultado local dentro do pacote local.
integer
Desktop e mobile
items.title
O título da entidade local.
string
Desktop e mobile
items.rating
A classificação da entidade local.
integer
Desktop e mobile
items.address
O endereço da entidade local.
string
Desktop e mobile
items.rating_count
O número de avaliações da entidade local.
integer
Desktop e mobile
pos_overall
Uma indicação da posição do resultado do Pacote Local dentro do SERP.
integer
Desktop e mobile
Principais notícias
top_stories é uma seção dedicada que aparece na Pesquisa Google para consultas sobre notícias.

itens
Uma lista de artigos de notícias selecionados com seus respectivos detalhes.
array
Desktop e mobile
items.pos
A posição do artigo dentro do recurso SERP de Principais Notícias.
integer
Desktop e mobile
items.url
A URL do artigo completo.
string
Desktop e mobile
items.title
O título do artigo.
string
Desktop e mobile
items.section
O nome da seção de Principais Notícias.
string
Móvel
items.source
O nome do site onde o artigo é publicado.
string
Desktop e mobile
items.timeframe
Descreve há quanto tempo o artigo foi publicado.
string
Desktop
pos_overall
Indica a posição geral do recurso SERP de Principais Notícias dentro do SERP.
integer
Desktop e mobile
Produtos populares
O popular_products O recurso SERP apresenta um carrossel de vários produtos determinados por sua popularidade e relevância para a consulta do usuário. Isso difere dos anúncios de listagem de produtos (PLAs), que são influenciados por anunciantes. Vale notar que vários popular_products carrosséis podem aparecer em uma única página do SERP.\
itens
Uma lista de produtos populares com seus respectivos detalhes.
array
Desktop e mobile
items.pos
Um indicador único que denota a posição de um produto popular específico dentro do recurso SERP de Produtos Populares.
integer
Desktop e mobile
items.price
O preço de um produto popular específico.
string
Desktop e mobile
items.title
O título de um produto popular específico.
string
Desktop e mobile
items.rating
A classificação de um produto popular específico.
string
Desktop
items.seller
O vendedor de um produto popular específico.
string
Desktop
items.image_data
A imagem em miniatura do produto codificada em base64.
string
Desktop
pos_overall
Indica a posição geral do recurso SERP de Produtos Populares dentro do SERP.
integer
Desktop e mobile
Pesquisas relacionadas
O related_searches O recurso SERP exibe consultas de pesquisa alternativas relacionadas à palavra-chave de pesquisa inicial, geralmente localizadas na parte inferior do SERP.
pos_overall
Indica a posição geral deste bloco de pesquisas relacionadas dentro da página de pesquisa.
integer
Desktop e mobile
related_searches
Uma lista de strings de pesquisa relacionadas dentro deste bloco.
array
Desktop e mobile
Perguntas relacionadas
O related_questions o recurso fica abaixo dos principais resultados de pesquisa, apresentando uma lista de perguntas diretamente relacionadas à consulta de pesquisa original do usuário. Ao oferecer um conjunto selecionado de perguntas relacionadas, os usuários podem explorar diferentes aspectos do tema, melhorando a experiência geral de pesquisa.

itens
Uma lista contendo todas as perguntas relacionadas.
array
Desktop e mobile
items.pos
Um indicador único que denota a posição de qualquer pergunta relacionada dentro do recurso SERP de Perguntas Relacionadas.
integer
Desktop e mobile
items.answer
A resposta à pergunta relacionada.
string
Desktop e mobile
items.source
Contém valores que descrevem a fonte da resposta à pergunta.
object
Desktop e mobile
items.source.url
A URL do site usada para obter a resposta.
string
Desktop
items.source.title
O título do site que contém a resposta.
string
Desktop
items.source.url_shown
A URL abreviada visível logo abaixo da resposta.
string
Desktop e mobile
items.question
A pergunta da seção de perguntas relacionadas.
string
Desktop e mobile
pos_overall
Indica a posição geral do recurso SERP de Perguntas Relacionadas dentro do SERP.
integer
Desktop e mobile
O que as pessoas estão dizendo
O what_people_are_saying a seção aparece nos resultados de pesquisa do Google quando há posts relevantes de fóruns, redes sociais ou plataformas de comunidade relacionados à consulta de pesquisa. Esta seção normalmente mostra conteúdo de plataformas como Reddit, TikTok e outros fóruns de discussão.

itens
Uma lista contendo todos os itens de conteúdo de fóruns de discussão ou redes sociais.
array
Desktop e mobile
items.url
A URL do tópico de discussão ou da página de conteúdo da rede social.
integer
Desktop e mobile
items.title
O título do tópico de discussão ou do conteúdo.
string
Desktop e mobile
items.top_comments
O comentário principal do tópico de discussão, se exibido.
string
Desktop e mobile
items.source
O nome da plataforma ou site que hospeda o conteúdo.
string
Desktop e mobile
items.engagement_timeframe
Contagem de comentários e período de atividade (por exemplo, "45 comentários, há 2 dias").
string
Desktop e mobile
Informações de pesquisa
O search_information o recurso fornece informações estruturadas sobre a consulta de pesquisa.

query
O termo de pesquisa original.
string
Desktop e mobile
geo_location *
Indica a área geográfica específica associada à pesquisa.
string
Desktop
showing_results_for
O termo de pesquisa para o qual os resultados estão sendo exibidos. `query` e `showing_results_for` podem ser diferentes se o Google corrigiu automaticamente o termo de pesquisa fornecido.
string
Desktop e mobile
total_results_count
O número total de resultados encontrados para o termo de pesquisa.
integer
Desktop e mobile
*Funciona apenas com renderização JS
Carrossel de itens
Um carrossel (item_carousel) de imagens ou links relacionados a um tipo específico de item é exibido no topo do SERP. O conteúdo e o layout variam com base na consulta de pesquisa do usuário, mostrando uma seleção de itens relevantes. Isso pode variar de produtos e notícias a imagens, criando uma experiência visualmente envolvente e personalizada para os usuários.
itens
Uma lista de itens colocados em um carrossel com seus respectivos detalhes.
array
Desktop
items.pos
A posição do item dentro do carrossel.
integer
Desktop
items.href
Um hyperlink para o SERP do Google do item no carrossel.
string
Desktop
items.title
O nome/título da entidade no carrossel.
string
Desktop
items.subtitle
Detalhes adicionais sobre a entidade no título.
string
Desktop
title
O título da seção do carrossel. O título está relacionado à consulta de pesquisa.
string
Desktop
pos_overall
Uma indicação da posição do resultado do Carrossel de Itens dentro do SERP.
integer
Desktop
Receitas
O recipes O recurso SERP no Google apresenta instruções de preparo, ingredientes, avaliações e fontes de pratos específicos no topo dos resultados de pesquisa.
itens
Uma lista de receitas selecionadas com seus respectivos detalhes.
array
Desktop e mobile
items.pos
A posição da receita dentro do recurso SERP de Receitas.
integer
Desktop e mobile
items.url
A URL da receita completa.
string
Desktop e mobile
items.desc
Uma breve descrição da receita obtida do artigo original.
string
Desktop
items.title
O título da receita.
string
Desktop e mobile
items.rating
A classificação da receita.
integer
Desktop e mobile
items.source
O nome do site onde a receita está localizada.
string
Desktop e mobile
items.duration
O tempo necessário para preparar o prato.
string
Desktop e mobile
pos_overall
Uma indicação da posição do resultado de Receitas dentro do SERP.
integer
Desktop e mobile
Vídeos
O videos o recurso na página de resultados da pesquisa do Google exibe uma seleção curada de conteúdo de vídeo relacionado à consulta de pesquisa do usuário, incluindo miniaturas, títulos e informações de origem.
itens
Uma lista contendo todos os resultados da seção de vídeos.
array
Desktop e mobile
items.pos
A posição do vídeo dentro da lista.
integer
Desktop e mobile
items.url
Um link para o vídeo.
string
Desktop e mobile
items.title
O título do vídeo.
string
Desktop e mobile
items.author
O nome do perfil onde o vídeo foi enviado.
string
Desktop e mobile
items.source
O nome da plataforma que hospeda o vídeo.
string
Desktop e mobile
pos_overall
Uma indicação da posição do resultado de Vídeos dentro do SERP.
integer
Desktop e mobile
Trecho em destaque
O featured_snippet é um resultado de pesquisa exclusivo do Google em que um trecho conciso que descreve uma página é mostrado antes de um link para essa página. Esses resultados em destaque são exibidos com destaque no topo dos resultados orgânicos de pesquisa, fornecendo aos usuários acesso rápido a informações relevantes.

url
A URL do site de onde o trecho que descreve a página é obtido.
string
Desktop e mobile
desc
O trecho que contém uma descrição para um resultado de pesquisa específico.
string
Desktop e mobile
title
O nome do artigo de onde o trecho que descreve uma página é obtido.
string
Desktop e mobile
url_shown
A URL do site contendo o trecho em destaque visível no SERP.
string
Desktop e mobile
pos_overall
Uma indicação da posição do resultado de Trecho em Destaque dentro do SERP.
integer
Desktop e mobile
itens
Uma lista contendo todos os itens de pesquisas relacionadas obtidos de um carrossel horizontal dentro do SERP.
array
Desktop
items.url
A URL da página de pesquisa relacionada.
string
Desktop
items.title
O nome do resultado de pesquisa relacionado renderizado no navegador.
string
Desktop
category
Um objeto contendo mais detalhes sobre a categoria dos resultados de pesquisa relacionados.
object
Desktop
category.name
O nome da categoria.
string
Desktop
category.type
O tipo da seção de pesquisa relacionada.
string
Desktop
pos_overall
Uma indicação da posição do resultado de Pesquisas Relacionadas Categorizadas dentro do SERP.
integer
Desktop
Hotéis
Google hotels é um recurso que mostra informações de hotéis diretamente nos resultados de pesquisa. Quando os usuários pesquisam hotéis ou consultas relacionadas a hospedagem no Google, o mecanismo de pesquisa pode apresentar um módulo de hotéis dedicado no topo da página de resultados, oferecendo uma visão geral conveniente e destacada das opções relevantes.
date_to
A data do check-out.
string
Desktop
resultados
Uma lista com todos os detalhes do hotel.
array
Desktop
results.price
O preço do hotel.
string
Desktop
results.title
O nome do hotel.
string
Desktop
results.description
Uma breve descrição do hotel visível logo abaixo do nome do hotel.
string
Desktop
date_from
A data do check-in.
string
Desktop
pos_overall
Uma indicação da posição do resultado de Hotéis dentro do SERP.
integer
Desktop
Voos
O flights o recurso apresenta um bloco contendo opções de voo organizadas associadas a uma consulta de pesquisa relevante, permitindo que os usuários comparem opções diretamente nos resultados de pesquisa.

to
O aeroporto de chegada.
string
Desktop e mobile
from
O aeroporto de partida.
string
Desktop e mobile
date_to
O dia da chegada.
string
Desktop e mobile
resultados
Uma lista de voos selecionados com seus respectivos detalhes.
array
Desktop e mobile
results.url
Um link para a página do Google Flights listando todos os voos de uma única companhia aérea.
string
Desktop e mobile
results.type
O tipo do voo.
string
Desktop
results.price
O preço do voo.
string
Desktop e mobile
results.airline
O nome da companhia aérea.
string
Desktop e mobile
results.duration
A duração do voo.
string
Desktop e mobile
date_from
A data da partida.
string
Desktop e mobile
pos_overall
Uma indicação da posição do resultado de Voos dentro do SERP.
integer
Desktop e mobile
Caixa de vídeo
O video_boxes array inclui resultados de vídeo específicos no topo da página de resultados de pesquisa, escolhidos pelo Google como os mais relevantes para a consulta.

pos_overall
A posição geral da Caixa de Vídeo.
integer
Desktop e mobile
title
O título do vídeo.
string
Desktop e mobile
url
A URL do vídeo.
string
Desktop e mobile
Anúncios de serviços locais
O local_service_ads o recurso capacita profissionais de serviços, como encanadores, eletricistas, chaveiros e outros prestadores locais, a promover seus serviços na página de resultados da Pesquisa Google.
itens
Uma lista de prestadores de serviço com seus respectivos detalhes.
array
Desktop
items.pos
A posição do anúncio de serviço dentro do recurso SERP de Anúncios de Serviços Locais.
integer
Desktop
items.url
Um link para o serviço na página de busca de Serviços Locais.
string
Desktop
items.title
O título do prestador de serviço.
string
Desktop
items.rating
A classificação do prestador de serviço.
integer
Desktop
items.reviews_count
O número de avaliações do prestador de serviço.
integer
Desktop
pos_overall
Uma indicação da posição do resultado de Anúncios de Serviços Locais dentro do SERP.
integer
Desktop
Apps
O apps o recurso SERP exibe aplicativos relevantes com base na consulta do usuário, fornecendo detalhes importantes como preço, classificação e mais. Esse recurso serve como uma plataforma valiosa para desenvolvedores e publicadores de apps aumentarem a visibilidade e o engajamento de seus aplicativos móveis diretamente na página de resultados da Pesquisa Google.

id
O ID do aplicativo na loja de apps disponível.
string
Móvel
url
A URL da loja de aplicativos contendo informações completas sobre o aplicativo no SERP.
string
Móvel
title
O título do aplicativo.
string
Móvel
rating
A classificação do aplicativo.
integer
Móvel
reviews_count
O número total de avaliações disponíveis para o resultado SERP de Apps na loja de aplicativos.
integer
Móvel
items.reviews_count
O número de avaliações do prestador de serviço.
string
Móvel
Finanças
Um resumo de dados financeiros de empresas, incluindo preços de ações, valor de mercado e outras métricas importantes.
Exemplo de HTML

baixo
O preço baixo para a data especificada.
float
Desktop
date
A data em que o valor patrimonial líquido foi reportado.
string
Desktop
alto
O preço alto para a data especificada
float
Desktop
abrir
O preço de abertura para a data especificada
float
Desktop
source
A URL do site de origem relevante do Google Finance.
string
Desktop
difference
A variação entre o valor patrimonial líquido reportado mais recentemente e o imediatamente anterior.
string
Desktop
market_cap
O valor total em dólares das ações em circulação de uma empresa
string
Desktop
stock_name
O nome da ação.
string
Desktop
52_week_low
O preço mínimo de 52 semanas
float
Desktop
52_week_high
O preço máximo de 52 semanas
float
Desktop
current_price
Cotação em tempo real.
string
Desktop
dividend_yield
A relação dividendo-preço de uma ação é o dividendo por ação dividido pelo preço por ação
float
Desktop
price_earning_ratio
A relação preço/lucro da ação
float
Desktop
Exemplo de JSON
Jogos esportivos
Informações sobre jogos esportivos recentes, detalhando placares, equipes, tipos de jogo e destaques.
Exemplo de HTML
games
Um array que fornece informações sobre vários jogos esportivos
array
Desktop
games.date
A data e hora em que o jogo está programado para acontecer ou quando ocorreu
string
Desktop
games.teams
As equipes envolvidas no jogo
array
Desktop
games.game_type
O tipo de jogo sendo disputado, como partida de temporada regular, jogo de playoffs, jogo de campeonato etc.
string
Desktop
games.highlight
Um link para destaques notáveis do jogo, como jogadas-chave, gols etc.
string
Desktop
games.teams.score
As pontuações ou pontos obtidos por cada equipe durante o jogo
string
Desktop
games.teams.winner
Especifica qual equipe venceu o jogo
booleano
Desktop
games.teams.team_name
Exibe os nomes das equipes envolvidas no jogo
string
Desktop
etapa
A fase ou etapa específica de uma competição ou torneio esportivo.
string
Desktop
liga
Refere-se à liga ou organização esportiva que supervisiona a competição
string
Desktop
Exemplo de JSON
Discussões e fóruns
Uma lista de tópicos de discussão e posts de fóruns com URLs, títulos, fontes e contagens de comentários.
Exemplo em HTML

itens
Um array de itens ou entradas dentro de um fórum ou tópico de discussão que o Google indexou
array
Desktop
items.pos
Um indicador que denota a posição de um determinado item entre todos os resultados de Discussões e Fóruns.
integer
Desktop
items.url
O link da URL para a publicação específica do fórum ou tópico de discussão
string
Desktop
items.title
O título ou cabeçalho da publicação do fórum ou do tópico de discussão
string
Desktop
items.source
A fonte que hospeda o fórum ou a discussão
string
Desktop
items.timeframe
O período ou a data da publicação do fórum ou da discussão
string
Desktop
items.comments_count
O número de comentários ou respostas que a publicação do fórum ou tópico de discussão recebeu
string
Desktop
pos_overall
Uma indicação da posição do recurso SERP Discussões e Fóruns dentro da SERP.
integer
Desktop
Exemplo de JSON
Atualizado
Isto foi útil?

