Tanpa KYC — tanpa ID, tanpa selfie, tanpa dokumen. Bayar dengan kripto: BTC, USDT, USDC, ETH, SOL, LTC
Bahasa: Bahasa Indonesia
Dapatkan API key

Docs · Locations · API v1

Lokasi dan bahasa: gl, hl, location, google_domain, dan device

Empat parameter menentukan hasil siapa yang Anda terima: negara, bahasa antarmuka, kota, dan perangkat. Halaman ini menjelaskan masing-masing dan mencantumkan kode untuk 25 pasar umum.

Terakhir diperbarui: · 5 menit baca

Jawaban singkat

Bagaimana cara mendapatkan hasil Google untuk negara dan kota tertentu melalui SERP API?

Dengan SerpCrypto, atur gl ke kode negara, hl ke bahasa, dan location ke nama kota yang ditulis City, Region, Country, misalnya Austin, Texas, United States. Tambahkan device=mobile untuk hasil telepon. Setiap kombinasi adalah satu pencarian dengan 1 kredit, mulai dari US$0,30/1K pencarian, dan respons mencantumkan pengaturan yang diterapkan. Bayar dengan kripto, tanpa KYC.

Apa fungsi setiap parameter lokasi?

Negara (gl), bahasa (hl), domain Google dan string lokasi tingkat kota, di desktop atau mobile.

ParameterDefaultEfek
glusNegara hasil pencarian. Dua huruf, ISO 3166-1, huruf kecil. Gunakan gb untuk Inggris.
hlenBahasa antarmuka: label, People Also Ask, dan sebagian snippet mengikutinya.
locationnoneTempat spesifik di dalam negara, untuk local pack dan peringkat tingkat kota.
google_domaindomain glDomain Google mana yang menjalankan pencarian, seperti google.de. Diabaikan untuk Bing.
devicedesktopdesktop atau mobile: tata letak dan blok lokal berbeda di antara keduanya.

Apa perbedaan gl, hl, dan location?

gl menentukan hasil dari negara mana yang Anda inginkan. hl menentukan bahasa yang dibaca pengguna, yang mengubah antarmuka dan sering kali pertanyaan serta snippet. location mempersempit negara ke kota atau wilayah, yang penting begitu sebuah kueri punya maksud lokal.

Ketiganya bisa dikombinasikan bebas. Penutur bahasa Prancis di Swiss adalah gl=ch, hl=fr. Pencarian berbahasa Inggris dari Berlin adalah gl=de, hl=en, location=Berlin, Berlin, Germany. Samakan gl dengan negara location: kota di satu negara dengan gl dari negara lain menghasilkan hasil yang tidak dilihat pengunjung sungguhan.

Bagaimana cara menargetkan kota?

Tulis tempatnya dalam bahasa Inggris, dari unit terkecil ke terbesar: City, Region, Country. Contoh: Austin, Texas, United States, Manchester, England, United Kingdom, Munich, Bavaria, Germany, Lyon, Auvergne-Rhone-Alpes, France. Gunakan nama kota, bukan nama jalan atau kode pos.

Periksa search_parameters.location di respons: nilainya menunjukkan tempat yang diterapkan. Nilai yang tidak bisa digunakan mengembalikan 400 invalid_parameter dan tidak memakan biaya, jadi Anda bisa menguji daftar tempat dengan murah.

curl + jq: local pack untuk satu kueri di dua kota
# 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

Kode apa yang harus saya gunakan untuk pasar umum?

25 pasar yang sering dipakai. google_domain otomatis memakai domain dari gl, jadi Anda jarang perlu mengisinya.

