Google Web Search — Referência da API

POST

Disponível

/google/search

Search

Busque Google com q, idioma hl, país gl e dispositivo aceito. As seções dependem da consulta e da origem.

type

result

organic

Cobranca

1 credits

Busque Google com q, idioma hl, país gl e dispositivo aceito. As seções dependem da consulta e da origem.

Parametros

CampoTipoDisponibilidadeDescricao

q

obrigatorio

string

obrigatorio

Texto da busca.

hl

opcional

string

opcional

Codigo de idioma. Padrao: en.

gl

opcional

string

opcional

Codigo do pais. Padrao: us.

page

opcional

number

opcional

Numero da pagina a partir de 1. Padrao: 1.

device

opcional

"default" | "pc" | "mobile"

opcional

Somente para Google Search. default usa roteamento automatico, pc usa sessoes desktop e mobile usa sessoes mobile.

json

{
  "device": "mobile",
  "gl": "us",
  "hl": "en",
  "q": "coffee shops"
}

Abrir no Playground

Campos da resposta

CampoTipoDisponibilidadeDescricao

query

obrigatorio

string

obrigatorio

Consulta normalizada da requisicao.

page

obrigatorio

number

obrigatorio

Numero da pagina atual a partir de 1.

organic

opcional

OrganicResult[]

Quando resultados orgânicos são analisados.

Resultados orgânicos.

featured_snippet

opcional

FeaturedSnippet

Quando Google mostra um trecho em destaque.

Cartão de resposta em destaque, separado dos resultados orgânicos.

top_stories

opcional

TopStory[]

Quando há notícias em destaque nos resultados.

Módulo de notícias em destaque.

people_also_ask

opcional

PAA[]

Quando há perguntas relacionadas.

Pergunta, resposta e links de origem.

knowledge_graph

opcional

KnowledgeGraph

Quando um painel de conhecimento é analisado.

Dados do painel da entidade.

related_searches

opcional

string[]

Quando há sugestões relacionadas.

Consultas relacionadas.

OrganicResult Schema do item

CampoTipoDisponibilidadeDescricao

rank

obrigatorio

number

obrigatorio

Posicao no ranking a partir de 1 nesta resposta.

position

opcional

number

Alias de rank quando disponivel.

Alias normalizado para clientes que esperam position.

title

obrigatorio

string

obrigatorio

Titulo do resultado.

link

obrigatorio

string

obrigatorio

Link principal retornado pelo parser.

url

opcional

string

Presente quando o link pode ser normalizado.

URL canonica de destino, normalmente igual a link.

source_url

opcional

string

Somente quando uma URL fonte do Google e observada.

URL original do Google para depuracao e procedencia.

display_url

opcional

string

Quando texto visivel ou dominio pode ser derivado.

URL visivel ou dominio de origem.

display_link

opcional

string

Quando há texto exibido pelo Google.

Texto original do link exibido pelo Google.

snippet

opcional

string

Quando um trecho é analisado.

Resumo do resultado orgânico.

date

opcional

string

Quando Google inclui data no trecho.

Texto original da data extraído do trecho.

published_at

opcional

string

Alias da data analisada, se existir.

Alias da data normalizada.

icon

opcional

string

Quando um favicon ou imagem é exposto.

URL do ícone do resultado.

sitelinks

opcional

{ title, link, url, source_url?, display_url? }[]

Quando há links de site.

Links de site aninhados do resultado.

Exemplos de código e resposta

bash

curl -X POST 'https://api.serpbase.dev/google/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"device":"mobile","gl":"us","hl":"en","q":"coffee shops"}'

Exemplo existente do Google

bash

curl -X POST https://api.serpbase.dev/google/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "python asyncio",
    "hl": "en",
    "gl": "us",
    "page": 1,
    "device": "default"
  }'

Notas

Grounding, SEO e extracao de respostas.

Também pode retornar ai_overview, weather, finance, flight e result_stats se aparecerem nos resultados.