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

# データエクスポート

> AgentToolsタスクのエクスポート状態を確認し、エクスポートメタデータを取得します。

<Info>
  クエリパラメータ、cURL例、レスポンススキーマはOpenAPI定義からAPIパネルに自動生成されます。
</Info>

タスクのエクスポート状態を確認し、エクスポートメタデータを取得します。

<Steps>
  <Step title="taskIdを指定する">
    `executeTask`または`searchTasks`で返された`taskId`を渡します。
  </Step>

  <Step title="エクスポートオプションを選ぶ">
    `exportFileType`の既定値は`JSON`です。`previewRows`の既定値は`5`です。
  </Step>

  <Step title="レスポンスのガイダンスに従う">
    `retryGuidance`と`suggestedNextCall`を使って、次に呼び出すタイミングを判断します。
  </Step>
</Steps>

```text theme={null}
searchTemplates -> executeTask -> exportData
searchTasks -> startOrStopTask -> exportData
```

<CardGroup cols={2}>
  <Card title="対応フォーマット" icon="file-code">
    `EXCEL`、`CSV`、`HTML`、`JSON`、`XML`に対応しています。
  </Card>

  <Card title="プレビュー行" icon="table">
    `previewRows`は`0`から`20`まで指定できます。
  </Card>
</CardGroup>

<Warning>
  クライアントが`exportFileUrl`を自動的にダウンロードしたり解析したりする前提にはしないでください。エクスポート成果物への参照として扱い、レスポンスのガイダンスに従ってください。
</Warning>

<AccordionGroup>
  <Accordion title="ステータス値">
    `collecting`: タスクがまだデータ収集中です。

    `exporting`: エクスポートを準備中です。

    `exported`: エクスポートメタデータを利用できます。

    `no_data`、`failed`、`invalid`: エクスポート成果物があるとは限りません。
  </Accordion>

  <Accordion title="exported時のレスポンス">
    `status`が`exported`の場合、`response.data`には`exportFileUrl`が含まれ、`sampleData`が含まれることがあります。
  </Accordion>

  <Accordion title="ページングフィールド">
    ページング可能なエクスポートメタデータがある場合、`page`、`pageSize`、`total`が返されます。
  </Accordion>
</AccordionGroup>