> ## 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.
# Tarefas assíncronas
> Os endpoints `jobs` colocam tarefas de scraping em fila e permitem consultar o estado e os resultados — ideal para alto volume ou páginas lentas.
## Primeiros passos
### URL base
```
https://scrape.cleariflow.com/v1/jobs
```
## Criar uma tarefa
Enfileire um scrape assíncrono com a mesma carga `ScrapeRequest` usada pelo endpoint síncrono.
### Pedido de exemplo
```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
}'
```
Este pedido bem-sucedido devolve um identificador de tarefa:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000"
}
```
### Parâmetros para criar uma tarefa
Um objeto `ScrapeRequest` com os mesmos campos do endpoint de scraping síncrono (`url`, `render`, `actions`, `cookies`, etc.).
Prioridade da tarefa. Valores mais altos são processados primeiro. Predefinição: 0.
## Obter estado da tarefa
Consulte uma tarefa por ID para verificar o estado e recuperar resultados após conclusão.
### URL base
```
https://scrape.cleariflow.com/v1/jobs/{job_id}
```
### Pedido de exemplo
```bash theme={"system"}
curl 'https://scrape.cleariflow.com/v1/jobs/550e8400-e29b-41d4-a716-446655440000'
```
Enquanto a tarefa está em execução:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "running"
}
```
Quando a tarefa conclui com sucesso:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "done",
"result": {
"ok": true,
"html": "...",
"meta": {
"elapsed_ms": 8123
}
}
}
```
### Valores de estado da tarefa
| Estado | Descrição |
| --------- | ---------------------------------------------- |
| `queued` | A tarefa aguarda na fila. |
| `running` | A sessão do navegador está ativa. |
| `done` | Scraping concluído; `result` contém a saída. |
| `failed` | Scraping falhou; `error` contém uma descrição. |
### Parâmetros da resposta
Identificador único da tarefa assíncrona.
Estado atual da tarefa: `queued`, `running`, `done` ou `failed`.
O objeto de resultado do scraping (mesma estrutura da resposta do endpoint síncrono). Presente quando `status` é `done`.
Mensagem de erro. Presente quando `status` é `failed`.
Metadados adicionais sobre a execução da tarefa.