Альтернатива Google Custom Search JSON API для живої органічної видачі

Що змінюється

За документацією Google, Custom Search JSON API закрито для нових клієнтів, а наявні клієнти мають час до 1 січня 2027 року на перехід до альтернативного рішення. Та сама сторінка описує API як спосіб отримувати вебрезультати й результати за зображеннями з Programmable Search Engine — системи, яку ви налаштовуєте і вказуєте через cx.

Дати й умови визначає Google, і вони можуть змінюватися; перевірте їх на сторінці Google, перш ніж призначати дедлайн.

Що натомість повертає Serper.live

Serper.live — живий Google SERP API: кожен запит виконує справжній пошук Google для обраних вами країни й пристрою і повертає органічні результати, показані в цей момент, до 100 на запит (типово 10), у форматі JSON.

Це не власна пошукова система і не пошук по сайту: немає системи для налаштування, немає індексу ваших сторінок. Запит зазвичай триває 2–3 секунди, бо завантажує Google наживо, і тарифікується за запит із передплаченого балансу.

Якщо ваша інтеграція з Custom Search показувала, що Google ранжує за запитом, це ближча заміна. Якщо ж вона забезпечувала пошук усередині вашого сайту чи по фіксованому списку доменів, вам потрібен продукт для пошуку по сайту: документація Google для цього випадку вказує на Vertex AI Search.

Відповідність параметрів

Зліва Custom Search JSON API, справа Serper.live:

• q → query: ключове слово, 2–120 символів.
• gl → country: дволітерний код відкритого ринку з GET /v1/countries (зараз: Німеччина, Франція, Велика Британія, Туреччина, Україна і Сполучені Штати).
• hl → language: мова інтерфейсу Google; необов’язково, типово мова країни.
• num → limit: органічних результатів на запит, 1–100 (типово 10; кожна розпочата десятка коштує одну ціну ринку).
• start → відповідника немає: замість пагінації підніміть limit, і один виклик поверне до 100 органічних результатів.
• cx → не потрібен: системи для налаштування немає, запит шукає в Google для ринку.
• key → заголовок Authorization: Bearer із вашим токеном sl_live_.
• items[] → organic[]: link стає url, displayLink приблизно відповідає domain; title і snippet зберігають назви, а snippet може бути null.

Кроки міграції

Запит нижче — це вся інтеграція; кроки навколо нього:

1. Створіть акаунт і токен, поповніть баланс від $5 у USDT або USDC.
2. Замініть GET до ендпоїнта Custom Search на POST https://api.serper.live/v1/search із JSON-тілом і заголовком Authorization.
3. Зіставте параметри, як описано вище; приберіть cx і start.
4. Читайте organic[] замість items[], перейменуйте link на url і обробляйте snippet зі значенням null.
5. Збільште HTTP-тайм-аут щонайменше до 100 секунд і ставте виклик у чергу, а не виконуйте його всередині запиту користувача: живий пошук зазвичай триває 2–3 секунди, перший для ринку після паузи — довше.
6. Надсилайте Idempotency-Key, щоб повторний виклик не списувався двічі.
7. Кілька днів запускайте обидва паралельно, порівняйте, потім переходьте.

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":"DE"}'

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: 'DE' }),
    signal: AbortSignal.timeout(100000),
});
const result = await response.json();

console.log(result.organic);

import requests

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