Yandex SERP Парсер
Создание задачи
Отправьте задачу парсинга Яндекс SERP для получения органических результатов поиска по заданному запросу.
Требует области действия serp:yandex для вашего API-ключа.
Эндпоинт
POST /api/parsing/v1/serp-yandex
Тело запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| q | string | да | Поисковый запрос |
| count | number | да | Количество результатов |
| region | number | нет | Код региона Яндекса (параметр lr) для геотаргетинга (например, 213 для Москвы) — см. Доступные города |
| callbackUrl | string | нет | URL вебхука для отправки результата по завершении |
Пример запроса
curl https://app.parsering.com/api/parsing/v1/serp-yandex \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
"q": "купить пиццу",
"count": 10,
"region": 213
}'
Пример ответа
{
"id": "c1d2e3f4-a1b2-4c3d-8e9f-000111222333",
"status": "parsing",
"scope": "serp",
"costCredits": 1,
"createdAt": "2026-05-08T10:00:00.000Z"
}
Задача обрабатывается асинхронно. Используйте id для опроса результата или укажите callbackUrl для получения вебхука по завершении парсинга.
Следующие шаги
- Получение результата — опрос результата по ID задачи
- Вебхук — получение результата через callback вместо опроса
- Доступные города — коды регионов Яндекса (
yandex_lr) для геотаргетинга - Тарифы — как рассчитываются кредиты для SERP-запросов