> ## 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.
# Asynchrone Jobs
> Die `jobs`-Endpunkte stellen Scraping-Aufgaben in die Warteschlange und ermöglichen das Abfragen von Status und Ergebnissen — ideal für hohes Volumen oder langsame Seiten.
## Erste Schritte
### Basis-URL
```
https://scrape.cleariflow.com/v1/jobs
```
## Job erstellen
Stellen Sie einen asynchronen Scraping-Job in die Warteschlange mit derselben `ScrapeRequest`-Nutzlast wie beim synchronen Endpunkt.
### Beispielanfrage
```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
}'
```
Diese erfolgreiche Anfrage liefert eine Job-ID:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000"
}
```
### Parameter zum Erstellen eines Jobs
Ein `ScrapeRequest`-Objekt mit denselben Feldern wie beim synchronen Scraping-Endpunkt (`url`, `render`, `actions`, `cookies` usw.).
Job-Priorität. Höhere Werte werden zuerst verarbeitet. Standard: 0.
## Job-Status abfragen
Fragen Sie einen Job anhand seiner ID ab, um den Status zu prüfen und Ergebnisse nach Abschluss abzurufen.
### Basis-URL
```
https://scrape.cleariflow.com/v1/jobs/{job_id}
```
### Beispielanfrage
```bash theme={"system"}
curl 'https://scrape.cleariflow.com/v1/jobs/550e8400-e29b-41d4-a716-446655440000'
```
Während der Job läuft:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "running"
}
```
Bei erfolgreichem Abschluss:
```json theme={"system"}
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "done",
"result": {
"ok": true,
"html": "...",
"meta": {
"elapsed_ms": 8123
}
}
}
```
### Job-Statuswerte
| Status | Beschreibung |
| --------- | ----------------------------------------------------------- |
| `queued` | Job wartet in der Warteschlange. |
| `running` | Browser-Sitzung ist aktiv. |
| `done` | Scraping abgeschlossen; `result` enthält die Ausgabe. |
| `failed` | Scraping fehlgeschlagen; `error` enthält eine Beschreibung. |
### Antwortparameter
Eindeutige Kennung des asynchronen Jobs.
Aktueller Job-Status: `queued`, `running`, `done` oder `failed`.
Das Scraping-Ergebnis (gleiche Struktur wie die synchrone Endpunkt-Antwort). Vorhanden, wenn `status` `done` ist.
Fehlermeldung. Vorhanden, wenn `status` `failed` ist.
Zusätzliche Metadaten zur Job-Ausführung.