URL Парсер
Создание задачи
Отправьте задачу парсинга URL для получения полного HTML-содержимого любой страницы с использованием реального браузера. Также поддерживаются ответы в формате текста, Markdown и структурированного JSON.
Требует области действия url-scraper для вашего API-ключа.
Эндпоинт
POST /api/parsing/v1/url
Тело запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| url | string | да | Целевой URL для парсинга |
| proxy | string | нет | URL прокси: http://user:pass@host:port |
| useragent | string | нет | Пользовательская строка User-Agent (только печатаемые ASCII-символы) |
| isMobile | boolean | нет | Эмуляция мобильного браузера |
| solveCaptcha | boolean | нет | Попытка решить капчу при обнаружении |
| callbackUrl | string | нет | URL вебхука для отправки результата по завершении |
| takeScreenshot | boolean | нет | Сделать скриншот страницы |
| parseHeaders | boolean | нет | Получить заголовки ответа |
| output | object | нет | Форматы вывода. По умолчанию: {"html": true}. Должен быть включён хотя бы один формат. |
| output.html | boolean | нет | Включить исходный HTML |
| output.markdown | boolean | нет | Включить версию страницы в формате Markdown |
| output.text | boolean | нет | Включить текстовую версию страницы |
| output.json | boolean | нет | Включить структурированное JSON-представление |
Пример запроса
curl https://app.parsering.com/api/parsing/v1/url \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
"url": "https://example.com",
"isMobile": false,
"solveCaptcha": false,
"takeScreenshot": false
}'
Пример ответа
{
"id": "ac9c7911-b32c-4890-a850-227003ee2d35",
"status": "parsing",
"scope": "url",
"costCredits": 1,
"createdAt": "2026-05-08T10:00:00.000Z"
}
| Поле | Тип | Описание |
|---|---|---|
| id | string | ID задачи для опроса результата |
| status | string | Текущий статус задачи (parsing, done, error) |
| scope | string | Тип задачи — всегда url для этого эндпоинта |
| costCredits | number | Количество кредитов, списанных за задачу |
| createdAt | string | Временная метка создания задачи в формате ISO 8601 |
Задача обрабатывается асинхронно. Используйте id для опроса результата или укажите callbackUrl для получения вебхука по завершении парсинга.
Следующие шаги
- Получение результата — опрос результата по ID задачи
- Вебхук — получение результата через callback вместо опроса
- Тарифы — как рассчитываются кредиты для этого запроса