Pesquisa na Web
Scraper completo de Google Search com dados analisados para resultados orgânicos, anúncios, snippets, painéis de conhecimento, top stories e mais.
O google_search esta fonte é projetada para recuperar resultados do Google Search (SERPs) e Google AI Overviews. Esta subpágina apresenta especificamente informações relacionadas à Pesquisa Web do Google. Para explorar outros tipos de resultado, leia Pesquisa por Imagem ou Pesquisa de Notícias.
Amostras de requisição
Nos exemplos abaixo, fazemos uma solicitação para obter 2 páginas de resultados, do número 11 até o número 12 , para o termo de pesquisa adidas em google.nl domínio. O SERP será filtrado para conter apenas resultados em francês. A API retornará resultados parseados.
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
"source": "google_search",
"domain": "nl",
"query": "adidas",
"start_page": 11,
"pages": 2,
"parse": true,
"context": [
{
"key": "results_language",
"value": "fr"
}
]
}'import requests
from pprint import pprint
# Estruturar payload.
payload = {
'source': 'google_search',
'domain': 'nl',
'query': 'adidas',
'start_page': 11,
'pages': 2,
'parse': True,
'context': [
{'key': 'results_language', 'value': 'fr'},
],
}
# Obter resposta.
response = requests.request(
'POST',
'https://realtime.oxylabs.io/v1/queries',
auth=('USERNAME', 'PASSWORD'),
json=payload,
)
# Imprimir a resposta formatada no stdout.
pprint(response.json())Usamos o método de integração síncrono Realtime em nossos exemplos. Se você quiser usar Proxy Endpoint ou integração assíncrona Push-Pull consulte os métodos de integração da seção.
Valores dos parâmetros da requisição
Genérico
Configuração básica e opções de personalização para raspar resultados da Pesquisa Web do Google.
source
Define o scraper.
google_search
query
A palavra-chave ou frase a ser pesquisada.
-
- 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 query. Isso permite personalizar o escopo da busca, garantindo que os resultados sejam mais relevantes e focados. Explore esses comandos especiais aqui e aqui. Veja um exemplo abaixo.
Localização
Adapte os resultados da pesquisa a localizações geográficas, domínios 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 sugeridas geo_location estruturas de parâmetro aqui.
-
domínio
Localização de domínio para o Google. A lista completa de domínios disponíveis pode ser encontrada aqui.
com
locale
Accept-Language valor do cabeçalho que altera o idioma da interface web da sua página de pesquisa do Google. Mais info.
-
Paginação
Controles para gerenciar a paginação e recuperação dos resultados de pesquisa.
start_page
Número da página inicial.
1
pages
Número de páginas a recuperar.
1
limit
Número de resultados a recuperar em cada página.
10
context:limit_per_page
Raspe múltiplas páginas usando o mesmo endereço IP e sessão (conjunto de cookies). Especificando os números das páginas em um array JSON com a page chave e indicando o número de resultados orgânicos por página usando a limit chave, você pode minimizar a chance de ver resultados orgânicos sobrepostos entre páginas (por exemplo, o último resultado orgânico da primeira página sendo o mesmo que o primeiro da segunda página). Veja exemplo.
-
Suporte a rolagem contínua
A Web Scraper API suporta totalmente a rolagem contínua da Pesquisa Google. Ela detecta automaticamente layouts de rolagem contínua, carregando eficientemente os resultados orgânicos solicitados sem parâmetros extras necessários.
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 esse recurso, inclua um array JSON com objetos JSON contendo os seguintes dados:
page
O número da página que você gostaria de 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 (inclusivo) funcionará.
90
Solicitar exemplo
Filtragem
Opções para filtrar e refinar resultados de pesquisa com base em vários critérios. Aprenda como usar parâmetros de contexto aqui.
context:
filter
Definir o valor deste parâmetro como 0 permite ver resultados que seriam excluídos devido à similaridade com outros resultados.
1
context:
safe_search
Safe search. Defina como true para habilitá-lo.
false
context:
udm
udm parâmetro permite alternar entre diferentes abas de pesquisa, como imagens, lugares 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 do Google menos usuais, como limitar/ordenar resultados por data, além de outros filtros, alguns dos quais dependem do tbm parâmetro (por exemplo tbs=app_os:1 só está disponível com tbm value app). Mais informações aqui.
-
udm e tbm parâmetros de contexto não podem ser usados juntos em uma única solicitação de scraping; selecione apenas um. Usar ambos simultaneamente pode levar a conflitos ou comportamento inesperado.
Outros
Configurações avançadas adicionais e controles para requisitos especializados.
context:
fpstate
Definir o fpstate valor para aig fará o Google carregar mais apps. Este parâmetro só é útil se usado junto com o render parâmetro.
-
context:
nfpr
true desativará a autocorreção ortográfica
false
Parâmetros de contexto
Todos os parâmetros de contexto devem ser adicionados ao context array como objetos com key e value pares, por exemplo:
Dados estruturados
A Web Scraper API é capaz de extrair um objeto HTML ou JSON que contém os resultados de pesquisa do Google, oferecendo dados estruturados sobre vários elementos da página de resultados.
Para ajudá-lo a identificar certos elementos, consulte os dicionários de dados para cada tipo de resultado de pesquisa do Google, obtido em buscas desktop ou mobile.
Dicionário de dados de saída
Navegue pelos detalhes usando a navegação do lado direito ou rolando a página para baixo.
Exemplo em HTML
Estrutura JSON
A saída estruturada da Pesquisa Web do Google inclui campos como URL, page, results, entre outros. A tabela abaixo apresenta uma lista detalhada de cada recurso do SERP que parseamos, junto com sua descrição e tipo de dado. A tabela também inclui alguns metadados.
url
A URL da página de pesquisa do Google.
string
page
Número da página relativo à paginação do SERP do Google.
integer
results
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 imagem 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_box
Um único item de vídeo com seus respectivos detalhes.
object
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 negócios locais relevantes para a pesquisa.
object
results.item_carousel
Uma lista de itens ilustrativos para consultas informacionais com seus respectivos detalhes.
object
results.videos
Uma lista de vídeos com seus respectivos detalhes.
object
results.related_searches_categorized
Uma lista de pesquisas relacionadas que outras pessoas fizeram.
array
results.hotels
Uma lista de hotéis relevantes para a localização usada na consulta de pesquisa.
object
results.apps
Uma lista de aplicações com seus respectivos detalhes.
array
results.finance
Um resumo de dados financeiros de empresas, incluindo preços de ações, capitalização de mercado e outras métricas-chave.
object
results.sports_games
Informações sobre jogos esportivos recentes, detalhando placares, times, tipos de jogo e destaques.
object
results.discussions_and_forums
Uma lista de tópicos de discussão e postagens em 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 dos SERPs.
array
results.top_stories
Uma lista de artigos com seus respectivos detalhes quando uma consulta de pesquisa é identificada como orientada a notícias.
object
results.popular_products
Uma lista de exibições orgânicas e não pagas 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 apresentadas em diferentes posições na página de pesquisa.
array
results.related_questions
Uma lista de consultas interrogativas relacionadas com seus respectivos detalhes.
object
results.what_people_are_saying
Uma lista de tópicos de discussão e postagens em fóruns com URLs, títulos, fontes, principais comentários, nível de engajamento e intervalos de tempo.
array
results.search_information
Uma lista de detalhes para a consulta de pesquisa submetida.
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 por rolagem).
integer
parse_status_code
O código de status do trabalho de parsing. Você pode ver os códigos de status do parser descritos aqui.
integer
created_at
O timestamp quando o trabalho de scraping foi criado.
timestamp
updated_at
O timestamp quando o trabalho de scraping foi finalizado.
timestamp
job_id
O ID do job 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 decompor o conteúdo HTML.
string
Anúncios de Listagem de Produtos (PLA)
O pla a seção dos resultados de pesquisa refere-se a Anúncios de Listagem de Produtos, também conhecidos como Google Shopping Ads, exibidos em destaque no topo da página de pesquisa em formato de carrossel.
items
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 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 PLA SERP dentro do SERP.
integer
Desktop e Mobile
Pago
O pago 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 contendo informações sobre links internos para um site que aparecem sob o 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 elemento de sitelinks.
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 do SERP.
integer
Desktop e Mobile
Imagens
O images seção refere-se a resultados de imagem exibidos em diferentes seções de uma página SERP, seja como seção dedicada ou no topo. É importante notar que a estrutura dos dados raspados dos resultados de Pesquisa Google pode diferir da dos resultados do Google Imagens.
items
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 único que denota a posição da imagem na lista.
integer
Desktop e Mobile
items.url
A URL da página web que contém a imagem.
string
Desktop e Mobile
pos_overall
Uma indicação da posição do recurso Images dentro do SERP.
integer
Desktop e Mobile
Orgânico
O organic seção refere-se a listagens não pagas nos resultados orgânicos do Google, determinadas pela relevância através 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 codificadas em base64 do resultado orgânico.
string
Desktop e Mobile
sitelinks
Objeto contém 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 de 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 do 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 de produtos, opções de entrega, políticas de devolução.
lista de strings
Desktop
Vídeos Orgânicos
O results.organic_videos contém um array de listagens de vídeo que são exibidas organicamente nos resultados de pesquisa, ou seja, não são anúncios pagos. Cada listagem de vídeo inclui detalhes relevantes como o 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 do SERP.
integer
Desktop
Pontos Turísticos Principais
O results.top_sights contém uma lista de marcos ou atrações proeminentes normalmente associadas ao local de pesquisa ou tópico. Cada item inclui detalhes como a posição na lista e o título.
items
Uma lista das principais atrações com seus respectivos detalhes.
array
Desktop
items.pos
A posição do resultado Top Sights dentro do recurso Top Sights.
integer
Desktop
items.title
O título da atração turística.
string
Desktop
pos_overall
Uma indicação da posição do resultado Top Sights dentro do SERP.
integer
Desktop
Empregos
O results.jobs contém listagens de emprego extraídas dos resultados de pesquisa. Cada listagem inclui detalhes como a URL que direciona para a vaga, título do cargo, fonte, empregador e localização. As listagens são originadas de vários sites de emprego, portais de carreira e outras plataformas indexadas pelo Google.

