# Località e lingue: gl, hl, location, google_domain e device

> Orientare i risultati di Google e Bing per paese, lingua, città e dispositivo con la API SERP di SerpCrypto: gl, hl, location e google_domain per 25 mercati.

- URL: https://serpcrypto.com/it/docs/locations/
- Ultimo aggiornamento: 2026-10-22
- Editore: SerpCrypto (https://serpcrypto.com)

Quattro parametri decidono di chi sono i risultati che ottieni: il paese, la lingua dell'interfaccia, la città e il dispositivo. Questa pagina spiega ciascuno e elenca i codici per 25 mercati comuni.

**Risposta rapida — Come ottengo i risultati di Google per un paese e una città specifici tramite un'API SERP?**

Con **SerpCrypto**, imposta `gl` sul codice del paese, `hl` sulla lingua e `location` su una città scritta `City, Region, Country`, come `Austin, Texas, United States`. Aggiungi `device=mobile` per i risultati delle ricerche telefoniche. Ogni combinazione è una ricerca a 1 credito, a partire da 0,30 USD/1K ricerche, e la risposta riporta le impostazioni applicate. Paghi in criptovalute, senza KYC.

## Cosa fa ogni parametro di localizzazione?

Paese (gl), lingua (hl), dominio Google e una stringa di località a livello di città, su desktop o mobile.

| Parametro | Valore predefinito | Effetto |
| --- | --- | --- |
| `gl` | `us` | Paese dei risultati. Due lettere, ISO 3166-1, minuscole. Usa `gb` per il Regno Unito. |
| `hl` | `en` | Lingua dell'interfaccia: le etichette, People Also Ask e alcuni snippet la seguono. |
| `location` | nessuno | Un luogo preciso all'interno del paese, per i local pack e le classifiche a livello di città. |
| `google_domain` | dominio di `gl` | Quale dominio Google esegue la ricerca, ad esempio `google.de`. Ignorato per Bing. |
| `device` | `desktop` | `desktop` o `mobile`: i layout e i blocchi locali differiscono tra i due. |

## Qual è la differenza tra gl, hl e location?

`gl` indica di quale paese vuoi i risultati. `hl` indica in quale lingua legge la persona, il che cambia l'interfaccia e spesso anche le domande e gli snippet. `location` restringe il paese a una città o a una regione, cosa che conta non appena una query ha un'intenzione locale.

Si combinano liberamente. Un francofono in Svizzera è `gl=ch`, `hl=fr`. Una ricerca in inglese da Berlino è `gl=de`, `hl=en`, `location=Berlin, Berlin, Germany`. Mantieni `gl` e il paese di `location` uguali: una città in un paese con `gl` di un altro dà risultati che nessun visitatore reale vede.

## Come faccio a puntare a una città?

Scrivi il luogo in inglese, dall'unità più piccola alla più grande: `City, Region, Country`. Esempi: `Austin, Texas, United States`, `Manchester, England, United Kingdom`, `Munich, Bavaria, Germany`, `Lyon, Auvergne-Rhone-Alpes, France`. Usa il nome della città, non una via o un codice postale.

Controlla `search_parameters.location` nella risposta: mostra il luogo applicato. Un valore che non può essere usato restituisce `400 invalid_parameter` e non costa nulla, così puoi testare un elenco di luoghi a basso costo.

*curl + jq: il local pack per una query in due città*

```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
```

## Quali codici devo usare per i mercati più comuni?

25 mercati frequenti. `google_domain` usa per impostazione predefinita il dominio di `gl`, quindi raramente devi impostarlo.

| Paese | `gl` | `hl` tipico | Dominio Google |
| --- | --- | --- | --- |
| Stati Uniti | `us` | `en` | google.com |
| Regno Unito | `gb` | `en` | google.co.uk |
| Canada | `ca` | `en`, `fr` | google.ca |
| Australia | `au` | `en` | google.com.au |
| Irlanda | `ie` | `en` | google.ie |
| Nuova Zelanda | `nz` | `en` | google.co.nz |
| Germania | `de` | `de` | google.de |
| Francia | `fr` | `fr` | google.fr |
| Spagna | `es` | `es` | google.es |
| Italia | `it` | `it` | google.it |
| Paesi Bassi | `nl` | `nl` | google.nl |
| Svizzera | `ch` | `de`, `fr`, `it` | google.ch |
| Polonia | `pl` | `pl` | google.pl |
| Svezia | `se` | `sv` | google.se |
| Turchia | `tr` | `tr` | google.com.tr |
| Brasile | `br` | `pt-BR` | google.com.br |
| Messico | `mx` | `es` | google.com.mx |
| Argentina | `ar` | `es` | google.com.ar |
| India | `in` | `en`, `hi` | google.co.in |
| Giappone | `jp` | `ja` | google.co.jp |
| Corea del Sud | `kr` | `ko` | google.co.kr |
| Indonesia | `id` | `id` | google.co.id |
| Vietnam | `vn` | `vi` | google.com.vn |
| Singapore | `sg` | `en` | google.com.sg |
| Sudafrica | `za` | `en` | google.co.za |

I codici lingua sono quelli che Google usa nella sua interfaccia; per un paese bilingue, scegli la lingua che legge il tuo pubblico.

## Quale dominio Google devo usare?

Di solito nessuno: lascia fuori `google_domain` e l'API usa il dominio del paese `gl`, come nella tabella sopra. Impostalo solo per riprodurre una configurazione specifica, per esempio `google.com` con `gl=gb`.

Il solo dominio non definisce il paese dei risultati. `gl` e `location` fanno la maggior parte del lavoro, ed è per questo che la risposta li registra tutti e tre in `search_parameters`.

## I risultati da mobile e da desktop sono diversi?

Spesso sì. La pagina mobile può ordinare i blocchi in modo diverso, mostrare più risultati locali per intenti di prossimità e accorciare gli snippet. Se i tuoi visitatori usano soprattutto il telefono, monitora `device=mobile`; per un quadro completo, monitora entrambi e salva il dispositivo con ogni posizionamento.

Ogni dispositivo è una ricerca separata, quindi monitorare entrambi raddoppia i crediti per quelle keyword. A 0,56 USD/1K ricerche sul pack 100.000 ricerche, 1.000 keyword su due dispositivi per 30 giorni usano 60.000 ricerche.

## Come confronto più paesi in un unico script?

Fai un loop su una lista di mercati e conserva ciò che l'API ha applicato. L'esempio Python invia una query a tre paesi con una città ciascuno e stampa il dominio usato e il primo link.

*Python: una query, tre mercati*

```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 accetta gli stessi parametri?

Sì per `q`, `gl`, `hl`, `device` e `page`: usa gli stessi codici con `engine=bing`. `google_domain` non si applica a Bing e viene ignorato. La risposta ha la stessa struttura, con `organic_results` e `related_searches`; vedi la [pagina Bing](https://serpcrypto.com/it/bing-search-api/) per i suoi casi d'uso.

## Domande sulla località

### Posso cercare da un codice postale o da coordinate GPS?

Non nella versione 1. `location` accetta un nome di località a livello di città. Per risultati intorno a un punto sulla mappa, usa `engine=google_maps` con una query che nomini la zona, come `dentist Brooklyn`.

### Perché ottengo etichette in inglese con gl=de?

Perché `hl` usa `en` come impostazione predefinita. Imposta anche `hl=de` per ottenere l'interfaccia tedesca, le domande e le etichette che vede una persona in Germania.

### Una località cambia il prezzo di una ricerca?

No. Ogni ricerca costa 1 credito, qualunque siano il paese, la città, la lingua o il dispositivo. I crediti di ricerca prepagati non scadono mai: le ricerche non utilizzate restano sul tuo account finché non le usi.

### Qual è il codice del Regno Unito?

Usa `gb`, il suo codice ISO 3166-1. Il dominio Google per quel paese è `google.co.uk`, che l'API sceglie per te quando `gl=gb`.

---

SerpCrypto: SerpCrypto è un'API SERP per sviluppatori e agenti AI che restituisce i risultati di ricerca di Google e Bing in JSON, con pagamento in criptovalute e senza caricare documenti d'identità. I crediti di ricerca prepagati a partire da 0,30 USD/1K ricerche non scadono mai. Senza KYC — niente documento, niente selfie, niente documenti. Paghi in criptovalute.