Obter os resultados certos de uma Google Search API depende principalmente dos parâmetros. Aqui está a referência completa, usando serp.cheap.
Todos os parâmetros
| Parâmetro | Tipo | Padrão | O que faz |
|---|---|---|---|
q | string | obrigatório | A consulta de pesquisa |
gl | string | "us" | País dos resultados (geolocalização) |
hl | string | padrão do país | Idioma de exibição/interface |
page | int | 1 | Página de resultados (começa em 1) |
tbs | string | nenhum | Filtro de tempo (qdr:h/qdr:d/qdr:w) |
gl — país (o que você mais vai usar)
gl decide qual Google você acessa e quais rankings regionais você recebe. Suportados: us, br, gb, de, fr, es, it, mx, ca, au, jp, nl.
-d '{"q": "beste elektroautos", "gl": "de"}' # Germany
-d '{"q": "melhores carros elétricos", "gl": "br"}' # Brazilhl — sobrescrita de idioma
gl já define um idioma padrão adequado. Use hl apenas quando quiser resultados em um idioma diferente do padrão do país:
-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}' # Canada, in Frenchtbs — filtro de tempo
Restrinja a resultados recentes — ótimo para notícias, monitoramento e tópicos em alta:
-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}' # past 24 hours| Valor | Janela |
|---|---|
qdr:h | Última hora |
qdr:d | Último dia |
qdr:w | Última semana |
page — paginação
Começa em 1; cada página é uma requisição cobrada separadamente. Veja como obter 100 resultados.
Juntando tudo
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"q": "mortgage rates", "gl": "us", "hl": "en", "page": 1, "tbs": "qdr:w"}'