> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Асинхронные задачи
> Эндпоинты `jobs` ставят задачи скрейпинга в очередь и позволяют опрашивать статус и результаты — идеально для высокой нагрузки или медленных страниц.
## Начало работы
### Базовый URL
```
https://scrape.cleariflow.com/v1/jobs
```
## Создание задачи
Поставьте асинхронный скрейпинг в очередь с тем же payload `ScrapeRequest`, что использует синхронный эндпоинт.
### Пример запроса
```bash theme={"system"}
curl -X POST 'https://scrape.cleariflow.com/v1/jobs' \
-H 'Content-Type: application/json' \
-d '{
"request": {
"api_key": "YOUR_UNIQUE_API_KEY",
"url": "https://example.com"
},
"priority": 10
}'
```
Успешный запрос возвращает идентификатор задачи:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000"
}
```
### Параметры создания задачи
Объект `ScrapeRequest` с теми же полями, что и синхронный эндпоинт скрейпинга (`url`, `render`, `actions`, `cookies` и т. д.).
Приоритет задачи. Более высокие значения обрабатываются первыми. По умолчанию: 0.
## Получение статуса задачи
Опрашивайте задачу по ID, чтобы проверить статус и получить результаты после завершения.
### Базовый URL
```
https://scrape.cleariflow.com/v1/jobs/{job_id}
```
### Пример запроса
```bash theme={"system"}
curl 'https://scrape.cleariflow.com/v1/jobs/550e8400-e29b-41d4-a716-446655440000'
```
Во время выполнения задачи:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "running"
}
```
После успешного завершения:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "done",
"result": {
"ok": true,
"html": "...",
"meta": {
"elapsed_ms": 8123
}
}
}
```
### Значения статуса задачи
| Статус | Описание |
| --------- | ------------------------------------------------------ |
| `queued` | Задача ожидает в очереди. |
| `running` | Сессия браузера активна. |
| `done` | Скрейпинг завершён; `result` содержит результат. |
| `failed` | Скрейпинг не удался; `error` содержит описание ошибки. |
### Параметры ответа
Уникальный идентификатор асинхронной задачи.
Текущий статус задачи: `queued`, `running`, `done` или `failed`.
Объект результата скрейпинга (та же структура, что и ответ синхронного эндпоинта). Присутствует, когда `status` — `done`.
Сообщение об ошибке. Присутствует, когда `status` — `failed`.
Дополнительные метаданные о выполнении задачи.