API de Pesquisa do Google

Obtenha resultados orgânicos, anúncios, buscas relacionadas, knowledge graph e mais da Pesquisa Google. Defina engine=google e envie uma string de busca para obter resultados estruturados que contornam captchas e proteções anti-bot.

Endpoint

GET https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`api_key`	string	sim	Sua chave de API do SERP
`engine`	string	sim	Deve ser `google`
`q`	string	sim	A consulta de busca
`cookie`	string	não	Cookie personalizado para a requisição. Deve ser URL encoded
`tbm`	string	não	Vertical de busca: `isch` (imagens), `vid` (vídeos), `nws` (notícias), `shop` (compras)
`sort_by`	string	não	Ordena os resultados por `relevance` ou `date`
`time_period`	string	não	`last_hour`, `last_day`, `last_week`, `last_month`, `last_year`, ou `custom`
`time_period_min`	string	não	Data mínima quando `time_period=custom`. Formato `MM/DD/YYYY`
`time_period_max`	string	não	Data máxima quando `time_period=custom`. Formato `MM/DD/YYYY`
`flatten_results`	int	não	`1` para simplificar os resultados, `0` caso contrário
`empty_results`	int	não	`0` para ocultar resultados vazios, `1` para exibi-los
`device`	string	não	`desktop`, `mobile`, ou `tablet`
`location`	string	não	Nome da localização para geotargeting
`google_domain`	string	não	Domínio do Google a ser usado (por exemplo `google.co.uk`)
`uule`	string	não	String de localização codificada do Google
`lr`	string	não	Restrição de idioma, formato `lang_xx`
`hl`	string	não	Código de idioma da interface
`gl`	string	não	Código do país
`start`	int	não	Deslocamento de resultados para paginação
`num`	int	não	Número de resultados por página
`ijn`	int	não	Número da página para o Google Imagens (100 imagens por página)
`safe`	string	não	Busca segura: `active` ou `off`
`filter`	int	não	Filtro de resultados semelhantes e omitidos: `1` ativado, `0` desativado
`nfpr`	int	não	`1` para excluir consultas com correção automática, `0` caso contrário
`tbs`	string	não	Parâmetros avançados de busca (patentes, datas, etc.)
`ludocid`	string	não	CID do Google Meu Negócio (Place ID)
`lsig`	int	não	Força a exibição em mapa do Knowledge Graph

Exemplo de requisição

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=history"

import requests

params = {
    "engine": "google",
    "api_key": "YOUR_API_KEY",
    "q": "history",
}
r = requests.get("https://serp.shifter.io/v1", params=params)
data = r.json()

import fetch from 'node-fetch';

const url = 'https://serp.shifter.io/v1?' + new URLSearchParams({
  engine: 'google',
  api_key: 'YOUR_API_KEY',
  q: 'history',
});
const data = await (await fetch(url)).json();

Exemplo de resposta

{
  "search_metadata": {
    "id": "...",
    "status": "Success",
    "created_at": "2024-01-01T00:00:00Z"
  },
  "search_parameters": {
    "engine": "google",
    "q": "history",
    "google_domain": "google.com",
    "device": "desktop"
  },
  "search_information": {
    "total_results": 10500000000,
    "time_taken_displayed": 0.52
  },
  "organic_results": [
    {
      "position": 1,
      "title": "History - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/History",
      "displayed_link": "https://en.wikipedia.org > wiki > History",
      "snippet": "History is the systematic study of the past..."
    }
  ],
  "related_searches": [ { "query": "world history" } ],
  "pagination": { "current": 1, "next": "..." }
}

Começar

Proxies

APIs

Recursos