> ## 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는 무료이며 사용량에 포함되지 않습니다.