Ubicaciones

Para la mayoría de las solicitudes SERP, una cadena location= de formato libre es suficiente. Cuando necesites una segmentación canónica a nivel de ciudad que coincida con la propia taxonomía de ubicaciones de Google, usa la API de Locations para resolver cadenas de lugares en un valor uule.

Ubicación de formato libre (simple)

Pasa la ubicación como una cadena. Shifter la resuelve a la geolocalización que mejor coincida al vuelo.

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

Funciona para el 95% de los casos de uso. La desventaja: las cadenas ambiguas (Springfield, London) pueden seleccionar una ciudad distinta de la esperada.

Geolocalización canónica con la API de Locations

Para garantizar una ciudad específica, resuélvela primero:

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

La respuesta enumera todas las ubicaciones coincidentes con un nombre canónico, country_code, target_type (City, State, Country) y un google_id. Elige la que quieras y usa su nombre canónico en 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

Combina gl (país) y hl (idioma) para obtener resultados en el formato correcto:

gl	hl	Qué obtienes
us	en	Resultados de EE. UU. en inglés (por defecto)
de	de	Resultados alemanes en alemán
jp	ja	Resultados japoneses en japonés
br	pt	Resultados brasileños en portugués

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

Dispositivo

Los SERP de móvil y de escritorio difieren significativamente (funciones distintas, clasificaciones distintas). Elige explícitamente:

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

Valores: desktop (por defecto), mobile, tablet.

Consejo

Para el seguimiento de posiciones (rank-tracking), establece siempre gl, hl, device y location explícitamente. Dejarlos con los valores por defecto produce resultados inconsistentes entre ejecuciones.

Ubicaciones de Yandex

Yandex usa sus propios ID de ubicación mediante lr:

lr	Ciudad
1	Moscú
2	San Petersburgo
11316	Novosibirsk
54	Ekaterimburgo

Lista completa disponible mediante engine=yandex_locations.

Siguiente

• Google, lista de motores.
• REST API → SERP Locations, referencia completa de parámetros de geolocalización de Google.