Это практичный сквозной гид по использованию Google Search API: аутентификация, отправка запроса, чтение JSON, пагинация, обработка ошибок и снижение затрат. В примерах используется serp.cheap (самый дешёвый вариант в 2026 году), но концепции применимы к любому SERP API.
1. Получите API-ключ
Зарегистрируйтесь на app.serp.cheap — 100 бесплатных поисков (без карты), затем передавайте ключ в заголовке X-API-Key. Если вам удобнее биллинг через маркетплейс, можно подключиться через Apify или RapidAPI.
2. Эндпоинт в одну строку
POST https://api.serp.cheap/v1/search| Параметр | По умолчанию | Описание |
|---|---|---|
q | обязательно | Поисковый запрос |
gl | "us" | Страна (например, br, gb, de) |
hl | язык страны по умолчанию | Переопределение языка интерфейса |
page | 1 | Страница результатов (нумерация с 1) |
tbs | нет | Фильтр по времени: qdr:h, qdr:d, qdr:w |
Полный справочник: параметры Google Search API.
3. Ваш первый запрос
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "best electric cars 2026", "gl": "us", "page": 1}'import requests
r = requests.post(
"https://api.serp.cheap/v1/search",
headers={"X-API-Key": "YOUR_KEY"},
json={"q": "best electric cars 2026", "gl": "us", "page": 1},
)
r.raise_for_status()
data = r.json()
for item in data["organic"]:
print(item["position"], item["title"], item["link"])Руководства по конкретным языкам: Python · Node.js · PHP · Go · curl.
4. Чтение ответа
{
"search": "best electric cars 2026",
"page": 1,
"organic": [
{
"position": 1,
"title": "Best Electric Cars of 2026",
"link": "https://example.com/best-evs",
"snippet": "We tested every major EV...",
"date": "Jan 10, 2026"
}
],
"stats": { "balance": 99994, "cost": 6, "cached": false }
}stats.cost указывается в кредитах (1 кредит = $0.0001). Свежий запрос — это 6 кредитов ($0.0006); попадание в кэш — 3 ($0.0003). stats.cached подсказывает, какой путь вы получили.
5. Пагинация
Каждая страница — это отдельный запрос, увеличивайте page. Загружайте страницу 2 и далее только тогда, когда пользователю это действительно нужно. См. получение 100 результатов.
6. Обработка ошибок
- 401 — неверный или отсутствующий API-ключ.
- 402 — закончились кредиты; пополните.
- 429 — превышен лимит частоты (60 запросов/мин на бесплатном тарифе, 600/мин при оплате по факту, до 60 запросов/с на старших тарифах); сделайте паузу и повторите.
- 5xx — временная ошибка; повторите с экспоненциальной задержкой.
Всегда оборачивайте вызовы в повтор с задержкой для 429/5xx.
7. Держите это дёшево
- Попадания в кэш стоят вдвое дешевле — не форсируйте свежие запросы для повторяющихся запросов.
- Используйте ленивую пагинацию.
- Точно выбирайте
gl, чтобы избежать повторных запусков.
Следующие шаги
- Создайте что-то реальное: трекер позиций на Python или Google Search для ИИ-агентов.
- Сравните провайдеров: самый дешёвый SERP API в 2026.
Попробуйте serp.cheap
Запустите запросы из этого гида против живого эндпоинта за пару минут. 100 бесплатных поисков при регистрации — карта не нужна; дальше оплата по факту от $0.75 за 1000, а кредиты действительны 12 месяцев.
- Получить бесплатный API-ключ →
- Удобнее платить картой? serp.cheap также есть на RapidAPI (
$0.90 за 1000) и Apify ($1.50 за 1000).