> ## 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.
# Job asincroni
> Gli endpoint `jobs` accodano attività di scraping e consentono di verificare stato e risultati — ideale per alto volume o pagine lente.
## Per iniziare
### URL base
```
https://scrape.cleariflow.com/v1/jobs
```
## Creare un job
Accoda uno scrape asincrono con lo stesso payload `ScrapeRequest` usato dall'endpoint sincrono.
### Esempio di richiesta
```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
}'
```
Questa richiesta riuscita restituisce un identificatore del job:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000"
}
```
### Parametri per creare un job
Un oggetto `ScrapeRequest` con gli stessi campi dell'endpoint di scraping sincrono (`url`, `render`, `actions`, `cookies`, ecc.).
Priorità del job. I valori più alti vengono elaborati per primi. Predefinito: 0.
## Ottenere lo stato del job
Interroga un job per ID per verificarne lo stato e recuperare i risultati al completamento.
### URL base
```
https://scrape.cleariflow.com/v1/jobs/{job_id}
```
### Esempio di richiesta
```bash theme={"system"}
curl 'https://scrape.cleariflow.com/v1/jobs/550e8400-e29b-41d4-a716-446655440000'
```
Mentre il job è in esecuzione:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "running"
}
```
Al completamento con successo:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "done",
"result": {
"ok": true,
"html": "...",
"meta": {
"elapsed_ms": 8123
}
}
}
```
### Valori di stato del job
| Stato | Descrizione |
| --------- | --------------------------------------------------- |
| `queued` | Il job è in attesa in coda. |
| `running` | La sessione del browser è attiva. |
| `done` | Scraping completato; `result` contiene l'output. |
| `failed` | Scraping fallito; `error` contiene una descrizione. |
### Parametri della risposta
Identificatore univoco del job asincrono.
Stato attuale del job: `queued`, `running`, `done` o `failed`.
L'oggetto risultato dello scraping (stessa struttura della risposta dell'endpoint sincrono). Presente quando `status` è `done`.
Messaggio di errore. Presente quando `status` è `failed`.
Metadati aggiuntivi sull'esecuzione del job.