Нові ринки
Кожен ринок має дволітерний код для параметра country і типову мову інтерфейсу Google, яку API надсилає як hl, коли в запиті немає language.
| Регіон | Ринок | Код | Типова мова |
|---|---|---|---|
| Європа | Австрія | AT |
de |
| Європа | Бельгія | BE |
nl |
| Європа | Данія | DK |
da |
| Європа | Фінляндія | FI |
fi |
| Європа | Ірландія | IE |
en |
| Європа | Італія | IT |
it |
| Європа | Нідерланди | NL |
nl |
| Європа | Норвегія | NO |
nb |
| Європа | Польща | PL |
pl |
| Європа | Португалія | PT |
pt |
| Європа | Іспанія | ES |
es |
| Європа | Швеція | SE |
sv |
| Європа | Швейцарія | CH |
de |
| Америка | Бразилія | BR |
pt |
| Америка | Канада | CA |
en |
| Америка | Мексика | MX |
es |
| Азія і Тихий океан | Австралія | AU |
en |
| Азія і Тихий океан | Індія | IN |
en |
Вони приєдналися до Німеччини, Франції, Великої Британії, Туреччини, України та США. GET /v1/countries повертає всі відкриті ринки в JSON без токена, а сторінка цін показує ціну кожного.
Один запит для кожного ринку
У вашому коді нічого не змінюється. Надсилайте POST /v1/search з новим кодом country, як і для ринків, які вже відстежуєте. Desktop і mobile відкриті на кожному ринку за однією ціною, а limit повертає до 100 результатів за один виклик.
Приклад перевіряє одне ключове слово на чотирьох нових ринках, на кожному мовою країни й на mobile, і виводить позиції домену. У Швейцарії він замінює типовий німецький інтерфейс на language fr:
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;
}
Кожна перевірка топ-10 коштує $0.005, однаково на всіх ринках. Розклад, зберігання й зіставлення доменів описано в посібнику з відстеження позицій.
Ринки, де шукають кількома мовами
На кількох нових ринках шукають більш ніж однією мовою: у Бельгії — нідерландською й французькою, у Швейцарії — німецькою, французькою й італійською, у Канаді — англійською й французькою, у Фінляндії — фінською й шведською, в Індії — англійською й гінді.
Параметр language задає мову інтерфейсу Google, наприклад fr для Бельгії чи Канади, it для Швейцарії або hi для Індії. Він змінює видачу: у наших замірах в Україні після зміни мови інтерфейсу для того самого запиту лишилася спільною тільки половина топ-10.
Якщо ваша аудиторія на ринку шукає двома мовами, відстежуйте їх як окремі ключові слова й зберігайте language разом із кожною позицією, щоб наступні перевірки порівнювали однакове з однаковим.
Скільки це коштує
Сторінка до 10 результатів коштує $0.005 на всіх ринках, тобто $5.00 за 1 000 пошуків; усі ринки є на сторінці цін. Перевірка топ-30 коштує три сторінки. Підписки немає: ви поповнюєте баланс карткою від $10 або в USDT чи USDC від $5, і кредит не згорає.
Від 100 000 пошуків на місяць на одному ринку ми домовляємося про індивідуальні умови на запит через сторінку зв'язку.
В AI-агентах і MCP
MCP-сервер Serper.live бере ринки з API, тож list_countries уже повертає нові, і оновлювати нічого не треба. Спитайте свого агента, наприклад: «На якій позиції example.com у Google в Бразилії на mobile за запитом software de gestão de projetos? Перевір топ-30.»
Налаштування для Claude Code, Claude Desktop, Cursor, VS Code і Codex — у документації.
Спробуйте новий ринок
У пісочниці для кожного нового ринку є приклади запитів мовою країни, а без акаунта вона запускає три живі пошуки на добу з однієї IP-адреси. Коли будете готові, створіть акаунт і надішліть перший запит зі швидкого старту.
Потрібна країна, якої ще немає? Напишіть нам, яка саме.