Ubicación, idioma y dispositivo

Google responde a la misma búsqueda de forma distinta según país, idioma, ciudad y dispositivo. Cuatro parámetros eligen qué versión recibes.

gl · hl · location · device

Nombre	Qué hace
`gl`	País de los resultados, con código de dos letras: us, gb, de, jp…
`hl`	Idioma de la página: en, de, ja, pt-BR… Combínalo con el gl del mismo mercado.
`location`	Busca como si estuvieras en una ciudad o región, p. ej. "Munich,Bavaria,Germany". Solo resultados móviles; los nombres salen de GET /google/locations.
`device`	mobile (predeterminado) o pc. Los diseños difieren: algunos bloques solo aparecen en uno.

gl y hl valen para la mayoría de endpoints de Google; device y location para Google Web Search. La tabla de parámetros de cada endpoint dice qué acepta. Ninguno cambia el precio.

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

Ubicaciones de busqueda

Consulta los valores que acepta el parametro location de Google Search. El canonical_name de cada resultado puede enviarse como location en /google/search. Esta solicitud no consume creditos.

GET

0 credits

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

q (obligatorio) coincide con el nombre o el nombre canonico sin distinguir mayusculas; country_code filtra por codigo ISO 3166-1 alfa-2; limit va de 1 a 100 (20 por defecto). Primero los nombres exactos y luego los lugares mas amplios. Muchos lugares comparten nombre (Paris, Francia y Paris, Texas), asi que usa country_code para encontrar el correcto. Envia la clave en el encabezado 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	Ejemplo de ciudad
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 y cuenta. Un location que no esta en la lista se ignora en lugar de rechazarse: la busqueda se hace sin el. location solo tiene efecto en busquedas mobile (device mobile, el predeterminado).