Localizações

Para a maioria das solicitações SERP, uma string livre location= é suficiente. Quando você precisa de segmentação canônica em nível de cidade, correspondida com a própria taxonomia de localização do Google, use a Locations API para resolver strings de localização em um valor uule.

Localização em formato livre (simples)

Passe a localização como uma string. O Shifter a resolve para a geolocalização de melhor correspondência em tempo real.

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=pizza&location=Chicago%2C+Illinois"

Funciona para 95% dos casos de uso. A desvantagem: strings ambíguas (Springfield, London) podem selecionar uma cidade diferente da esperada.

Geolocalização canônica com a Locations API

Para garantir uma cidade específica, resolva-a primeiro:

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

A resposta lista todas as localizações correspondentes com um nome canônico, country_code, target_type (City, State, Country) e um google_id. Escolha a que você deseja e use seu nome canônico em location=:

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=pizza&location=Chicago%2CIllinois%2CUnited+States"

Par de país e idioma

Combine gl (país) e hl (idioma) para obter resultados no formato certo:

gl	hl	O que você obtém
us	en	Resultados dos EUA em inglês (padrão)
de	de	Resultados da Alemanha em alemão
jp	ja	Resultados do Japão em japonês
br	pt	Resultados do Brasil em português

curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=news&gl=de&hl=de"

Dispositivo

SERPs móveis e desktop diferem significativamente (recursos diferentes, classificações diferentes). Escolha explicitamente:

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

Valores: desktop (padrão), mobile, tablet.

Dica

Para rastreamento de classificação, sempre defina gl, hl, device e location explicitamente. Deixá-los nos valores padrão gera resultados inconsistentes entre execuções.

Localizações do Yandex

O Yandex usa seus próprios IDs de localização por meio de lr:

lr	Cidade
1	Moscou
2	São Petersburgo
11316	Novosibirsk
54	Yekaterinburgo

Lista completa disponível via engine=yandex_locations.

Próximo

• Google, lista de mecanismos.
• REST API → SERP Locations, referência completa de parâmetros de geolocalização do Google.