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"
            }
        ]
    }'

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.

Parâmetro
Descrição
Valor Padrão

source

Define o scraper.

google_search

query

A palavra-chave ou frase a ser pesquisada.

-

render

Ativa a renderização JavaScript quando definido como html. Mais info.

-

parse

Retorna dados parseados quando definido como true. Explore a saída dicionário de dados.

false

callback_url

URL para o seu endpoint de callback. Mais info.

-

user_agent_type

Tipo de dispositivo e navegador. A lista completa pode ser encontrada aqui.

desktop

- 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 aquiarrow-up-right e aquiarrow-up-right. Veja um exemplo abaixo.

Localização

Adapte os resultados da pesquisa a localizações geográficas, domínios e idiomas específicos.

Parâmetro
Descrição
Valor Padrão

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 aquiarrow-up-right.

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.

-

context: results_language

Idioma dos resultados. A lista de idiomas suportados pelo Google pode ser encontrada aqui. Aprenda como usar parâmetros de contexto aqui.

-

Paginação

Controles para gerenciar a paginação e recuperação dos resultados de pesquisa.

Parâmetro
Descrição
Valor Padrão

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

circle-exclamation

Para usar esse recurso, inclua um array JSON com objetos JSON contendo os seguintes dados:

Parâmetro
Descrição
Exemplo

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.

Parâmetro
Descrição
Valor Padrão

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 aquiarrow-up-right.

-

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 aquiarrow-up-right.

-

circle-exclamation

Outros

Configurações avançadas adicionais e controles para requisitos especializados.

Parâmetro
Descrição
Valor Padrão

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.

chevron-rightgoogle_search saída estruturadahashtag
circle-info

A composição dos elementos pode diferir dependendo se foi uma desktop ou pesquisa mobile.

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.

circle-info

O número de itens e campos para um tipo de resultado específico pode variar dependendo da consulta de pesquisa.

Nome da Chave
Descrição
Tipo

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 aquiarrow-up-right.

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

circle-info

Nas seções seguintes, os trechos de código JSON parseado são encurtados 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 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.

Chave (results.pla)
Descrição
Tipo
Layout

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).

Chave (results.paid)
Descrição
Tipo
Layout

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.

Chave (results.images)
Descrição
Tipo
Layout

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

Chave (results.organic)
Descrição
Tipo
Layout

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.

Chave (results.organic_videos)
Descrição
Tipo
Layout

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.

Chave (results.top_sights)
Descrição
Tipo
Layout

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.

Chave (results.jobs)
Descrição
Tipo
Layout

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.

Chave (results.twitter)
Descrição
Tipo
Layout

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.

Chave (results.knowledge)
Descrição
Tipo
Layout

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.

Chave (results.local_pack)
Descrição
Tipo
Layout

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.

Chave (results.top_stories)
Descrição
Tipo
Layout

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.\

Chave (results.popular_products)
Descrição
Tipo
Layout

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.

Chave (results.related_searches)
Descrição
Tipo
Layout

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.

Chave (results.related_questions)
Descrição
Tipo
Layout

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.

Chave (results.what_people_are_saying)
Descrição
Tipo
Layout

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.

Chave (results.search_information)
Descrição
Tipo
Layout

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.

Chave (results.item_carousel)
Descrição
Tipo
Layout

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.

Chave (results.recipes)
Descrição
Tipo
Layout

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.

Chave (results.videos)
Descrição
Tipo
Layout

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

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.

Chave (results.featured_snippet)
Descrição
Tipo
Layout

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.

Chave (results.related_searches_categorized)
Descrição
Tipo
Layout

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.

Chave (results.hotels)
Descrição
Tipo
Layout

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.

Chave (results.flights)
Descrição
Tipo
Layout

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.

Chave (results.video_box)
Descrição
Tipo
Layout

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.

Chave (results.local_service_ads)
Descrição
Tipo
Layout

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.

Chave (results.apps)
Descrição
Tipo
Layout

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

Chave (results.finance)
Descrição
Tipo
Layout

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

Chave (results.sports_games)
Descrição
Tipo
Layout

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

Chave (results.discussions_and_forums)
Descrição
Tipo
Layout

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?