ДОКУМЕНТАЦІЯ ДЛЯ РОЗРОБНИКІВ

Документація Serper.live API

Один ендпоїнт, який виконує справжній пошук Google для обраного ринку і повертає органічні результати як JSON. Кожен запит живий: нічого не кешується і не відтворюється з архіву.

Базова адреса
https://api.serper.live
Автентифікація
Bearer-токен
Формат
JSON через HTTPS
На цій сторінці
01

Швидкий старт

Три кроки від порожнього акаунта до першого живого результату.

  1. Створіть акаунт і токен у розділі API-токени. Повне значення токена показується один раз, тож збережіть його в менеджері секретів.
  2. Перші 100 пошуків безкоштовні. Поповніть баланс карткою або в USDT чи USDC на сторінці Баланс, коли знадобиться більше; ціна й калькулятор вартості — на сторінці цін.
  3. Надішліть запит нижче зі своїм токеном. У відповіді буде поточна видача Google для цього ринку.
curl
curl -X POST https://api.serper.live/v1/search \
  -H "Authorization: Bearer sl_live_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"best coffee shops","country":"AE"}'
JavaScript
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({ query: 'best coffee shops', country: 'AE' }),
    signal: AbortSignal.timeout(100000),
});
const result = await response.json();

console.log(result.organic);
Python
import requests

response = requests.post(
    "https://api.serper.live/v1/search",
    headers={"Authorization": "Bearer sl_live_YOUR_TOKEN"},
    json={"query": "best coffee shops", "country": "AE"},
    timeout=100,
)
print(response.json()["organic"])
PHP
<?php

$context = stream_context_create(['http' => [
    'method' => 'POST',
    'header' => "Authorization: Bearer sl_live_YOUR_TOKEN\r\nContent-Type: application/json",
    'content' => json_encode(['query' => 'best coffee shops', 'country' => 'AE']),
    'timeout' => 100,
]]);
$result = json_decode(file_get_contents('https://api.serper.live/v1/search', false, $context), true);

print_r($result['organic']);

Живий пошук зазвичай відповідає за 2–3 секунди; перший запит до ринку після паузи триває довше, поки там відкривається свіжа сесія Google. Тримайте тайм-аут клієнта щонайменше 100 секунд, щоб повільний перший запит ніколи не падав на вашому боці.

02

Автентифікація

Кожен запит до /v1/search передає ваш токен у заголовку Authorization:

HTTP
Authorization: Bearer sl_live_YOUR_TOKEN
  • Токени починаються з sl_live_ і створюються в розділі API-токени. Створюйте окремий токен для кожного застосунку, щоб відкликати його, не зачіпаючи інших.
  • Тримайте токени на своєму сервері. Ніколи не вбудовуйте їх у браузер, мобільний застосунок чи публічний репозиторій.
  • Відкликаний токен перестає працювати одразу; історія його запитів лишається у вашому акаунті.
HTTP Код Значення
401 unauthorized Відсутній заголовок Authorization.
401 invalid_token Токен має неправильний формат, відкликаний або невідомий.
03

POST https://api.serper.live/v1/search

Виконує один живий пошук Google і повертає органічні результати. Запит і відповідь у JSON; тіло запиту обмежене 16 КБ.

Тіло запиту

Поле Тип Обов’язкове Опис
query string так 2–120 символів. Пробіли згортаються; керівні символи відхиляються.
country string так Дволітерний ISO-код ринку, наприклад AE. Має бути одним із кодів з GET /v1/countries.
language string ні Мова інтерфейсу Google (hl), наприклад tr, en або pt-BR. Типово мова країни.
device string ні desktop (типово) або mobile. Змінює профіль браузера, а отже й компонування видачі.
limit integer ні Кількість органічних результатів, 1–100. Типово 10. Кожна розпочата десятка резервує одну ціну: limit 25 резервує три, а оплачуються лише десятки, що отримали результати.

Відповідь

