> ## 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 タスク照会 API

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

`POST https://api.acedata.cloud/webextrator/tasks` （**無料**）

過去の `render` / `extract` タスクを照会（7日間保存）。

## 単一照会

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

または `trace_id` で：

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

単一のタスクオブジェクトを返します（`request` / `response` / `started_at` / `finished_at` などのフィールドを含む）。

## 複数照会

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

または `trace_ids` を使うか、両方を渡さずに自分のタスク履歴をページングで取得。

返却：

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

## フィールド定義

| フィールド                                    | 説明                                        |
| ---------------------------------------- | ----------------------------------------- |
| `id` / `task_id`                         | タスクの一意ID                                  |
| `trace_id`                               | 呼び出しチェーンID（PlatformGateway / CLS と整合）     |
| `type`                                   | `render` または `extract`                    |
| `request`                                | 元のリクエストボディ                                |
| `response`                               | レンダリング / 抽出結果（sync response の `data` と同じ） |
| `started_at` / `finished_at` / `elapsed` | タイムスタンプと経過時間（秒）                           |

> 本APIは無料で、使用量にカウントされません。