Yandex SERP Парсер

Получение результата

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

Эндпоинт

GET /api/parsing/v1/result/serp-yandex/{requestId}

Продолжайте опрос, пока status не перестанет быть "parsing".

Параметры пути

Параметр	Тип	Обязательный	Описание
requestId	string (uuid)	да	ID задачи, возвращённый эндпоинтом отправки

Пример запроса

curl https://app.parsering.com/api/parsing/v1/result/serp-yandex/YOUR_REQUEST_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

Ответы

В процессе — задача ещё обрабатывается:

{
  "status": "parsing"
}

Готово — задача выполнена успешно:

{
  "status": "ready",
  "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"
}

Поля ответа

Поле	Тип	Описание
status	string	`"ready"` при завершении
requestId	string	ID задачи
data.organic	array	Органические результаты поиска
data.organic[].rank	number	Позиция в результатах (начиная с 1)
data.organic[].link	string	URL результата
data.organic[].title	string	Заголовок результата
data.organic[].description	string	Сниппет результата
respondedAt	string	Временная метка завершения в формате ISO 8601

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

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

Вебхук — получение результата через callback вместо опроса
Создание задачи — вернуться к документации по эндпоинту отправки