Local, idioma e dispositivo

O Google responde à mesma busca de forma diferente por país, idioma, cidade e dispositivo. Quatro parâmetros escolhem qual versão você recebe.

gl · hl · location · device

Nome	O que faz
`gl`	País dos resultados, com código de duas letras: us, gb, de, jp…
`hl`	Idioma da página: en, de, ja, pt-BR… Combine com o gl do mesmo mercado.
`location`	Busca como se estivesse em uma cidade ou região, ex. "Munich,Bavaria,Germany". Só resultados mobile; os nomes vêm de GET /google/locations.
`device`	mobile (padrão) ou pc. Os layouts diferem: alguns blocos só aparecem em um deles.

gl e hl valem para a maioria dos endpoints do Google; device e location para o Google Web Search. A tabela de parâmetros de cada endpoint diz o que ele aceita. Nenhum muda o preço.

BASH

curl -X POST https://api.serpbase.dev/google/search \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "coffee shops", "gl": "de", "hl": "de", "location": "Munich,Bavaria,Germany"}'

Locais de busca

Consulta os valores aceitos pelo parametro location do Google Search. O canonical_name de cada resultado pode ser enviado como location em /google/search. Esta solicitacao nao consome creditos.

GET

0 credits

/google/locations?q=munich&country_code=de&limit=5

q (obrigatorio) corresponde ao nome ou nome canonico sem diferenciar maiusculas; country_code filtra pelo codigo ISO 3166-1 alfa-2; limit vai de 1 a 100 (padrao 20). Nomes exatos primeiro, depois locais mais amplos. Muitos locais tem o mesmo nome (Paris, Franca e Paris, Texas), entao use country_code para achar o certo. Envie a chave no cabecalho X-API-Key.

BASH

curl "https://api.serpbase.dev/google/locations?q=munich&country_code=de&limit=2" \
  -H "X-API-Key: your_api_key"

curl -X POST https://api.serpbase.dev/google/search \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"q":"crossfit software","gl":"de","hl":"de","device":"mobile","location":"Munich,Bavaria,Germany"}'

JSON

{
  "status": 0,
  "locations": [
    {
      "canonical_name": "Munich,Bavaria,Germany",
      "name": "Munich",
      "country_code": "DE",
      "target_type": "City"
    },
    {
      "canonical_name": "Taufkirchen,Munich,Bavaria,Germany",
      "name": "Taufkirchen",
      "country_code": "DE",
      "target_type": "City"
    }
  ]
}

Pais (valor de location)	gl	Exemplo de cidade
United States	us	New York,New York,United States
United Kingdom	gb	London,England,United Kingdom
Germany	de	Munich,Bavaria,Germany
Austria	at	Vienna,Vienna,Austria
Switzerland	ch	Zurich,Zurich,Switzerland
France	fr	Paris,Ile-de-France,France
Italy	it	Milan,Lombardy,Italy
Spain	es	Madrid,Community of Madrid,Spain
Poland	pl	Warsaw,Masovian Voivodeship,Poland
Canada	ca	Toronto,Ontario,Canada
Australia	au	Sydney,New South Wales,Australia
Japan	jp	Tokyo,Tokyo,Japan
Indonesia	id	Jakarta,Jakarta,Indonesia
Philippines	ph	Manila,Metro Manila,Philippines
Brazil	br	Sao Paulo,State of Sao Paulo,Brazil
Mexico	mx	Mexico City,Mexico City,Mexico

Limitado a 60 consultas por minuto por conta. Um location fora da lista e ignorado em vez de rejeitado: a busca segue sem ele. location so tem efeito em buscas mobile (device mobile, o padrao).