Поле Опис
requestId UUID цього запиту. Він є в історії запитів; вказуйте його, коли повідомляєте про проблему.
query, country, language, device Нормалізовані значення, які було фактично використано.
fetchedAt Часова мітка живого пошуку в ISO 8601.
latencyMs Тривалість живого пошуку в мілісекундах.
pages Десятки результатів, на які вистачило результатів: не більше, ніж ви запитали, 0 — коли Google нічого не знайшов.
freePages Скільки з цих десяток покрито безкоштовними пошуками вашого акаунта: вони витрачаються раніше за баланс.
price, currency Вартість цього запиту числом у USD: ціна ринку, помножена на платні десятки (pages мінус freePages). 0, коли нічого не знайдено або запит покрили безкоштовні пошуки.
organic[] Органічні результати в порядку ранжування: position, title, url, domain і snippet. snippet дорівнює null, коли Google не показує опис.
peopleAlsoAsk[] Питання з блоку Google «Люди також запитують» («People also ask») простими рядками в порядку сторінки; порожній масив, коли Google його не показує.
relatedSearches[] Схожі запити, які Google пропонує під результатами («People also search for»), простими рядками без повторів; порожній масив, коли їх немає.
200 OK
{
    "requestId": "0199860b-2f4e-7a1c-9b3d-5e6f70819a2b",
    "query": "best coffee shops",
    "country": "AE",
    "language": "en",
    "device": "desktop",
    "fetchedAt": "2026-09-28T14:00:00.000Z",
    "latencyMs": 1873,
    "pages": 1,
    "freePages": 0,
    "price": 0.005,
    "currency": "USD",
    "organic": [
        {
            "position": 1,
            "title": "The 12 best coffee shops in town",
            "url": "https://example.com/guides/best-coffee-shops",
            "domain": "example.com",
            "snippet": "A curated list of specialty coffee shops, updated every month."
        },
        {
            "position": 2,
            "title": "Coffee shops near me",
            "url": "https://maps.example.org/coffee",
            "domain": "maps.example.org",
            "snippet": null
        }
    ],
    "peopleAlsoAsk": [
        "What is the best coffee shop in town?",
        "How much does a specialty coffee cost?"
    ],
    "relatedSearches": [
        "best coffee shops near me",
        "specialty coffee roasters",
        "coffee shop with wifi"
    ]
}
Результати збираються з кількох сторінок видачі, доки не буде досягнуто limit, без власних навігаційних елементів Google і без дублікатів.

Органічні результати: поля organic[]

Кожен елемент organic[] — один органічний результат у тому порядку, в якому їх показує Google. Власні навігаційні елементи Google і дублікати відкидаються, а результати збираються з кількох сторінок видачі, доки не буде досягнуто limit.

Поля однакові для desktop і mobile та для всіх ринків:

Поле Тип Опис
position integer Позиція серед органічних результатів, від 1 до limit (щонайбільше 100), наскрізно по сторінках видачі Google. Рахуються лише органічні елементи, тож саме це число зберігає трекер позицій.
title string Заголовок результату, як він показаний на сторінці.
url string Повна адреса результату.
domain string Хост із url, наприклад maps.example.org. Порівнюйте це поле, коли шукаєте сайт.
snippet string або null Опис під заголовком; null, коли Google його не показує.
04

Країни

GET https://api.serper.live/v1/countries

Публічний, токен не потрібен. Повертає ринки, відкриті просто зараз, і типову мову Google для кожного; кожен ринок підтримує і desktop, і mobile.

curl
curl https://api.serper.live/v1/countries
JavaScript
const response = await fetch('https://api.serper.live/v1/countries');
const { countries } = await response.json();

console.log(countries);
Python
import requests

response = requests.get("https://api.serper.live/v1/countries", timeout=10)
print(response.json()["countries"])
PHP
<?php

$result = json_decode(file_get_contents('https://api.serper.live/v1/countries'), true);

