> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# WebExtrator Aufgabenabfrage API

> WebExtrator Web Render & Extract API guide - Ace Data Cloud

`POST https://api.acedata.cloud/webextrator/tasks` (**kostenlos**)

Abfrage historischer `render` / `extract` Aufgaben (aufbewahrt für 7 Tage).

## Einzelabfrage

```json theme={null}
{
  "action": "retrieve",
  "id": "550e8400-e29b-41d4-a716-446655440000"
}
```

Oder über `trace_id`:

```json theme={null}
{
  "action": "retrieve",
  "trace_id": "550e8400-e29b-41d4-a716-446655440001"
}
```

Gibt ein einzelnes Aufgabenobjekt zurück (enthält Felder wie `request` / `response` / `started_at` / `finished_at`).

## Batch-Abfrage

```json theme={null}
{
  "action": "retrieve_batch",
  "ids": ["...", "..."],
  "limit": 12,
  "offset": 0
}
```

Oder mit `trace_ids`, oder ohne beide, um die eigene Aufgabenhistorie seitenweise abzurufen.

Rückgabe:

```json theme={null}
{
  "items": [ { /* task */ }, ... ],
  "count": 2
}
```

## Felddefinitionen

| Feld                                     | Beschreibung                                                           |
| ---------------------------------------- | ---------------------------------------------------------------------- |
| `id` / `task_id`                         | Eindeutige Aufgaben-ID                                                 |
| `trace_id`                               | Aufrufketten-ID (abgestimmt mit PlatformGateway / CLS)                 |
| `type`                                   | `render` oder `extract`                                                |
| `request`                                | Ursprünglicher Anfragekörper                                           |
| `response`                               | Rendering- / Extraktionsergebnis (entspricht `data` der sync response) |
| `started_at` / `finished_at` / `elapsed` | Zeitstempel und Dauer (Sekunden)                                       |

> Diese Schnittstelle ist kostenlos und wird nicht auf das Nutzungskontingent angerechnet.