> ## Documentation Index
> Fetch the complete documentation index at: https://germeytechnology-docs-remove-4o-image-nav.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# WebExtrator Uppgiftsfråge-API

> WebExtrator Web Render & Extract 集成指南 - Ace Data Cloud

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

Fråga historiska `render` / `extract` uppgifter (sparas i 7 dagar).

## Enstaka förfrågan

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

Eller via `trace_id`:

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

Returnerar ett enskilt uppgiftsobjekt (inklusive fält som `request` / `response` / `started_at` / `finished_at`).

## Batchförfrågan

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

Eller med `trace_ids`, eller utan båda för att hämta din egen uppgiftshistorik med paginering.

Returnerar:

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

## Fältdefinitioner

| Fält                                     | Beskrivning                                                          |
| ---------------------------------------- | -------------------------------------------------------------------- |
| `id` / `task_id`                         | Unikt ID för uppgiften                                               |
| `trace_id`                               | Spårnings-ID (i linje med PlatformGateway / CLS)                     |
| `type`                                   | `render` eller `extract`                                             |
| `request`                                | Ursprunglig förfrågningskropp                                        |
| `response`                               | Renderings- / extraktionsresultat (samma som `data` i sync response) |
| `started_at` / `finished_at` / `elapsed` | Tidsstämplar och förfluten tid (sekunder)                            |

> Detta API är gratis och räknas inte mot användningskvoten.