listings
Um array de todas as listagens de emprego disponíveis na página.
array
Desktop
listings.url
A URL para a listagem de emprego completa.
string
Desktop
listings.title
O título da posição de trabalho.
string
Desktop
listings.source
A fonte que contém a postagem original da vaga.
string
Desktop
listings.employer
A organização que está 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 Jobs dentro do SERP.
integer
Desktop
Twitter (X)
O twitter recurso frequentemente aparece 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 contendo as postagens do Twitter (X).
string
Desktop
items
Uma lista de postagens do Twitter (X) com seus respectivos detalhes.
array
Desktop
items.pos
Um indicador que denota a posição de um tweet dentro do recurso Twitter (X).
string
Desktop
items.url
A URL da postagem do Twitter (X).
string
Desktop
items.content
Uma breve descrição que representa todo o texto da postagem 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 do SERP.
integer
Desktop
Conhecimento
O knowledge seção dentro dos resultados de pesquisa mostra os dados do Painel de Conhecimento do Google no lado direito ao pesquisar por 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 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.
array
Desktop e Mobile
factoids.links.href
Um hyperlink para a página de resultados de Pesquisa Google para o fato especificado.
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ídias sociais 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 denota 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 pesquisa relacionada.
string
Desktop
related_searches.section_title
O nome da seção de pesquisas relacionadas.
string
Desktop
Local Pack
O local_pack exibe os três principais resultados locais com base na localização do usuário ou na localização de pesquisa especificada, incluindo um mapa e informações adicionais.
items
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 de empresa específica.
string
Desktop e Mobile
items.pos
A posição do resultado local dentro do local pack.
integer
Desktop e Mobile
items.title
O título da entidade local.
string
Desktop e Mobile
items.rating
A avaliaçã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 recurso Local Pack dentro do SERP.
integer
Desktop e Mobile
Top Stories
top_stories é uma seção dedicada que aparece na Pesquisa Google para consultas orientadas a notícias.