print_r($result['countries']);
200 OK
{
    "countries": [
        {
            "code": "AE",
            "defaultLanguage": "ar"
        },
        {
            "code": "AL",
            "defaultLanguage": "sq"
        },
        {
            "code": "AM",
            "defaultLanguage": "hy"
        },
        {
            "code": "AO",
            "defaultLanguage": "pt"
        },
        {
            "code": "AR",
            "defaultLanguage": "es"
        },
        {
            "code": "AT",
            "defaultLanguage": "de"
        },
        {
            "code": "AU",
            "defaultLanguage": "en"
        },
        {
            "code": "AZ",
            "defaultLanguage": "az"
        },
        {
            "code": "BA",
            "defaultLanguage": "bs"
        },
        {
            "code": "BD",
            "defaultLanguage": "bn"
        },
        {
            "code": "BE",
            "defaultLanguage": "nl"
        },
        {
            "code": "BG",
            "defaultLanguage": "bg"
        },
        {
            "code": "BH",
            "defaultLanguage": "ar"
        },
        {
            "code": "BO",
            "defaultLanguage": "es"
        },
        {
            "code": "BR",
            "defaultLanguage": "pt"
        },
        {
            "code": "CA",
            "defaultLanguage": "en"
        },
        {
            "code": "CD",
            "defaultLanguage": "fr"
        },
        {
            "code": "CH",
            "defaultLanguage": "de"
        },
        {
            "code": "CI",
            "defaultLanguage": "fr"
        },
        {
            "code": "CL",
            "defaultLanguage": "es"
        },
        {
            "code": "CO",
            "defaultLanguage": "es"
        },
        {
            "code": "CR",
            "defaultLanguage": "es"
        },
        {
            "code": "CY",
            "defaultLanguage": "el"
        },
        {
            "code": "CZ",
            "defaultLanguage": "cs"
        },
        {
            "code": "DE",
            "defaultLanguage": "de"
        },
        {
            "code": "DK",
            "defaultLanguage": "da"
        },
        {
            "code": "DO",
            "defaultLanguage": "es"
        },
        {
            "code": "DZ",
            "defaultLanguage": "ar"
        },
        {
            "code": "EC",
            "defaultLanguage": "es"
        },
        {
            "code": "EE",
            "defaultLanguage": "et"
        },
        {
            "code": "EG",
            "defaultLanguage": "ar"
        },
        {
            "code": "ES",
            "defaultLanguage": "es"
        },
        {
            "code": "ET",
            "defaultLanguage": "am"
        },
        {
            "code": "FI",
            "defaultLanguage": "fi"
        },
        {
            "code": "FR",
            "defaultLanguage": "fr"
        },
        {
            "code": "GB",
            "defaultLanguage": "en"
        },
        {
            "code": "GE",
            "defaultLanguage": "ka"
        },
        {
            "code": "GH",
            "defaultLanguage": "ak"
        },
        {
            "code": "GR",
            "defaultLanguage": "el"
        },
        {
            "code": "GT",
            "defaultLanguage": "es"
        },
        {
            "code": "HK",
            "defaultLanguage": "zh"
        },
        {
            "code": "HN",
            "defaultLanguage": "es"
        },
        {
            "code": "HR",
            "defaultLanguage": "hr"
        },
        {
            "code": "HU",
            "defaultLanguage": "hu"
        },
        {
            "code": "ID",
            "defaultLanguage": "id"
        },
        {
            "code": "IE",
            "defaultLanguage": "en"
        },
        {
            "code": "IL",
            "defaultLanguage": "he"
        },
        {
            "code": "IN",
            "defaultLanguage": "hi"
        },
        {
            "code": "IQ",
            "defaultLanguage": "ar"
        },
        {
            "code": "IS",
            "defaultLanguage": "is"
        },
        {
            "code": "IT",
            "defaultLanguage": "it"
        },
        {
            "code": "JM",
            "defaultLanguage": "en"
        },
        {
            "code": "JO",
            "defaultLanguage": "ar"
        },
        {
            "code": "JP",
            "defaultLanguage": "ja"
        },
        {
            "code": "KE",
            "defaultLanguage": "sw"
        },
        {
            "code": "KG",
            "defaultLanguage": "ky"
        },
        {
            "code": "KH",
            "defaultLanguage": "km"
        },
        {
            "code": "KR",
            "defaultLanguage": "ko"
        },
        {
            "code": "KW",
            "defaultLanguage": "ar"
        },
        {
            "code": "KZ",
            "defaultLanguage": "ru"
        },
        {
            "code": "LB",
            "defaultLanguage": "ar"
        },
        {
            "code": "LK",
            "defaultLanguage": "si"
        },
        {
            "code": "LT",
            "defaultLanguage": "lt"
        },
        {
            "code": "LU",
            "defaultLanguage": "fr"
        },
        {
            "code": "LV",
            "defaultLanguage": "lv"
        },
        {
            "code": "MA",
            "defaultLanguage": "ar"
        },
        {
            "code": "MD",
            "defaultLanguage": "ro"
        },
        {
            "code": "MK",
            "defaultLanguage": "mk"
        },
        {
            "code": "MM",
            "defaultLanguage": "my"
        },
        {
            "code": "MN",
            "defaultLanguage": "mn"
        },
        {
            "code": "MT",
            "defaultLanguage": "mt"
        },
        {
            "code": "MX",
            "defaultLanguage": "es"
        },
        {
            "code": "MY",
            "defaultLanguage": "ms"
        },
        {
            "code": "MZ",
            "defaultLanguage": "pt"
        },
        {
            "code": "NG",
            "defaultLanguage": "en"
        },
        {
            "code": "NI",
            "defaultLanguage": "es"
        },
        {
            "code": "NL",
            "defaultLanguage": "nl"
        },
        {
            "code": "NO",
            "defaultLanguage": "nb"
        },
        {
            "code": "NP",
            "defaultLanguage": "ne"
        },
        {
            "code": "NZ",
            "defaultLanguage": "en"
        },
        {
            "code": "OM",
            "defaultLanguage": "ar"
        },
        {
            "code": "PA",
            "defaultLanguage": "es"
        },
        {
            "code": "PE",
            "defaultLanguage": "es"
        },
        {
            "code": "PH",
            "defaultLanguage": "fil"
        },
        {
            "code": "PK",
            "defaultLanguage": "ur"
        },
        {
            "code": "PL",
            "defaultLanguage": "pl"
        },
        {
            "code": "PR",
            "defaultLanguage": "es"
        },
        {
            "code": "PT",
            "defaultLanguage": "pt"
        },
        {
            "code": "PY",
            "defaultLanguage": "gn"
        },
        {
            "code": "QA",
            "defaultLanguage": "ar"
        },
        {
            "code": "RO",
            "defaultLanguage": "ro"
        },
        {
            "code": "RS",
            "defaultLanguage": "sr"
        },
        {
            "code": "SA",
            "defaultLanguage": "ar"
        },
        {
            "code": "SE",
            "defaultLanguage": "sv"
        },
        {
            "code": "SG",
            "defaultLanguage": "en"
        },
        {
            "code": "SI",
            "defaultLanguage": "sl"
        },
        {
            "code": "SK",
            "defaultLanguage": "sk"
        },
        {
            "code": "SN",
            "defaultLanguage": "wo"
        },
        {
            "code": "SV",
            "defaultLanguage": "es"
        },
        {
            "code": "TH",
            "defaultLanguage": "th"
        },
        {
            "code": "TN",
            "defaultLanguage": "ar"
        },
        {
            "code": "TR",
            "defaultLanguage": "tr"
        },
        {
            "code": "TW",
            "defaultLanguage": "zh"
        },
        {
            "code": "TZ",
            "defaultLanguage": "sw"
        },
        {
            "code": "UA",
            "defaultLanguage": "uk"
        },
        {
            "code": "UG",
            "defaultLanguage": "sw"
        },
        {
            "code": "US",
            "defaultLanguage": "en"
        },
        {
            "code": "UY",
            "defaultLanguage": "es"
        },
        {
            "code": "UZ",
            "defaultLanguage": "uz"
        },
        {
            "code": "VE",
            "defaultLanguage": "es"
        },
        {
            "code": "VN",
            "defaultLanguage": "vi"
        },
        {
            "code": "ZA",
            "defaultLanguage": "en"
        },
        {
            "code": "ZM",
            "defaultLanguage": "en"
        },
        {
            "code": "ZW",
            "defaultLanguage": "sn"
        }
    ]
}

