URL Парсер
Получение результата
Опрашивайте этот эндпоинт для получения результата отправленной задачи парсинга URL.
Эндпоинт
GET /api/parsing/v1/result/url/{requestId}
Продолжайте опрос, пока status не перестанет быть "parsing".
Параметры пути
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| requestId | string (uuid) | да | ID задачи, возвращённый эндпоинтом отправки |
Пример запроса
curl https://app.parsering.com/api/parsing/v1/result/url/YOUR_REQUIEST_ID \
--header 'Authorization: Bearer YOUR_API_KEY'
Ответы
В процессе — задача ещё обрабатывается:
{
"status": "parsing"
}
Готово — задача выполнена успешно:
{
"url": "https://example.com",
"content": "<html>...</html>",
"cookies": [],
"success": true,
"screenshot": null
}
| Поле | Тип | Описание |
|---|---|---|
| url | string | URL, который был обработан |
| success | boolean? | Успешно ли выполнен парсинг страницы |
| content | string? | Исходный HTML страницы. Присутствует, если output.html равен true (по умолчанию) |
| contentMarkdown | string? | Версия страницы в формате Markdown. Присутствует, если output.markdown равен true |
| contentText | string? | Текстовая версия страницы. Присутствует, если output.text равен true |
| contentJSON | object? | Структурированное JSON-представление страницы. Присутствует, если output.json равен true |
| cookies | array? | Cookies, собранные со страницы |
| headers | object? | Заголовки ответа. Присутствуют, если parseHeaders равен true |
| screenshot | string? | Скриншот в кодировке base64. Присутствует, если takeScreenshot равен true |
| proxy | string? | Прокси, использованный для запроса |
| time | string? | Время, затраченное на парсинг |
| error | string? | Краткое сообщение об ошибке, если парсинг не удался |
| errorFull | string? | Полные сведения об ошибке, если парсинг не удался |
| hasBadMarksErr | string? | Указывает, что обнаружена ошибка bad marks |
screenshot содержит изображение в кодировке base64, если в запросе был указан takeScreenshot: true, в противном случае — null.
Важно! Скриншот хранится 1 час после парсинга.
Содержимое страницы хранится 7 дней после парсинга.
Сохраните результаты на своей стороне, чтобы не потерять их.
Следующие шаги
- Вебхук — получение результата через callback вместо опроса
- Создание задачи — вернуться к документации по эндпоинту отправки