> ## 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`를 돌려주고 페이지는 삭제됩니다. 보관할 페이지는 내려받아 두세요.
* 한 IP 주소에서 분당 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`이 boolean이 아니거나, 요청에 `include.screenshot: true`가 있습니다. 스크린샷은 더 이상 제공하지 않으므로 `include.html`을 쓰세요. |

## 관련 문서

* [Markdown과 원본 응답](/ko/engines/response-options.md)
* [ChatGPT](/ko/engines/chatgpt.md) · [Gemini](/ko/engines/gemini.md) · [Perplexity](/ko/engines/perplexity.md) · [Meta AI](/ko/engines/meta-ai.md) · [Google AI 개요](/ko/engines/google-ai-overviews.md) · [Google AI 모드](/ko/engines/google-ai-mode.md)


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