# Ubicaciones e idiomas: gl, hl, location, google_domain y device > Dirige los resultados de Google y Bing por país, idioma, ciudad y dispositivo con la API SERP de SerpCrypto: gl, hl, location y google_domain para 25 mercados. - URL: https://serpcrypto.com/es/docs/locations/ - Última actualización: 2026-10-22 - Editor: SerpCrypto (https://serpcrypto.com) Cuatro parámetros deciden de quién son los resultados que recibes: el país, el idioma de la interfaz, la ciudad y el dispositivo. Esta página explica cada uno y lista los códigos de 25 mercados habituales. **Respuesta rápida — ¿Cómo obtengo resultados de Google para un país y una ciudad concretos a través de una API SERP?** Con **SerpCrypto**, establece `gl` en el código de país, `hl` en el idioma y `location` en una ciudad escrita `City, Region, Country`, como `Austin, Texas, United States`. Añade `device=mobile` para resultados de teléfono. Cada combinación es una búsqueda a 1 crédito, desde 0,30 US$/1K búsquedas, y la respuesta devuelve los ajustes que se aplicaron. Se paga con criptomonedas, sin KYC. ## ¿Qué hace cada parámetro de ubicación? País (gl), idioma (hl), dominio de Google y un string de ubicación a nivel de ciudad, en escritorio o móvil. | Parámetro | Predeterminado | Efecto | | --- | --- | --- | | `gl` | `us` | País de los resultados. Dos letras, ISO 3166-1, en minúsculas. Usa `gb` para el Reino Unido. | | `hl` | `en` | Idioma de la interfaz: las etiquetas, People Also Ask y algunos fragmentos lo siguen. | | `location` | ninguno | Un lugar preciso dentro del país, para los packs locales y los rankings a nivel de ciudad. | | `google_domain` | dominio de `gl` | Qué dominio de Google ejecuta la búsqueda, como `google.de`. Se ignora para Bing. | | `device` | `desktop` | `desktop` o `mobile`: los diseños y los bloques locales difieren entre ambos. | ## ¿Cuál es la diferencia entre gl, hl y location? `gl` indica de qué país quieres los resultados. `hl` indica en qué idioma lee la persona, lo que cambia la interfaz y a menudo las preguntas y los fragmentos. `location` reduce el país a una ciudad o región, lo que importa en cuanto una consulta tiene intención local. Se combinan libremente. Un francófono en Suiza es `gl=ch`, `hl=fr`. Una búsqueda en inglés desde Berlín es `gl=de`, `hl=en`, `location=Berlin, Berlin, Germany`. Mantén `gl` y el país de `location` iguales: una ciudad de un país con `gl` de otro da resultados que ningún visitante real ve. ## ¿Cómo apunto a una ciudad? Escribe el lugar en inglés, de la unidad más pequeña a la más grande: `City, Region, Country`. Ejemplos: `Austin, Texas, United States`, `Manchester, England, United Kingdom`, `Munich, Bavaria, Germany`, `Lyon, Auvergne-Rhone-Alpes, France`. Usa el nombre de la ciudad, no una calle ni un código postal. Comprueba `search_parameters.location` en la respuesta: muestra el lugar que se aplicó. Un valor que no se puede usar devuelve `400 invalid_parameter` y no cuesta nada, así que puedes probar una lista de lugares a bajo coste. *curl + jq: el local pack de una consulta en dos ciudades* ```bash # The same query from two cities: compare the local packs for city in "Austin, Texas, United States" "Denver, Colorado, United States"; do curl -sG "https://serpcrypto.com/api/v1/search" \ -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \ --data-urlencode "q=emergency plumber" \ --data-urlencode "location=$city" \ -d gl=us -d hl=en -d device=mobile \ | jq -r --arg city "$city" '.local_results[]? | "\($city)\t\(.position)\t\(.title)"' done ``` ## ¿Qué códigos debo usar para los mercados habituales? 25 mercados frecuentes. `google_domain` toma por defecto el dominio de `gl`, así que rara vez necesitas definirlo. | País | `gl` | `hl` típico | Dominio de Google | | --- | --- | --- | --- | | Estados Unidos | `us` | `en` | google.com | | Reino Unido | `gb` | `en` | google.co.uk | | Canadá | `ca` | `en`, `fr` | google.ca | | Australia | `au` | `en` | google.com.au | | Irlanda | `ie` | `en` | google.ie | | Nueva Zelanda | `nz` | `en` | google.co.nz | | Alemania | `de` | `de` | google.de | | Francia | `fr` | `fr` | google.fr | | España | `es` | `es` | google.es | | Italia | `it` | `it` | google.it | | Países Bajos | `nl` | `nl` | google.nl | | Suiza | `ch` | `de`, `fr`, `it` | google.ch | | Polonia | `pl` | `pl` | google.pl | | Suecia | `se` | `sv` | google.se | | Turquía | `tr` | `tr` | google.com.tr | | Brasil | `br` | `pt-BR` | google.com.br | | México | `mx` | `es` | google.com.mx | | Argentina | `ar` | `es` | google.com.ar | | India | `in` | `en`, `hi` | google.co.in | | Japón | `jp` | `ja` | google.co.jp | | Corea del Sur | `kr` | `ko` | google.co.kr | | Indonesia | `id` | `id` | google.co.id | | Vietnam | `vn` | `vi` | google.com.vn | | Singapur | `sg` | `en` | google.com.sg | | Sudáfrica | `za` | `en` | google.co.za | Los códigos de idioma son los que usa Google en su interfaz; para un país bilingüe, elige el idioma en el que lee tu audiencia. ## ¿Qué dominio de Google debería usar? Normalmente ninguno: omite `google_domain` y la API usa el dominio del país de `gl`, como en la tabla de arriba. Defínelo solo para reproducir una configuración concreta, por ejemplo `google.com` con `gl=gb`. El dominio por sí solo no define el país de los resultados. `gl` y `location` hacen la mayor parte del trabajo, por eso la respuesta registra los tres en `search_parameters`. ## ¿Difieren los resultados de móvil y escritorio? A menudo sí. La página de móvil puede ordenar los bloques de otra forma, mostrar más resultados locales para intenciones cercanas y recortar más los snippets. Si tus visitantes usan sobre todo el teléfono, haz seguimiento de `device=mobile`; para una visión completa, haz seguimiento de ambos y guarda el dispositivo con cada ranking. Cada dispositivo es una búsqueda distinta, así que hacer seguimiento de ambos duplica los créditos de esas palabras clave. A 0,56 US$/1K búsquedas en el pack 100.000 búsquedas, 1,000 palabras clave en dos dispositivos durante 30 días usan 60,000 búsquedas. ## ¿Cómo comparo varios países en un solo script? Recorre una lista de mercados y guarda lo que aplicó la API. El ejemplo en Python envía una consulta a tres países con una ciudad cada uno e imprime el dominio usado y el primer enlace. *Python: una consulta, tres mercados* ```python import os import requests MARKETS = [ {"gl": "de", "hl": "de", "location": "Munich, Bavaria, Germany"}, {"gl": "fr", "hl": "fr", "location": "Lyon, Auvergne-Rhone-Alpes, France"}, {"gl": "br", "hl": "pt-BR", "location": "Curitiba, State of Parana, Brazil"}, ] for market in MARKETS: r = requests.get( "https://serpcrypto.com/api/v1/search", params={"q": "running shoes", **market}, headers={"Authorization": "Bearer " + os.environ["SERPCRYPTO_API_KEY"]}, timeout=60, ) r.raise_for_status() applied = r.json()["search_parameters"] top = r.json().get("organic_results", [])[:1] print(applied["gl"], applied.get("google_domain"), [x["link"] for x in top]) ``` ## ¿Bing acepta los mismos parámetros? Sí para `q`, `gl`, `hl`, `device` y `page`: usa los mismos códigos con `engine=bing`. `google_domain` no se aplica a Bing y se ignora. La respuesta tiene la misma estructura, con `organic_results` y `related_searches`; consulta la [página de Bing](https://serpcrypto.com/es/bing-search-api/) para ver sus casos de uso. ## Preguntas sobre la ubicación ### ¿Puedo buscar desde un código postal o coordenadas GPS? No en la versión 1. `location` acepta un nombre de lugar a nivel de ciudad. Para obtener resultados alrededor de un punto en un mapa, usa `engine=google_maps` con una consulta que nombre la zona, por ejemplo `dentist Brooklyn`. ### ¿Por qué obtengo etiquetas en inglés con gl=de? Porque `hl` toma por defecto `en`. Configura también `hl=de` para obtener la interfaz, las preguntas y las etiquetas en alemán que ve una persona en Alemania. ### ¿La ubicación cambia el precio de una búsqueda? No. Cada búsqueda cuesta 1 crédito, sea cual sea el país, la ciudad, el idioma o el dispositivo. Los créditos de búsqueda prepagados no caducan nunca: las consultas sin usar se quedan en tu cuenta hasta que las uses. ### ¿Cuál es el código del Reino Unido? Usa `gb`, su código ISO 3166-1. El dominio de Google para él es `google.co.uk`, que la API elige por ti cuando `gl=gb`. --- SerpCrypto: SerpCrypto es una API SERP para desarrolladores y agentes de IA que devuelve resultados de Google y Bing como JSON, pagada con criptomonedas sin subir ningún documento de identidad. Los créditos de búsqueda prepagados desde 0,30 US$/1K búsquedas nunca caducan. Sin KYC: ni identificación, ni selfie, ni documentos. Paga con criptomonedas.