items
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 Top Stories.
integer
Desktop e Mobile
items.url
A URL para o artigo completo.
string
Desktop e Mobile
items.title
O título do artigo.
string
Desktop e Mobile
items.section
O nome da seção Top Stories.
string
Mobile
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 Top Stories dentro do SERP.
integer
Desktop e Mobile
Produtos Populares
O popular_products 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 Product Listing Ads (PLAs), que são influenciados por anunciantes. Vale notar que múltiplos popular_products carrosseis podem aparecer em uma única página SERP.\
items
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 dentro do recurso Popular Products.
integer
Desktop e Mobile
items.price
O preço de um dado produto popular.
string
Desktop e Mobile
items.title
O título de um dado produto popular.
string
Desktop e Mobile
items.rating
A avaliação de um dado produto popular.
string
Desktop
items.seller
O vendedor de um dado produto popular.
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 Popular Products dentro do SERP.
integer
Desktop e Mobile
Pesquisas Relacionadas
O related_searches recurso SERP exibe consultas de pesquisa alternativas relacionadas à palavra-chave inicial, tipicamente localizada 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 pesquisas relacionadas dentro deste bloco.
array
Desktop e Mobile
Perguntas Relacionadas
O related_questions recurso está posicionado abaixo dos principais resultados de pesquisa, apresentando uma lista de perguntas diretamente relacionadas à consulta original do usuário. Ao oferecer um conjunto selecionado de perguntas relacionadas, os usuários podem explorar diferentes aspectos do tópico, melhorando sua experiência de pesquisa.

