> ## 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.
# Trabajos asíncronos
> Los endpoints `jobs` encolan tareas de scraping y permiten consultar el estado y los resultados — ideal para alto volumen o páginas lentas.
## Primeros pasos
### URL base
```
https://scrape.cleariflow.com/v1/jobs
```
## Crear un trabajo
Encole un trabajo de scraping asíncrono con la misma carga `ScrapeRequest` que usa el endpoint síncrono.
### Solicitud de ejemplo
```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
}'
```
Esta solicitud exitosa devuelve un identificador de trabajo:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000"
}
```
### Parámetros para crear un trabajo
Un objeto `ScrapeRequest` con los mismos campos que el endpoint de scraping síncrono (`url`, `render`, `actions`, `cookies`, etc.).
Prioridad del trabajo. Los valores más altos se procesan primero. Por defecto: 0.
## Obtener estado del trabajo
Consulte un trabajo por ID para verificar su estado y recuperar resultados al completarse.
### URL base
```
https://scrape.cleariflow.com/v1/jobs/{job_id}
```
### Solicitud de ejemplo
```bash theme={"system"}
curl 'https://scrape.cleariflow.com/v1/jobs/550e8400-e29b-41d4-a716-446655440000'
```
Mientras el trabajo está en ejecución:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "running"
}
```
Cuando el trabajo se completa con éxito:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "done",
"result": {
"ok": true,
"html": "...",
"meta": {
"elapsed_ms": 8123
}
}
}
```
### Valores de estado del trabajo
| Status | Description |
| --------- | --------------------------------------------------- |
| `queued` | El trabajo está en cola de espera. |
| `running` | La sesión del navegador está activa. |
| `done` | Scraping completado; `result` contiene la salida. |
| `failed` | Scraping fallido; `error` contiene una descripción. |
### Parámetros de respuesta
Identificador único del trabajo asíncrono.
Estado actual del trabajo: `queued`, `running`, `done` o `failed`.
El objeto de resultado del scraping (misma estructura que la respuesta del endpoint síncrono). Presente cuando `status` es `done`.
Mensaje de error. Presente cuando `status` es `failed`.
Metadatos adicionales sobre la ejecución del trabajo.