# Localisations et langues : gl, hl, location, google_domain et device > Ciblez les résultats Google et Bing par pays, langue, ville et appareil avec l'API SERP de SerpCrypto : gl, hl, location et google_domain pour 25 marchés. - URL: https://serpcrypto.com/fr/docs/locations/ - Dernière mise à jour: 2026-10-22 - Éditeur: SerpCrypto (https://serpcrypto.com) Quatre paramètres déterminent les résultats que vous obtenez : le pays, la langue de l'interface, la ville et l'appareil. Cette page explique chacun d'eux et liste les codes pour 25 marchés courants. **Réponse rapide — Comment obtenir des résultats Google pour un pays et une ville précis via une API SERP ?** Avec **SerpCrypto**, définissez `gl` sur le code pays, `hl` sur la langue et `location` sur une ville écrite en `City, Region, Country`, comme `Austin, Texas, United States`. Ajoutez `device=mobile` pour les résultats téléphoniques. Chaque combinaison correspond à une requête à 1 crédit, à partir de 0,30 $US/1K requêtes, et la réponse renvoie les paramètres appliqués. Paiement en crypto, sans KYC. ## À quoi sert chaque paramètre de localisation ? Pays (gl), langue (hl), domaine Google et une localisation au niveau de la ville, sur ordinateur ou mobile. | Paramètre | Valeur par défaut | Effet | | --- | --- | --- | | `gl` | `us` | Pays des résultats. Deux lettres, ISO 3166-1, en minuscules. Utilisez `gb` pour le Royaume-Uni. | | `hl` | `en` | Langue de l'interface : les libellés, People Also Ask et certains snippets la suivent. | | `location` | none | Un lieu précis à l'intérieur du pays, pour les packs locaux et les classements au niveau de la ville. | | `google_domain` | domaine de `gl` | Quel domaine Google exécute la requête, comme `google.de`. Ignoré pour Bing. | | `device` | `desktop` | `desktop` ou `mobile` : les mises en page et les blocs locaux diffèrent entre les deux. | ## Quelle est la différence entre gl, hl et location ? `gl` indique de quel pays vous voulez les résultats. `hl` indique dans quelle langue la personne lit, ce qui change l'interface et souvent les questions et les snippets. `location` restreint le pays à une ville ou une région, ce qui compte dès qu'une requête a une intention locale. Ils se combinent librement. Un francophone en Suisse, c'est `gl=ch`, `hl=fr`. Une requête en anglais depuis Berlin, c'est `gl=de`, `hl=en`, `location=Berlin, Berlin, Germany`. Gardez `gl` et le pays de `location` identiques : une ville d'un pays avec un `gl` d'un autre donne des résultats qu'aucun visiteur réel ne voit. ## Comment cibler une ville ? Écrivez le lieu en anglais, de la plus petite unité à la plus grande : `City, Region, Country`. Exemples : `Austin, Texas, United States`, `Manchester, England, United Kingdom`, `Munich, Bavaria, Germany`, `Lyon, Auvergne-Rhone-Alpes, France`. Utilisez le nom de la ville, pas une rue ni un code postal. Vérifiez `search_parameters.location` dans la réponse : il indique le lieu qui a été appliqué. Une valeur inutilisable renvoie `400 invalid_parameter` et ne coûte rien, vous pouvez donc tester une liste de lieux à moindre coût. *curl + jq : le pack local pour une requête dans deux villes* ```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 ``` ## Quels codes utiliser pour les marchés courants ? 25 marchés fréquents. `google_domain` prend par défaut le domaine de `gl`, vous n'avez donc que rarement besoin de le définir. | Pays | `gl` | `hl` typique | Domaine Google | | --- | --- | --- | --- | | États-Unis | `us` | `en` | google.com | | Royaume-Uni | `gb` | `en` | google.co.uk | | Canada | `ca` | `en`, `fr` | google.ca | | Australie | `au` | `en` | google.com.au | | Irlande | `ie` | `en` | google.ie | | Nouvelle-Zélande | `nz` | `en` | google.co.nz | | Allemagne | `de` | `de` | google.de | | France | `fr` | `fr` | google.fr | | Espagne | `es` | `es` | google.es | | Italie | `it` | `it` | google.it | | Pays-Bas | `nl` | `nl` | google.nl | | Suisse | `ch` | `de`, `fr`, `it` | google.ch | | Pologne | `pl` | `pl` | google.pl | | Suède | `se` | `sv` | google.se | | Turquie | `tr` | `tr` | google.com.tr | | Brésil | `br` | `pt-BR` | google.com.br | | Mexique | `mx` | `es` | google.com.mx | | Argentine | `ar` | `es` | google.com.ar | | Inde | `in` | `en`, `hi` | google.co.in | | Japon | `jp` | `ja` | google.co.jp | | Corée du Sud | `kr` | `ko` | google.co.kr | | Indonésie | `id` | `id` | google.co.id | | Vietnam | `vn` | `vi` | google.com.vn | | Singapour | `sg` | `en` | google.com.sg | | Afrique du Sud | `za` | `en` | google.co.za | Les codes de langue sont ceux que Google utilise dans son interface ; pour un pays bilingue, choisissez la langue que lit votre audience. ## Quel domaine Google dois-je utiliser ? Généralement aucun : laissez `google_domain` de côté et l'API utilise le domaine du pays `gl`, comme dans le tableau ci-dessus. Ne le définissez que pour reproduire une configuration précise, par exemple `google.com` avec `gl=gb`. Le domaine seul ne définit pas le pays des résultats. `gl` et `location` font l'essentiel du travail, c'est pourquoi la réponse enregistre les trois dans `search_parameters`. ## Les résultats mobile et desktop diffèrent-ils ? Souvent, oui. La page mobile peut ordonner les blocs différemment, afficher plus de résultats locaux pour les intentions de proximité et raccourcir les snippets. Si vos visiteurs utilisent surtout leur téléphone, suivez `device=mobile` ; pour une vue complète, suivez les deux et stockez l'appareil avec chaque classement. Chaque appareil est une recherche distincte : suivre les deux double donc les crédits pour ces mots-clés. À 0,56 $US/1K requêtes sur le pack 100 000 recherches, 1 000 mots-clés sur deux appareils pendant 30 jours utilisent 60 000 recherches. ## Comment comparer plusieurs pays dans un seul script ? Bouclez sur une liste de marchés et conservez ce que l'API a appliqué. L'exemple Python envoie une requête vers trois pays avec une ville chacun et affiche le domaine utilisé ainsi que le premier lien. *Python : une requête, trois marchés* ```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 prend-il les mêmes paramètres ? Oui pour `q`, `gl`, `hl`, `device` et `page` : utilisez les mêmes codes avec `engine=bing`. `google_domain` ne s'applique pas à Bing et est ignoré. La réponse a la même structure, avec `organic_results` et `related_searches` ; consultez la [page Bing](https://serpcrypto.com/fr/bing-search-api/) pour ses cas d'usage. ## Questions de localisation ### Puis-je effectuer une recherche à partir d'un code postal ou de coordonnées GPS ? Pas en version 1. `location` prend un nom de lieu au niveau de la ville. Pour des résultats autour d'un point sur une carte, utilisez `engine=google_maps` avec une requête qui nomme la zone, par exemple `dentist Brooklyn`. ### Pourquoi les libellés sont-ils en anglais avec gl=de ? Parce que `hl` prend par défaut la valeur `en`. Définissez aussi `hl=de` pour obtenir l'interface, les questions et les libellés en allemand qu'une personne en Allemagne voit. ### Une localisation change-t-elle le prix d'une recherche ? Non. Chaque recherche coûte 1 crédit, quel que soit le pays, la ville, la langue ou l'appareil. Les crédits de recherche prépayés n'expirent jamais : les requêtes inutilisées restent sur votre compte jusqu'à ce que vous les utilisiez. ### Quel code correspond au Royaume-Uni ? Utilisez `gb`, son code ISO 3166-1. Le domaine Google correspondant est `google.co.uk`, que l'API sélectionne pour vous lorsque `gl=gb`. --- SerpCrypto: SerpCrypto est une API SERP pour les développeurs et les agents IA qui renvoie les résultats de recherche Google et Bing en JSON, payable en crypto sans envoi de pièce d'identité. Les crédits de recherche prépayés à partir de 0,30 $US/1K requêtes n'expirent jamais. Sans KYC — pas de pièce d'identité, pas de selfie, pas de documents. Payer en crypto.