items
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 Related Questions.
integer
Desktop e Mobile
items.answer
A resposta à pergunta relacionada.
string
Desktop e Mobile
items.source
Contém valores descrevendo a fonte da resposta à pergunta.
object
Desktop e Mobile
items.source.url
A URL do site usado 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 Related Questions dentro do SERP.
integer
Desktop e Mobile
O que as pessoas estão dizendo
O what_people_are_saying seção aparece nos resultados de pesquisa do Google quando há publicações relevantes de fóruns, mídias sociais ou plataformas comunitárias relacionadas à consulta de pesquisa. Esta seção normalmente mostra conteúdo de plataformas como Reddit, TikTok e outros fóruns de discussão.

items
Uma lista contendo todos os itens de conteúdo de fóruns de discussão ou mídias sociais.
array
Desktop e Mobile
items.url
A URL do tópico de discussão ou da página de conteúdo de mídia social.
integer
Desktop e Mobile
items.title
O título do tópico de discussão ou peça de 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 (ex.: "45 comentários, há 2 dias").
string
Desktop e Mobile
Informações da Pesquisa
O search_information recurso fornece informações estruturadas sobre a consulta de pesquisa.

query
O termo de pesquisa original.
string
Desktop e Mobile
geo_location
*Funciona apenas com renderização JS
Indica a área geográfica específica associada à pesquisa.
string
Desktop
showing_results_for
O termo de pesquisa para o qual os resultados são exibidos. `query` e `showing_results_for` podem diferir 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
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 do usuário, exibindo 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.
items
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 item no Google.
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
Indicação da posição do resultado Item Carousel dentro do SERP.
integer
Desktop
Receitas
O receitas Recurso do SERP no Google que apresenta instruções de preparo, ingredientes, avaliações e fontes para pratos específicos no topo dos resultados de busca.
items
Uma lista de receitas selecionadas com seus respectivos detalhes.
array
Desktop e Mobile
items.pos
A posição da receita dentro do recurso Recipes do SERP.
integer
Desktop e Mobile
items.url
A URL para a receita completa.
string
Desktop e Mobile
items.desc
Uma descrição curta da receita obtida a partir do artigo original.
string
Desktop
items.title
O título da receita.
string
Desktop e Mobile
items.rating
A avaliaçã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
Indicação da posição do resultado Recipes dentro do SERP.
integer
Desktop e Mobile
Vídeos
O videos Recurso na página de resultados do Google que exibe uma seleção curada de conteúdo em vídeo relacionado à consulta do usuário, incluindo miniaturas, títulos e informações da fonte.
items
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
Indicação da posição do resultado Videos dentro do SERP.
integer
Desktop e Mobile
Featured Snippet
O featured_snippet é um resultado de busca do Google onde um trecho conciso descrevendo uma página é mostrado antes de um link para essa página. Esses resultados em destaque são exibidos de forma proeminente no topo dos resultados orgânicos, fornecendo acesso rápido a informações relevantes.

