> ## 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.
# Async jobs
> The `jobs` endpoints enqueue scrape tasks for background processing and let you poll for status and results — ideal for high-volume or long-running scrapes.
## Getting started
### Base URL
```
https://scrape.cleariflow.com/v1/jobs
```
## Create a job
Enqueue an async scrape job with the same `ScrapeRequest` payload used by the synchronous endpoint.
### Example request
```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
}'
```
This successful request returns a job identifier:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000"
}
```
### Create job parameters
A `ScrapeRequest` object with the same fields as the synchronous scrape endpoint (`url`, `render`, `actions`, `cookies`, etc.).
Job priority. Higher values are processed first. Defaults to 0.
## Get job status
Poll a job by ID to check its status and retrieve results when complete.
### Base URL
```
https://scrape.cleariflow.com/v1/jobs/{job_id}
```
### Example request
```bash theme={"system"}
curl 'https://scrape.cleariflow.com/v1/jobs/550e8400-e29b-41d4-a716-446655440000'
```
While the job is running:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "running"
}
```
When the job completes successfully:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "done",
"result": {
"ok": true,
"html": "...",
"meta": {
"elapsed_ms": 8123
}
}
}
```
### Job status values
| Status | Description |
| --------- | ----------------------------------------------- |
| `queued` | Job is waiting in the queue. |
| `running` | Browser session is active. |
| `done` | Scrape completed; `result` contains the output. |
| `failed` | Scrape failed; `error` contains a description. |
### Response parameters
Unique identifier for the async job.
Current job status: `queued`, `running`, `done`, or `failed`.
The scrape result object (same shape as the synchronous endpoint response). Present when `status` is `done`.
Error message. Present when `status` is `failed`.
Additional metadata about the job execution.