Google SERP Парсер
Создание задачи
Отправьте задачу парсинга Google SERP для получения органических результатов поиска по заданному запросу.
Требует области действия serp:google для вашего API-ключа.
Эндпоинт
POST /api/parsing/v1/serp-google
Тело запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| q | string | да | Поисковый запрос |
| count | number | да | Количество результатов (мин.: 10, макс.: 100) |
| hl | string | нет | Код языка результатов (например, en, ru) |
| gl | string | нет | Код страны для результатов поиска (например, us, ru) — см. Доступные страны |
| canonicalLocationName | string | нет | Местоположение для локализованных результатов (например, New York,New York,United States) — см. Доступные города |
| isDesktop | boolean | нет | Эмуляция десктопного браузера (по умолчанию: true) |
| aiOverview | boolean | нет | Парсинг Google AI Overview (по умолчанию: false) |
| callbackUrl | string | нет | URL вебхука для отправки результата по завершении |
| useragent | string | нет | Пользовательская строка User-Agent (только печатаемые ASCII-символы) |
| screenResolution | string | нет | Разрешение экрана браузера (например, 1920x1080, 360x640) |
| parsingDomain | string | нет | Пользовательский домен поиска (например, google.de) |
| takeScreenshot | boolean | нет | Сделать скриншот страницы (по умолчанию: false) |
| params | array of records | нет | Дополнительные параметры поиска (например, [{"key": "tbs", "value": "qdr:m"}]) |
Пример запроса
curl https://app.parsering.com/api/parsing/v1/serp-google \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
"q": "купить пиццу",
"hl": "ru",
"gl": "ru",
"canonicalLocationName": "Moscow,Moscow,Russia",
"count": 10,
"isDesktop": false
}'
Пример ответа
{
"id": "abaf4ac3-d9e7-43f2-a414-e7d2ca9ff635",
"status": "parsing",
"scope": "serp:google",
"costCredits": 1,
"createdAt": "2026-03-20T12:48:05.935Z"
}
Задача обрабатывается асинхронно. Используйте id для опроса результата или укажите callbackUrl для получения вебхука по завершении парсинга.
Следующие шаги
- Получение результата — опрос результата по ID задачи
- Вебхук — получение результата через callback вместо опроса
- Доступные страны — коды стран
glдля геотаргетинга - Доступные города — значения
canonicalLocationNameдля таргетинга по городу - Тарифы — как рассчитываются кредиты для SERP-запросов