Yandex SERP Парсер

Создание задачи

Отправьте задачу парсинга Яндекс SERP для получения органических результатов поиска по заданному запросу.

Требует области действия serp:yandex для вашего API-ключа.

Эндпоинт

POST /api/parsing/v1/serp-yandex

Тело запроса

ПараметрТипОбязательныйОписание
qstringдаПоисковый запрос
countnumberдаКоличество результатов
regionnumberнетКод региона Яндекса (параметр lr) для геотаргетинга (например, 213 для Москвы) — см. Доступные города
callbackUrlstringнет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 для получения вебхука по завершении парсинга.

Следующие шаги