API de Busca do Google com curl: Referência Rápida (2026)

A forma mais rápida de testar uma API de Busca do Google é a partir do seu terminal. Os exemplos usam o serp.cheap.

Requisição básica

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

Filtros de país e de tempo

# Resultados do Brasil, últimas 24 horas
curl https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"q": "eleições", "gl": "br", "tbs": "qdr:d"}'

Veja todas as opções em parâmetros da API de Busca do Google.

Formatar e extrair com o jq

# Apenas os links orgânicos
curl -s https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"q": "serp api curl", "gl": "us"}' | jq -r '.organic[].link'

# Título + link como TSV
... | jq -r '.organic[] | [.position, .title, .link] | @tsv'

# Quanto custou esta chamada?
... | jq '.stats'

Paginação

for p in 1 2 3; do
  curl -s https://api.serp.cheap/v1/search \
    -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
    -d "{\"q\": \"serp api\", \"page\": $p}" | jq -r '.organic[].link'
done

Mantenha sua chave em uma variável de ambiente (-H "X-API-Key: $SERP_KEY") em vez de colá-la nos scripts.

A seguir

• Guia completo: como usar a API de Busca do Google

• Em código: Python · Node.js

• Obtenha uma chave de API →