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

# HTMLページ: すべての回答についてエンジン自身の画面を保存

> ChatGPT、Gemini、Perplexity、Meta AI、Google AIによる概要、Google AIモードのタスクに include.html を追加し、エンジンが表示した画面を共有できるページとして受け取ります。

`include.html` を `true` にすると、タスクはエンジンが回答時に表示した画面へのリンクを返します。画面は単体で開けるHTMLページとして保存され、レポートに貼れます。

## リクエスト

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE", "payload": { "query": "best CRM for a small team", "country": "US", "include": { "html": true } } }'
```

## 対応エンジン

| taskType | ページ |
| - | - |
| `CHATGPT` | 回答が終わった時点で ChatGPT が表示していた画面全体(サイドバー、質問、回答、入力欄)。スクリプトを取り除き画像を含めているため、何も読み込まずに開けます。 |
| `GEMINI` | 回答が終わった時点で Gemini が表示していた画面。スクリプトを取り除き、スタイル、フォント、画像を含めているため、何も読み込まずに開けます。 |
| `PERPLEXITY` | 回答が終わった時点で Perplexity が表示していた画面。`GEMINI` と同じ方法で準備します。 |
| `META_AI` | 回答が終わった時点で Meta AI が表示していた画面。`PERPLEXITY` と同じ方法で準備します。 |
| `GOOGLE` | Google が返した結果ページ。安全に開けるようスクリプトを取り除いています。Google のスタイルと埋め込みサムネイルは残り、リンクは Google で開きます。 |
| `AIMODE` | Google が返したAIモードのページ。`GOOGLE` と同じ方法で準備します。 |

それ以外のエンジンはこのフラグを `422 EVIDENCE_UNSUPPORTED` で拒否します。`GET /v1/capabilities` は対応エンジンを `evidence: true` で示します。`CHATGPT` も、タスクに `location` がある、`CN` または `HK` を指定している、または `continueFrom` で会話を続けている場合は同じエラーで拒否します。ChatGPT はデバイス位置なしで答えた新しい会話にだけ画面を描きます。

## レスポンス

タスクの `response` に `html` オブジェクトが加わります。例:

```json theme={"theme":"css-variables"}
{
  "html": {
    "status": "ok",
    "url": "https://api.querying.ai/v1/evidence/1791551389-5cf17d26396946be8d68bf514e1dca18.html",
    "expiresAt": "2026-11-08T13:09:49.000Z"
  }
}
```

| フィールド | 説明 |
| - | - |
| `status` | `ok`。ページを保存できなかった場合は `failed`。 |
| `url` | ページ。APIキーは不要です。 |
| `expiresAt` | URLが使えなくなる時刻。タスク完了から30日後です。 |
| `error` | `status` が `failed` のときは `EVIDENCE_FAILED`。 |

## アクセスと保存期間

* URLはAPIキーなしで開けるため、リンクやレポートでそのまま使えます。URLを知っていれば誰でも `expiresAt` まで開けます。
* `expiresAt` を過ぎるとURLは `404` を返し、ページは削除されます。残す必要があるものはダウンロードしてください。
* 1つのIPアドレスから1分あたり600ページまでダウンロードでき、それを超えると `429` を受け取ります。

## クレジット

`CHATGPT`、`PERPLEXITY`、`META_AI` では、HTMLページはエンジンの料金に加えて0.25クレジットかかります。送信時に確保され、`html.status` が `ok` の場合にのみ請求されます。`GEMINI`、`GOOGLE`、`AIMODE` では追加の費用はかかりません。

## ページが失敗するとき

次の場合、タスクは回答とともに完了し、`html` は `{ "status": "failed", "error": "EVIDENCE_FAILED" }` で返ります。

* エンジンの画面を取得できなかった、または画面が回答と一致しなかった。
* ページを保存できなかった。
* `GEMINI` で、タスクに `location` がある、または `CN`、`DE`、`GB`、`IR` を指定している。これらは常に失敗します。

やり直すにはタスクを再送信してください。

## エラー

| ステータス | コード | 条件 |
| - | - | - |
| `422` | `EVIDENCE_UNSUPPORTED` | エンジンがHTMLページを返せない、または `CHATGPT` タスクに `location`、`CN`、`HK`、`continueFrom` があります。 |
| `400` | `VALIDATION_ERROR` | `include.html` がブール値でない、またはリクエストが `include.screenshot: true` を設定しています。スクリーンショットは提供を終了しています。`include.html` を使ってください。 |

## 関連

* [Markdownと生レスポンス](/ja/engines/response-options.md)
* [ChatGPT](/ja/engines/chatgpt.md) · [Gemini](/ja/engines/gemini.md) · [Perplexity](/ja/engines/perplexity.md) · [Meta AI](/ja/engines/meta-ai.md) · [Google AI による概要](/ja/engines/google-ai-overviews.md) · [Google AI モード](/ja/engines/google-ai-mode.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.