Como faço para chamar uma Google Search API?

Envie uma requisição POST autenticada com sua consulta. Com serp.cheap: POST https://api.serp.cheap/v1/search, cabeçalho X-API-Key, corpo JSON como {"q": "...", "gl": "us"}. A resposta é um JSON com um array organic[] de resultados.

Posso chamar uma Google Search API a partir do navegador?

Não — nunca exponha sua chave de API em código do lado do cliente. Sempre encaminhe as requisições pelo seu próprio backend para que a chave permaneça secreta.

Como manter baixos os custos da Google Search API?

Apoie-se no cache (consultas repetidas são servidas pela metade do preço no serp.cheap), busque páginas adicionais apenas quando necessário e acompanhe o stats.cost por chamada.

Como Usar uma Google Search API em 2026: Guia Completo

Este é o guia prático e de ponta a ponta para usar uma Google Search API: autenticar, enviar uma consulta, ler o JSON, paginar, tratar erros e manter os custos baixos. Os exemplos usam o serp.cheap (a opção mais barata em 2026), mas os conceitos se aplicam a qualquer SERP API.

1. Obtenha uma chave de API

Crie uma conta gratuita em app.serp.cheap — 100 buscas grátis, sem cartão de crédito. Você recebe uma chave de API que passa no cabeçalho X-API-Key. Os créditos são válidos por 12 meses. (Também disponível via Apify ou RapidAPI, se preferir.)

2. O endpoint em uma linha

POST https://api.serp.cheap/v1/search

Parâmetro	Padrão	Descrição
`q`	obrigatório	A consulta de busca
`gl`	`"us"`	País (ex.: `br`, `gb`, `de`)
`hl`	padrão do país	Substituição do idioma da interface
`page`	`1`	Página de resultados (indexada a partir de 1)
`tbs`	nenhum	Filtro de tempo: `qdr:h`, `qdr:d`, `qdr:w`

Referência completa: parâmetros da Google Search API.

3. Sua primeira requisição

curl https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "best electric cars 2026", "gl": "us", "page": 1}'

import requests

r = requests.post(
    "https://api.serp.cheap/v1/search",
    headers={"X-API-Key": "YOUR_KEY"},
    json={"q": "best electric cars 2026", "gl": "us", "page": 1},
)
r.raise_for_status()
data = r.json()
for item in data["organic"]:
    print(item["position"], item["title"], item["link"])

Guias por linguagem: Python · Node.js · PHP · Go · curl.

4. Leia a resposta

{
  "search": "best electric cars 2026",
  "page": 1,
  "organic": [
    {
      "position": 1,
      "title": "Best Electric Cars of 2026",
      "link": "https://example.com/best-evs",
      "snippet": "We tested every major EV...",
      "date": "Jan 10, 2026"
    }
  ],
  "stats": { "balance": 99994, "cost": 6, "cached": false }
}

O stats.cost é em créditos (1 crédito = $0.0001). Uma busca nova custa 6 créditos ($0.0006); um acerto de cache custa 3 ($0.0003). O stats.cached informa qual caminho você obteve.

5. Paginação

Cada página é uma requisição separada — incremente o page. Busque a página 2 ou seguintes apenas quando um usuário realmente precisar. Veja como obter 100 resultados.

6. Tratamento de erros

401 — chave de API inválida/ausente.
402 — sem créditos; recarregue.
429 — limite de taxa atingido (60 req/min, ou 1 req/s, no plano gratuito; 600 req/min, ou 10 req/s, no pré-pago; até 60 req/s nos planos superiores); reduza a frequência e tente novamente.
5xx — transitório; tente novamente com backoff exponencial.

Sempre envolva as chamadas em um retry com backoff para 429/5xx.

7. Mantenha barato

Acertos de cache custam a metade — não force buscas novas para consultas repetidas.
Pagine de forma preguiçosa (lazy).
Escolha o gl com precisão para evitar reexecuções.

Próximos passos

Construa algo real: um rastreador de posições em Python ou Google Search para agentes de IA.
Compare provedores: SERP API mais barata em 2026.
Obtenha sua chave de API no Apify →