HTML 페이지: 답변마다 엔진이 보여 준 화면

include.html을 true로 설정하면 태스크는 엔진이 답변에 보여 준 화면으로 가는 링크를 반환합니다. 화면은 보고서에 넣을 수 있는 독립 HTML 페이지로 저장됩니다.

요청

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 객체가 더해집니다. 예:

{
  "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`을 쓰세요.

시작하기

핵심 개념

답변 엔진

검색과 웹 데이터

요청 옵션

리서치

GEO 모니터링

계정과 데이터

HTML 페이지: 답변마다 엔진이 보여 준 화면

요청

지원 엔진

응답

접근과 보관

크레딧

페이지를 받지 못한 경우

오류

관련 문서

​요청

​지원 엔진

​응답

​접근과 보관

​크레딧

​페이지를 받지 못한 경우

​오류

​관련 문서

요청

지원 엔진

응답

접근과 보관

크레딧

페이지를 받지 못한 경우

오류

관련 문서