Нові ринки з’являються в цій відповіді й на сторінці цін у міру запуску. Запит для закритого ринку повертає 422 country_unavailable разом зі списком доступних кодів.

05

Тарифікація

На вашому акаунті є передплачений баланс у USD, а починається він зі 100 безкоштовних пошуків. До початку пошуку кожен запит резервує поточну ціну свого ринку за кожну розпочату десятку результатів: limit до 10 резервує одну ціну, limit 25 — три. Безкоштовні пошуки покривають перші десятки запиту ще до того, як резервуються гроші.

  • Успішний пошук: ціна списується за кожну десятку, на яку вистачило результатів, а решта резерву одразу повертається на баланс. limit 50 і 12 результатів коштують дві ціни, а не п’ять; пошук, що нічого не знайшов, не коштує нічого.
  • Безкоштовні пошуки: кожен новий акаунт отримує їх 100, по одному на десятку результатів, на будь-якому ринку й пристрої. Запит витрачає їх раніше за баланс, а десятки без результатів повертаються до безкоштовних так само, як гроші повертаються на баланс; freePages у відповіді каже, скільки десяток запит узяв із них.
  • Невдалий пошук, тобто відповідь 408, 424 чи будь-яка 5xx: резерв знімається автоматично. Ви ніколи не платите за результат, якого не отримали.
  • Ціни можуть змінюватися з часом, але ціна, зарезервована для запиту, що вже виконується, не змінюється ніколи.
  • Недостатньо коштів: 402 insufficient_balance. Поповніть баланс на сторінці Баланс; кошти доступні за кілька хвилин після підтвердження депозиту.

