Yandex SERP Парсер

Вебхук

Укажите callbackUrl в теле запроса на отправку задачи, чтобы получать результат через вебхук вместо опроса. После завершения парсинга сервер отправляет POST-запрос на этот URL с payload результата.

Отправка с callback

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,
  "callbackUrl": "https://my-server.com/webhook/parsing"
}'

Payload вебхука

Убедитесь, что ваш эндпоинт вебхука отвечает кодом 2xx для подтверждения получения.

Ваш эндпоинт получит POST-запрос со следующим JSON-телом:

{
  "status": "ready",
  "scope": "serp",
  "requestId": "c1d2e3f4-a1b2-4c3d-8e9f-000111222333",
  "data": {
    "organic": [
      {
        "link": "https://pizza.ru/",
        "rank": 1,
        "title": "Pizza - Order Online",
        "description": "Fast pizza delivery across the city."
      }
    ]
  },
  "respondedAt": "2026-05-08T10:00:06.000Z"
}

Важно! Скриншот хранится 1 час после парсинга.
Сохраните результаты на своей стороне, чтобы не потерять их.

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