Negaraglhl yang umumDomain Google
Amerika Serikatusengoogle.com
Inggrisgbengoogle.co.uk
Kanadacaen, frgoogle.ca
Australiaauengoogle.com.au
Irlandiaieengoogle.ie
Selandia Barunzengoogle.co.nz
Jermandedegoogle.de
Prancisfrfrgoogle.fr
Spanyolesesgoogle.es
Italiaititgoogle.it
Belandanlnlgoogle.nl
Swisschde, fr, itgoogle.ch
Polandiaplplgoogle.pl
Swediasesvgoogle.se
Turkitrtrgoogle.com.tr
Brasilbrpt-BRgoogle.com.br
Mexicomxesgoogle.com.mx
Argentinaaresgoogle.com.ar
Indiainen, higoogle.co.in
Jepangjpjagoogle.co.jp
Korea Selatankrkogoogle.co.kr
Indonesiaididgoogle.co.id
Vietnamvnvigoogle.com.vn
Singapurasgengoogle.com.sg
Afrika Selatanzaengoogle.co.za

Kode bahasa yang dipakai adalah kode yang digunakan Google di antarmukanya; untuk negara bilingual, pilih bahasa yang dibaca audiens Anda.

Domain Google mana yang harus saya pakai?

Biasanya tidak perlu: biarkan google_domain kosong dan API memakai domain dari negara gl, seperti pada tabel di atas. Isi hanya untuk mereproduksi setup tertentu, misalnya google.com dengan gl=gb.

Domain saja tidak menentukan negara hasil pencarian. gl dan location yang paling berperan, karena itu jawabannya mencatat ketiganya di search_parameters.

Apakah hasil di mobile dan desktop berbeda?

Sering kali berbeda, ya. Halaman mobile bisa mengurutkan blok dengan cara lain, menampilkan lebih banyak hasil lokal untuk intent sekitar, dan memotong snippet lebih pendek. Jika pengunjung Anda sebagian besar memakai ponsel, lacak device=mobile; untuk gambaran lengkap, lacak keduanya dan simpan perangkat bersama setiap peringkat.

Setiap perangkat adalah pencarian terpisah, jadi melacak keduanya menggandakan kredit untuk kata kunci tersebut. Dengan US$0,56/1K pencarian pada paket 100.000 pencarian, 1.000 kata kunci di dua perangkat selama 30 hari memakai 60.000 pencarian.

Bagaimana cara membandingkan beberapa negara dalam satu skrip?

Loop daftar pasar dan simpan apa yang diterapkan API. Contoh Python mengirim satu kueri ke tiga negara masing-masing dengan satu kota dan mencetak domain yang dipakai serta tautan pertama.

Python: satu kueri, tiga pasar
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])

Apakah Bing menerima parameter yang sama?

Ya untuk q, gl, hl, device dan page: gunakan kode yang sama dengan engine=bing. google_domain tidak berlaku untuk Bing dan diabaikan. Jawabannya memiliki kerangka yang sama, dengan organic_results dan related_searches; lihat halaman Bing untuk kasus penggunaannya.

Pertanyaan tentang lokasi

Bisakah saya mencari berdasarkan kode ZIP atau koordinat GPS?

Tidak di versi 1. location menerima nama tempat tingkat kota. Untuk hasil di sekitar suatu titik pada peta, gunakan engine=google_maps dengan kueri yang menyebutkan areanya, misalnya dentist Brooklyn.

Mengapa saya mendapat label berbahasa Inggris dengan gl=de?

Karena hl secara default bernilai en. Atur juga hl=de untuk mendapatkan antarmuka, pertanyaan, dan label berbahasa Jerman seperti yang dilihat pengguna di Jerman.

Apakah lokasi mengubah harga pencarian?

Tidak. Setiap pencarian berbiaya 1 kredit, apa pun negara, kota, bahasa, atau perangkatnya. Kredit pencarian prabayar tidak pernah kedaluwarsa: pencarian yang belum terpakai tetap ada di akun Anda sampai Anda menggunakannya.

Kode mana untuk United Kingdom?

Gunakan gb, kode ISO 3166-1-nya. Domain Google untuknya adalah google.co.uk, yang dipilih otomatis oleh API saat gl=gb.

Mulai dari US$0,30/1K pencarian · tanpa KYC

Dapatkan API key