Кожен запит, його статус і вартість перелічені в історії запитів; кожна зміна балансу є в журналі на сторінці балансу.

06

Помилки

Помилки повертаються як JSON із машинозчитуваним кодом error, зрозумілим людині message і, якщо запит уже створено, його requestId:

JSON
{
    "error": "insufficient_balance",
    "message": "The balance does not cover one request",
    "requestId": "0199860b-2f4e-7a1c-9b3d-5e6f70819a2b"
}
HTTP Код Значення Повторювати?
400 invalid_json Тіло не є коректним JSON. Виправте запит
401 unauthorized
invalid_token
Див. «Автентифікація». Виправте токен
402 insufficient_balance Баланс не покриває один запит. Після поповнення
408 search_timeout Пошук не завершився за 90 секунд. Так
409 idempotency_in_progress
idempotency_replay_unavailable
Див. «Безпечні повторні запити». Залежить від коду
413 payload_too_large Тіло перевищує 16 КБ. Виправте запит
422 invalid_request
country_unavailable
Поле не пройшло валідацію (яке саме, вказано в повідомленні) або ринок не відкрито. Виправте запит
424 proxy_unavailable
captcha_failed
search_failed
Живий пошук не вдався на нашому боці. Так, після короткої паузи
503 busy
billing_unavailable
configuration_error
Сервіс завантажений або тимчасово недоступний. Так, зі зростанням інтервалу
Жодна відповідь 408, 424 чи 5xx не тарифікується. Повторюйте 408, 424 і 503 з експоненційною затримкою, наприклад через 5, 15 і 45 секунд, а не в щільному циклі, і з новим Idempotency-Key: той самий ключ до 15 хвилин повертає ту саму помилку замість нового пошуку.
07

Безпечні повторні запити

Необов’язково. Потрібно лише тоді, коли ваш клієнт може повторити запит, який обірвався.

Живий пошук триває до 90 секунд. Якщо за цей час з’єднання розірветься, ви не знатимете, чи пошук завершився і чи його тарифіковано. Заголовок Idempotency-Key дає змогу повторити запит, не заплативши двічі:

  • Той самий ключ: якщо перший пошук завершився, ви знову отримаєте ту саму відповідь із заголовком Idempotent-Replayed: true і без другого списання; пошук, що завершився збоєм, повертає ту саму помилку. Якщо він ще виконується, повторний запит дочекається його. Повторюйте ключ лише тоді, коли ви не отримали результат, після обриву з’єднання чи тайм-ауту клієнта; після 408, 424 чи 5xx надсилайте новий ключ.
  • Пошук визначає лише ключ: повтор з іншим тілом отримує відповідь першого запиту, тож новий пошук надсилайте з новим ключем.
  • Результати зберігаються до 15 хвилин. Після цього повтор зі старим ключем повертає 409 idempotency_replay_unavailable; надішліть новий запит із новим ключем.
  • Без заголовка кожен запит новий і тарифікується окремо.
