Yeni pazarlar
Her pazarın country parametresi için iki harfli bir kodu ve varsayılan bir Google arayüz dili vardır; istekte language yoksa API bu dili hl olarak gönderir.
| Bölge | Pazar | Kod | Varsayılan dil |
|---|---|---|---|
| Avrupa | Avusturya | AT |
de |
| Avrupa | Belçika | BE |
nl |
| Avrupa | Danimarka | DK |
da |
| Avrupa | Finlandiya | FI |
fi |
| Avrupa | İrlanda | IE |
en |
| Avrupa | İtalya | IT |
it |
| Avrupa | Hollanda | NL |
nl |
| Avrupa | Norveç | NO |
nb |
| Avrupa | Polonya | PL |
pl |
| Avrupa | Portekiz | PT |
pt |
| Avrupa | İspanya | ES |
es |
| Avrupa | İsveç | SE |
sv |
| Avrupa | İsviçre | CH |
de |
| Amerika | Brezilya | BR |
pt |
| Amerika | Kanada | CA |
en |
| Amerika | Meksika | MX |
es |
| Asya-Pasifik | Avustralya | AU |
en |
| Asya-Pasifik | Hindistan | IN |
en |
Bu pazarlar Almanya, Fransa, Birleşik Krallık, Türkiye, Ukrayna ve Amerika Birleşik Devletleri'ne katılıyor. GET /v1/countries açık pazarların tamamını anahtar gerektirmeden JSON olarak döndürür; her pazarın fiyatı fiyat sayfasında yer alır.
Her pazar için aynı istek
Kodunuzda hiçbir şey değişmez. Zaten takip ettiğiniz pazarlarda olduğu gibi, yeni country koduyla POST /v1/search gönderin. Masaüstü ve mobil her pazarda aynı fiyatla açıktır; limit tek çağrıda 100 sonuca kadar döndürür.
Örnek, bir anahtar kelimeyi dört yeni pazarda, her birinde yerel dilde ve mobilde kontrol eder ve bir alan adının sıralarını yazdırır. İsviçre'de varsayılan Almanca arayüzün yerine language fr kullanır:
curl -s -X POST https://api.serper.live/v1/search \
-H "Authorization: Bearer sl_live_YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query":"logiciel de gestion de projet","country":"CH","language":"fr","device":"mobile"}' \
| jq '[.organic[] | select(.domain == "example.com") | .position]'
const checks = [
{ query: 'software de gestión de proyectos', country: 'ES' },
{ query: 'software de gestión de proyectos', country: 'MX' },
{ query: 'software de gestão de projetos', country: 'BR' },
{ query: 'logiciel de gestion de projet', country: 'CH', language: 'fr' },
];
for (const check of checks) {
const response = await fetch('https://api.serper.live/v1/search', {
method: 'POST',
headers: {
Authorization: 'Bearer sl_live_YOUR_TOKEN',
'Content-Type': 'application/json',
},
body: JSON.stringify({ ...check, device: 'mobile' }),
signal: AbortSignal.timeout(100000),
});
const { organic } = await response.json();
const positions = organic.filter(row => row.domain === 'example.com').map(row => row.position);
console.log(check.country, check.query, positions);
}
import requests
CHECKS = [
{"query": "software de gestión de proyectos", "country": "ES"},
{"query": "software de gestión de proyectos", "country": "MX"},
{"query": "software de gestão de projetos", "country": "BR"},
{"query": "logiciel de gestion de projet", "country": "CH", "language": "fr"},
]
for check in CHECKS:
response = requests.post(
"https://api.serper.live/v1/search",
headers={"Authorization": "Bearer sl_live_YOUR_TOKEN"},
json={**check, "device": "mobile"},
timeout=100,
)
organic = response.json()["organic"]
positions = [row["position"] for row in organic if row["domain"] == "example.com"]
print(check["country"], check["query"], positions)
<?php
$checks = [
['query' => 'software de gestión de proyectos', 'country' => 'ES'],
['query' => 'software de gestión de proyectos', 'country' => 'MX'],
['query' => 'software de gestão de projetos', 'country' => 'BR'],
['query' => 'logiciel de gestion de projet', 'country' => 'CH', 'language' => 'fr'],
];
foreach ($checks as $check) {
$context = stream_context_create(['http' => [
'method' => 'POST',
'header' => "Authorization: Bearer sl_live_YOUR_TOKEN\r\nContent-Type: application/json",
'content' => json_encode([...$check, 'device' => 'mobile']),
'timeout' => 100,
]]);
$result = json_decode(file_get_contents('https://api.serper.live/v1/search', false, $context), true);
$positions = array_column(array_filter($result['organic'], fn(array $row) => $row['domain'] === 'example.com'), 'position');
echo $check['country'], ' ', $check['query'], ' ', json_encode($positions), PHP_EOL;
}
İlk 10 için her kontrol her pazarda $0.005 tutar. Zamanlama, saklama ve alan adı eşleştirme sıralama takip rehberinde anlatılıyor.
Birden fazla arama dili olan pazarlar
Yeni pazarların birçoğunda birden fazla dilde arama yapılır: Belçika'da Felemenkçe ve Fransızca, İsviçre'de Almanca, Fransızca ve İtalyanca, Kanada'da İngilizce ve Fransızca, Finlandiya'da Fince ve İsveççe, Hindistan'da İngilizce ve Hintçe.
language parametresi Google arayüz dilini belirler; örneğin Belçika veya Kanada için fr, İsviçre için it, Hindistan için hi. Sonuçları değiştirir: Ukrayna'daki ölçümlerimizde arayüz dilini değiştirmek aynı sorgu için ilk 10'un yalnızca yarısını yerinde bıraktı.
Bir pazardaki kitleniz iki dilde arıyorsa, bunları ayrı anahtar kelimeler olarak takip edin ve her sırayla birlikte language değerini saklayın; böylece sonraki kontroller aynı koşulları karşılaştırır.
Maliyeti nedir
En fazla 10 sonuçluk bir sayfa her pazarda $0.005 tutar, yani 1.000 arama için $5.00; tüm pazarlar fiyat sayfasında listelenir. İlk 30 kontrolü üç sayfaya mal olur. Abonelik yoktur: kartla $10'dan, USDT veya USDC ile $5'dan itibaren bakiye yüklersiniz ve bakiyenin süresi dolmaz.
Bir pazarda ayda 100.000 aramadan itibaren, talep üzerine iletişim sayfası üzerinden bireysel koşullar belirliyoruz.
Yapay zekâ ajanlarında ve MCP'de
Serper.live MCP sunucusu pazarları API'den okur; bu yüzden list_countries yenilerini şimdiden döndürür ve güncelleme gerekmez. Ajanınıza örneğin şunu sorun: "example.com, Brezilya'da mobilde software de gestão de projetos için Google'da kaçıncı sırada? İlk 30'u kontrol et."
Claude Code, Claude Desktop, Cursor, VS Code ve Codex kurulumu dokümantasyonda yer alır.
Yeni bir pazarı deneyin
Deneme alanında her yeni pazar için yerel dilde örnek aramalar var; hesap açmadan IP adresi başına günde üç canlı arama yapabilirsiniz. Hazır olduğunuzda hesap oluşturun ve ilk isteği hızlı başlangıçtan gönderin.
Henüz açık olmayan bir ülkeye mi ihtiyacınız var? Hangisi olduğunu bize yazın.