url
A URL do site de onde o trecho descritivo da página é recuperado.
string
Desktop e Mobile
desc
O trecho contendo uma descrição para um resultado de busca específico.
string
Desktop e Mobile
title
O nome do artigo de onde o trecho descritivo da página é recuperado.
string
Desktop e Mobile
url_shown
A URL do site que contém o featured snippet visível no SERP.
string
Desktop e Mobile
pos_overall
Indicação da posição do resultado Featured Snippet dentro do SERP.
integer
Desktop e Mobile
Pesquisas relacionadas categorizadas
related_searches_categorized exibe especificamente buscas relacionadas a listas. Ao contrário das pesquisas relacionadas gerais, que abrangem todas as consultas de usuários, esse recurso fornece um conjunto focado de consultas relacionadas a listas. Normalmente encontrado na parte inferior da página de resultados de busca, serve como uma fonte direcionada de palavras-chave relacionadas ao termo de busca principal.

items
Uma lista contendo todos os itens de pesquisas relacionadas recuperados 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 relacionada renderizado no navegador.
string
Desktop
categoria
Um objeto contendo mais detalhes sobre a categoria dos resultados de pesquisas relacionadas.
object
Desktop
category.name
O nome da categoria.
string
Desktop
category.type
O tipo da seção de pesquisas relacionadas.
string
Desktop
pos_overall
Indicação da posição do resultado Related Searches Categorized dentro do SERP.
integer
Desktop
Hotéis
Google hotels é um recurso que exibe informações de hotéis diretamente nos resultados de busca. Quando os usuários pesquisam por hotéis ou consultas relacionadas a hospedagem no Google, o mecanismo de busca pode apresentar um módulo dedicado de hotéis no topo da página de resultados, oferecendo uma visão conveniente e proeminente das opções relevantes.
date_to
A data do check-out.
string
Desktop
results
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
Indicação da posição do resultado Hotels dentro do SERP.
integer
Desktop
Voos
O flights recurso que apresenta um bloco contendo opções de voo organizadas associadas a uma consulta relevante, permitindo que os usuários comparem opções diretamente nos resultados de busca.

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
results
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 de 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
Indicação da posição do resultado Flights dentro do SERP.
integer
Desktop e Mobile
Caixa de Vídeo
O video_box recurso que destaca um resultado de vídeo específico no topo da página de resultados de busca, escolhido pelo Google como o mais relevante para a consulta.
url
A URL do vídeo.
string
Desktop e Mobile
title
O título do vídeo.
string
Desktop e Mobile
pos_overall
Indicação da posição do resultado Video Box dentro do SERP.
integer
Desktop e Mobile
Anúncios de Serviços Locais
O local_service_ads recurso que permite a profissionais orientados a serviços, como encanadores, eletricistas, chaveiros e outros provedores locais, promoverem seus serviços na página de resultados do Google Search.
items
Uma lista de prestadores de serviços com seus respectivos detalhes.
array
Desktop
items.pos
A posição do anúncio de serviço dentro do recurso Local Services Ads do SERP.
integer
Desktop
items.url
Um link para o serviço na página de pesquisa Local Services.
string
Desktop
items.title
O título do prestador de serviços.
string
Desktop
items.rating
A avaliação do prestador de serviços.
integer
Desktop
items.reviews_count
O número de avaliações do prestador de serviços.
integer
Desktop
items.google_guaranteed
Selo do Google fornecido a empresas que passam por um processo de triagem e verificação do Google. Valores disponíveis são "true" ou "false".
boolean
Desktop
pos_overall
Indicação da posição do resultado Local Service Ads dentro do SERP.
integer
Desktop
Aplicativos
O apps Recurso do SERP que exibe aplicativos relevantes com base na consulta do usuário, fornecendo detalhes-chave como preço, avaliação e mais. Esse recurso serve como uma plataforma valiosa para desenvolvedores e publicadores aumentarem a visibilidade e o engajamento de seus aplicativos móveis diretamente na página de resultados do Google Search.

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