curl
curl -X POST https://api.serper.live/v1/search \
  -H "Authorization: Bearer sl_live_YOUR_TOKEN" \
  -H "Idempotency-Key: 0199860b-2f4e-7a1c-9b3d-5e6f70819a2b" \
  -H "Content-Type: application/json" \
  -d '{"query":"best coffee shops","country":"AE","limit":10}'
JavaScript
const response = await fetch('https://api.serper.live/v1/search', {
    method: 'POST',
    headers: {
        Authorization: 'Bearer sl_live_YOUR_TOKEN',
        'Idempotency-Key': '0199860b-2f4e-7a1c-9b3d-5e6f70819a2b',
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({ query: 'best coffee shops', country: 'AE', limit: 10 }),
    signal: AbortSignal.timeout(100000),
});
const result = await response.json();
Python
import requests

response = requests.post(
    "https://api.serper.live/v1/search",
    headers={
        "Authorization": "Bearer sl_live_YOUR_TOKEN",
        "Idempotency-Key": "0199860b-2f4e-7a1c-9b3d-5e6f70819a2b",
    },
    json={"query": "best coffee shops", "country": "AE", "limit": 10},
    timeout=100,
)
result = response.json()
PHP
<?php

$context = stream_context_create(['http' => [
    'method' => 'POST',
    'header' => "Authorization: Bearer sl_live_YOUR_TOKEN\r\nIdempotency-Key: 0199860b-2f4e-7a1c-9b3d-5e6f70819a2b\r\nContent-Type: application/json",
    'content' => json_encode(['query' => 'best coffee shops', 'country' => 'AE', 'limit' => 10]),
    'timeout' => 100,
]]);
$result = json_decode(file_get_contents('https://api.serper.live/v1/search', false, $context), true);

Ключ — будь-який рядок із 8–128 символів набору A-Za-z0-9._:-. Найпростіший вибір — новий UUID на кожен логічний запит; він має лишатися однаковим для всіх повторів цього запиту.

08

Обмеження і корисне

  • query 2–120 символів, limit 1–100, тіло запиту до 16 КБ.
  • Пошуки виконуються паралельно в межах потужності сервісу; понад неї ви отримаєте 503 busy. Повторюйте зі зростанням інтервалу.
  • Зазвичай 2–3 секунди на 10 результатів і близько секунди на кожну наступну сторінку; пошук, що триває понад 90 секунд, завершується 408 search_timeout. Установіть тайм-аут клієнта щонайменше 100 секунд.
  • Кожна відповідь має заголовок X-Request-Id. Зберігайте його в логах поруч із requestId з тіла.
  • Нічого не кешується: два однакові запити — це два живі пошуки і два списання. Якщо повторно використовуєте результати, кешуйте на своєму боці.
09

Як знайти позицію домену

API повертає органічні результати до limit, типово топ-10; знайти в ньому один сайт — це цикл по organic[] у вашому коді. Порівняйте domain кожного елемента з хостом, який ви відстежуєте: position першого збігу і є позицією для цього ключового слова, країни й пристрою. Приклад нижче робить саме це, з тим самим запитом у curl, JavaScript і Python.

Три правила роблять порівняння чесним:

  • Нормалізуйте перед порівнянням: переведіть обидві сторони в нижній регістр, відкиньте початкове www. і порівнюйте лише хости, а не повні URL.
  • Вирішіть, як рахувати субдомени. blog.example.com — інший хост, ніж example.com; для суворого трекера порівнюйте точний хост, а для трекера на рівні бренду вважайте тим самим сайтом будь-який хост, що закінчується на .example.com.
  • Відсутність збігу означає, що в цій перевірці сайт поза запитаним діапазоном, а не помилку. Так це й зберігайте: запит повертає щонайбільше limit органічних результатів, тож підніміть limit (до 100, одна ціна за кожні 10), якщо відстежуєте позиції глибше за топ-10.
curl
curl -s -X POST https://api.serper.live/v1/search \
  -H "Authorization: Bearer sl_live_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"best coffee shops","country":"AE","device":"desktop"}' \
  | jq '.organic[] | select(.domain == "example.com") | .position'
JavaScript
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({ query: 'best coffee shops', country: 'AE', device: 'desktop' }),
    signal: AbortSignal.timeout(100000),
});
const { organic } = await response.json();
const hit = organic.find(row => row.domain === 'example.com');

