# Locations ve diller: gl, hl, location, google_domain ve device

> SerpCrypto SERP API ile Google ve Bing sonuçlarını ülke, dil, şehir ve cihaza göre hedefleyin: 25 pazar için gl, hl, location ve google_domain.

- URL: https://serpcrypto.com/tr/docs/locations/
- Son güncelleme: 2026-10-22
- Yayıncı: SerpCrypto (https://serpcrypto.com)

Kimin sonuçlarını alacağınıza dört parametre karar verir: ülke, arayüz dili, şehir ve cihaz. Bu sayfa her birini açıklar ve 25 yaygın pazar için kodları listeler.

**Hızlı yanıt — Belirli bir ülke ve şehir için Google sonuçlarını SERP API üzerinden nasıl alırım?**

**SerpCrypto** ile `gl` değerini ülke koduna, `hl` değerini dile ve `location` değerini `City, Region, Country` olarak yazılan bir şehre ayarlayın, örneğin `Austin, Texas, United States`. Telefon sonuçları için `device=mobile` ekleyin. Her kombinasyon 1 kredi ile bir aramadır, $0,30/1K arama itibarıyla başlar ve yanıt uyguladığı ayarları geri yansıtır. Kripto ile ödeme, KYC olmadan.

## Her konum parametresi ne işe yarar?

Ülke (gl), dil (hl), Google alan adı ve şehir düzeyinde konum dizesi, masaüstünde veya mobilde.

| Parametre | Varsayılan | Etki |
| --- | --- | --- |
| `gl` | `us` | Sonuçların ülkesi. İki harf, ISO 3166-1, küçük harf. Birleşik Krallık için `gb` kullanın. |
| `hl` | `en` | Arayüzün dili: etiketler, People Also Ask ve bazı snippet'ler buna uyar. |
| `location` | yok | Ülke içinde hassas bir yer; yerel paketler ve şehir düzeyindeki sıralamalar için. |
| `google_domain` | `gl` alan adı | Aramayı hangi Google alan adının yürüteceği, örneğin `google.de`. Bing için yok sayılır. |
| `device` | `desktop` | `desktop` veya `mobile`: düzenler ve yerel bloklar ikisi arasında farklıdır. |

## gl, hl ve location arasındaki fark nedir?

`gl` hangi ülkenin sonuçlarını istediğinizi söyler. `hl` kişinin hangi dili okuduğunu söyler; bu arayüzü ve çoğu zaman soruları ve snippet'leri değiştirir. `location` ülkeyi bir şehre veya bölgeye daraltır; bu, bir sorguda yerel niyet olduğu anda önem kazanır.

Serbestçe birleşirler. İsviçre'deki Fransızca konuşan biri `gl=ch`, `hl=fr` olur. Berlin'den yapılan İngilizce bir arama `gl=de`, `hl=en`, `location=Berlin, Berlin, Germany` olur. `gl` ile `location` ülkesini aynı tutun: bir ülkedeki şehir ile başka bir ülkenin `gl` değeri, hiçbir gerçek ziyaretçinin görmediği sonuçlar verir.

## Bir şehri nasıl hedeflerim?

Yeri İngilizce olarak, en küçük birimden en büyüğe doğru yazın: `City, Region, Country`. Örnekler: `Austin, Texas, United States`, `Manchester, England, United Kingdom`, `Munich, Bavaria, Germany`, `Lyon, Auvergne-Rhone-Alpes, France`. Sokak veya posta kodu değil, şehrin adını kullanın.

Yanıttaki `search_parameters.location` değerini kontrol edin: uygulanan yeri gösterir. Kullanılamayan bir değer `400 invalid_parameter` döndürür ve hiçbir şeye mal olmaz, böylece bir yer listesini ucuza test edebilirsiniz.

*curl + jq: iki şehirde tek bir sorgu için yerel paket*

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

## Yaygın pazarlar için hangi kodları kullanmalıyım?

25 sık kullanılan pazar. `google_domain` varsayılan olarak `gl` alan adını kullanır, bu yüzden nadiren ayarlamanız gerekir.

| Ülke | `gl` | Tipik `hl` | Google alan adı |
| --- | --- | --- | --- |
| Amerika Birleşik Devletleri | `us` | `en` | google.com |
| Birleşik Krallık | `gb` | `en` | google.co.uk |
| Kanada | `ca` | `en`, `fr` | google.ca |
| Avustralya | `au` | `en` | google.com.au |
| İrlanda | `ie` | `en` | google.ie |
| Yeni Zelanda | `nz` | `en` | google.co.nz |
| Almanya | `de` | `de` | google.de |
| Fransa | `fr` | `fr` | google.fr |
| İspanya | `es` | `es` | google.es |
| İtalya | `it` | `it` | google.it |
| Hollanda | `nl` | `nl` | google.nl |
| İsviçre | `ch` | `de`, `fr`, `it` | google.ch |
| Polonya | `pl` | `pl` | google.pl |
| İsveç | `se` | `sv` | google.se |
| Türkiye | `tr` | `tr` | google.com.tr |
| Brezilya | `br` | `pt-BR` | google.com.br |
| Meksika | `mx` | `es` | google.com.mx |
| Arjantin | `ar` | `es` | google.com.ar |
| Hindistan | `in` | `en`, `hi` | google.co.in |
| Japonya | `jp` | `ja` | google.co.jp |
| Güney Kore | `kr` | `ko` | google.co.kr |
| Endonezya | `id` | `id` | google.co.id |
| Vietnam | `vn` | `vi` | google.com.vn |
| Singapur | `sg` | `en` | google.com.sg |
| Güney Afrika | `za` | `en` | google.co.za |

Dil kodları, Google'ın arayüzünde kullandığı kodlardır; iki dilli bir ülke için kitlenizin okuduğu dili seçin.

## Hangi Google alan adını kullanmalıyım?

Genellikle hiçbiri: `google_domain` alanını boş bırakın, API yukarıdaki tabloda olduğu gibi `gl` ülkesinin alan adını kullanır. Yalnızca belirli bir kurulumu yeniden oluşturmak için ayarlayın, örneğin `google.com` ile `gl=gb`.

Alan adı tek başına sonuçların ülkesini tanımlamaz. İşin çoğunu `gl` ve `location` yapar, bu yüzden yanıt üçünü de `search_parameters` içinde kaydeder.

## Mobil ve masaüstü sonuçları farklı mı?

Çoğu zaman evet. Mobil sayfa blokları farklı sıralayabilir, yakındaki aramalara daha fazla yerel sonuç gösterebilir ve snippet'leri daha kısa kesebilir. Ziyaretçileriniz çoğunlukla telefon kullanıyorsa `device=mobile` alanını takip edin; tam bir görünüm için ikisini de takip edin ve her sıralamayla birlikte cihazı saklayın.

Her cihaz ayrı bir aramadır, bu yüzden ikisini de takip etmek bu anahtar kelimeler için kredileri ikiye katlar. 100.000 arama paketinde $0,56/1K arama ile 30 gün boyunca iki cihazda 1.000 anahtar kelime 60.000 arama kullanır.

## Tek bir script'te birkaç ülkeyi nasıl karşılaştırırım?

Pazarların listesi üzerinde döngü kurun ve API'nin uyguladıklarını saklayın. Python örneği, her biri bir şehirle üç ülkeye tek bir sorgu gönderir ve kullanılan alan adını ve ilk bağlantıyı yazdırır.

*Python: tek sorgu, üç pazar*

```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 aynı parameter'leri alıyor mu?

`q`, `gl`, `hl`, `device` ve `page` için evet: aynı kodları `engine=bing` ile kullanın. `google_domain` Bing için geçerli değildir ve yok sayılır. Yanıt aynı çerçeveye sahiptir, `organic_results` ve `related_searches` ile; kullanım senaryoları için [Bing sayfasına](https://serpcrypto.com/tr/bing-search-api/) bakın.

## Konum soruları

### Bir posta kodundan veya GPS koordinatlarından arama yapabilir miyim?

Sürüm 1'de hayır. `location` şehir düzeyinde bir yer adı alır. Haritadaki bir noktanın çevresindeki sonuçlar için, alanı adlandıran bir sorguyla `engine=google_maps` kullanın, örneğin `dentist Brooklyn`.

### gl=de ile neden İngilizce etiketler alıyorum?

Çünkü `hl` varsayılan olarak `en` değerini alır. Almanya'daki bir kişinin gördüğü Almanca arayüzü, soruları ve etiketleri almak için `hl=de` değerini de ayarlayın.

### Konum bir aramanın fiyatını değiştirir mi?

Hayır. Ülke, şehir, dil veya cihaz ne olursa olsun her arama 1 kredi tutar. Ön ödemeli arama kredileri hiçbir zaman sona ermez: kullanılmayan aramalar siz kullanana kadar hesabınızda kalır.

### Birleşik Krallık'ın kodu hangisi?

ISO 3166-1 kodunu, yani `gb` kullanın. Bunun için Google alan adı `google.co.uk`'dir ve `gl=gb` olduğunda API bunu sizin için seçer.

---

SerpCrypto: SerpCrypto, Google ve Bing sonuçlarını JSON olarak döndüren, geliştiriciler ve AI agent'lar için bir SERP API'dir; kripto ile ödeme yapılır, kimlik yüklemek gerekmez. $0,30/1K arama ön ödemeli arama kredisinin süresi asla dolmaz. KYC olmadan — kimlik yok, selfie yok, belge yok. Kripto ile ödeme yapın.