mínimo
O preço mínimo para a data especificada.
float
Desktop
data
A data em que o valor patrimonial líquido foi reportado.
string
Desktop
máximo
O preço máximo para a data especificada
float
Desktop
abertura
O preço de abertura para a data especificada
float
Desktop
source
A URL para o site relevante do Google Finance.
string
Desktop
diferença
A variação entre o valor patrimonial líquido mais recentemente reportado 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
nome_da_ação
O nome da ação.
string
Desktop
mínimo_52_semanas
O preço mínimo em 52 semanas
float
Desktop
máximo_52_semanas
O preço máximo em 52 semanas
float
Desktop
preço_atual
Cotação de preç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
Amostra JSON
Jogos esportivos
Informações sobre jogos esportivos recentes, detalhando placares, times, tipos de jogo e destaques.
Exemplo em HTML
jogos
Um array que fornece informações sobre diversos jogos esportivos
array
Desktop
games.date
A data e hora em que o jogo está agendado para ocorrer ou quando ocorreu
string
Desktop
games.teams
As equipes envolvidas no jogo
array
Desktop
games.game_type
O tipo de jogo disputado, como partida de temporada regular, jogo de playoff, final, etc.
string
Desktop
games.highlight
Um link para os principais destaques do jogo, como jogadas importantes, gols, etc.
string
Desktop
games.teams.score
Os placares ou pontos obtidos por cada equipe durante o jogo
string
Desktop
games.teams.winner
Especifica qual equipe venceu o jogo
boolean
Desktop
games.teams.team_name
Exibe os nomes das equipes envolvidas no jogo
string
Desktop
fase
A fase ou etapa específica de uma competição ou torneio esportivo.
string
Desktop
liga
Refere-se à liga esportiva ou organização que supervisiona a competição
string
Desktop
Amostra JSON
Discussões e fóruns
Uma lista de tópicos de discussão e postagens em fóruns com URLs, títulos, fontes e contagens de comentários.
Amostra HTML

items
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 denotando a posição de um dado item entre todos os resultados de Discussões e Fóruns.
integer
Desktop
items.url
O link URL para a postagem específica do fórum ou tópico de discussão
string
Desktop
items.title
O título ou manchete da postagem do fórum ou tópico de discussão
string
Desktop
items.source
A fonte que hospeda o fórum ou discussão
string
Desktop
items.timeframe
O período de tempo ou data da postagem do fórum ou discussão
string
Desktop
items.comments_count
O número de comentários ou respostas que a postagem do fórum ou tópico de discussão recebeu
string
Desktop
pos_overall
Indicação da posição do recurso Discussions and Forums dentro do SERP.
integer
Desktop
Amostra JSON
Atualizado
Isto foi útil?