console.log(hit ? hit.position : 'outside the top 10');
Python
import requests

response = requests.post(
    "https://api.serper.live/v1/search",
    headers={"Authorization": "Bearer sl_live_YOUR_TOKEN"},
    json={"query": "best coffee shops", "country": "AE", "device": "desktop"},
    timeout=100,
)
organic = response.json()["organic"]
position = next((row["position"] for row in organic if row["domain"] == "example.com"), None)
print(position or "outside the top 10")
PHP
<?php

$context = stream_context_create(['http' => [
    'method' => 'POST',
    'header' => "Authorization: Bearer sl_live_YOUR_TOKEN\r\nContent-Type: application/json",
    'content' => json_encode(['query' => 'best coffee shops', 'country' => 'AE', 'device' => 'desktop']),
    'timeout' => 100,
]]);
$result = json_decode(file_get_contents('https://api.serper.live/v1/search', false, $context), true);
$hit = array_find($result['organic'], fn(array $row) => $row['domain'] === 'example.com');

echo $hit['position'] ?? 'outside the top 10';

Сторінка API відстеження позицій описує повний цикл трекера: списки ключових слів, розклад, зберігання і вартість місяця перевірок.

10

Для AI-агентів (MCP)

MCP-сервер Serper.live дає AI-агентам — Claude, OpenAI Codex, Cursor, VS Code Copilot — живий пошук Google через цей API. Він запускається локально через npx, потребує Node.js 20 або новішого й автентифікується тим самим API-токеном у змінній середовища SERPER_LIVE_TOKEN; пошуки тарифікуються так само, як POST /v1/search.

  • google_search: живі органічні результати для ключового слова, країни, мови й пристрою, до 100 за виклик.
  • domain_position: на якій позиції домен за ключовим словом; піддомен рахується як домен, а якщо сайт трапляється кілька разів, повертається кожна позиція.
  • list_countries: відкриті ринки й типова мова Google для кожного; безкоштовно, без токена.
Claude Code
claude mcp add serper-live -e SERPER_LIVE_TOKEN=sl_live_YOUR_TOKEN -- npx -y @serper-live/mcp
Claude Desktop · Cursor
{
    "mcpServers": {
        "serper-live": {
            "command": "npx",
            "args": [
                "-y",
                "@serper-live/mcp"
            ],
            "env": {
                "SERPER_LIVE_TOKEN": "sl_live_YOUR_TOKEN"
            }
        }
    }
}
VS Code
{
    "inputs": [
        {
            "type": "promptString",
            "id": "serper-live-token",
            "description": "Serper.live API token",
            "password": true
        }
    ],
    "servers": {
        "serper-live": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@serper-live/mcp"
            ],
            "env": {
                "SERPER_LIVE_TOKEN": "${input:serper-live-token}"
            }
        }
    }
}
Codex
[mcp_servers.serper-live]
command = "npx"
args = ["-y", "@serper-live/mcp"]

[mcp_servers.serper-live.env]
SERPER_LIVE_TOKEN = "sl_live_YOUR_TOKEN"

Пакет — @serper-live/mcp в npm і io.github.serper-live/serper-live-mcp в офіційному MCP Registry; README в репозиторії описує налаштування для інших клієнтів. Claude Desktop також встановлює його в один клік із бандла .mcpb і сам запитує токен, без Node.js.

Почати

Надішліть свій перший живий запит

Створіть акаунт, отримайте 100 безкоштовних пошуків і надішліть запит зі швидкого старту; перший живий результат буде за лічені секунди. Поповніть баланс карткою від $10 або в USDT чи USDC від $5, коли знадобиться більше. Ще не готові до токена? Пісочниця виконує три живі пошуки на IP-адресу на день без акаунта і показує ту саму органічну видачу.