AI 엔진이 답변과 함께 보여 준 화면을 받아요

ChatGPT, Gemini, Perplexity, Meta AI, Google AI 개요, AI 모드 태스크에 include.html을 켜면, 엔진이 실제로 보여 준 답변 화면을 API 키 없이 열리는 페이지 링크로 받아요.

받는 결과

• CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE, AIMODE에서 payload.include.html: true를 씁니다.
• 응답의 html: status(ok 또는 failed), url, expiresAt. 링크는 태스크가 끝나고 30일 동안 열립니다.
• 페이지는 API 키 없이 열리고 밖에서 아무것도 불러오지 않으므로, 링크로 보내거나 보고서에 넣을 수 있습니다.
• 답변 필드(text, sources 등)는 그대로 옵니다. 화면 저장에 실패해도 태스크는 실패하지 않습니다.

동작 방식

ChatGPT, Gemini, Perplexity, Meta AI는 실제 브라우저로 엔진 사이트에 질문하고, 답변이 끝났을 때의 화면(사이드바, 질문, 출처 칩이 달린 답변, 입력창)을 저장합니다. 답변 필드도 같은 질문에서 나오며, 답변과 맞지 않는 화면은 저장하지 않습니다.

저장하기 전에 스크립트를 빼고 이미지, 스타일, 글꼴을 파일 안에 넣습니다. 그래서 어느 브라우저에서나 엔진에서 아무것도 불러오지 않고 같은 화면으로 열립니다.

Google AI 개요와 AI 모드는 그 태스크에서 Google이 돌려준 결과 페이지를 스크립트만 빼고 저장합니다. AI 개요 본문과 출처 목록은 더보기와 모두 보기를 누른 상태로 저장해, 스크립트 없이도 답변 전체가 보입니다.

화면을 받지 못하거나 저장하지 못하면 html은 { "status": "failed", "error": "EVIDENCE_FAILED" }이고, 태스크는 답변과 함께 완료됩니다. location, CN, HK, continueFrom을 쓴 ChatGPT 태스크와 location, CN, DE, GB, IR을 쓴 Gemini 태스크는 늘 화면 없이 돌아옵니다.

이렇게 활용하세요

• 고객 보고서의 숫자 옆에 엔진 화면을 붙여, 사용자가 본 그대로의 답변을 보여 줍니다.
• 파싱한 결과가 이상해 보이면 페이지를 열어 브랜드나 출처가 화면 어디에 있었는지 확인합니다.
• 엔진마다 그날 어떻게 답했는지 날짜별 기록으로 남깁니다. 페이지는 30일 동안 남으니 더 오래 둘 것은 내려받아 두세요.

요청 보내기

API 키를 Authorization 헤더에 넣어 요청을 보냅니다.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "PERPLEXITY",
    "payload": {
      "prompt": "What are the best CRM tools for a 10-person startup?",
      "country": "US",
      "include": { "html": true }
    }
  }'

요청 필드

taskTypestring필수

실행할 엔진입니다. CHATGPT, GOOGLE 같은 값을 넣습니다.

payload.promptstring필수

사용자가 채팅에 입력하듯 쓴 질문입니다. 최대 100,000자.

payload.countrystring

질문할 시장의 두 글자 국가 코드입니다. US, KR, JP 등. 기본값 US.

payload.include.htmlboolean

true면 엔진이 답변과 함께 보여 준 화면의 링크인 html을 받습니다. CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE, AIMODE에서 씁니다. 기본으로 꺼져 있습니다.

webhook.urlstring

서버의 HTTPS 주소입니다. 태스크가 끝나는 즉시 결과를 이 주소로 보냅니다.

응답

완료된 태스크는 이런 형태입니다. 길이를 줄여 보여 드립니다.

{
  "success": true,
  "task": {
    "id": "7be8662e-5f62-48bf-a54a-7b58a2701b7c",
    "taskType": "PERPLEXITY",
    "status": "COMPLETED",
    "createdAt": "2026-10-21T01:20:07.445Z"
  },
  "credits": { "creditsToCharge": 1.25, "creditsCharged": 1.25 },
  "response": {
    "text": "For a 10-person startup, the strongest shortlist is **HubSpot** for a free, easy starting point; **Pipedrive** for a straightforward sales pipeline; **Zoho CRM** for budget-friendly customization; and **Attio** for a flexible, data-driven CRM.[1][2][3]\n\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://slack.com/blog/crm/best-crms-for-startups",
        "label": "Best CRMs for Startups: Tools, Benefits, and Tips"
      },
      {
        "position": 2,
        "url": "https://attio.com/f/best-crm-for-startups",
        "label": "Best CRMs for startups in 2026"
      }
    ],
    "html": {
      "status": "ok",
      "url": "https://api.querying.ai/v1/evidence/1792545851-e8cc8a32dd7f456eb807a0e09e9bc0fa.html",
      "expiresAt": "2026-11-20T01:24:11.000Z"
    }
  }
}

task.statusstring

QUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.

credits.creditsChargedinteger

끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.

response.textstring

답변 평문입니다.

response.sourcesarray

답변이 인용한 페이지입니다. 엔진이 보여 준 순서대로 position, url, label이 담깁니다.

response.htmlobject

엔진의 화면입니다. status(ok 또는 failed), API 키 없이 열리는 url, 태스크가 끝나고 30일 뒤인 expiresAt이 담깁니다. 화면을 저장하지 못하면 error가 EVIDENCE_FAILED이고, 태스크는 답변과 함께 완료됩니다.

결과 받기

요청하면 status가 QUEUED인 태스크가 바로 돌아옵니다. status가 COMPLETED나 FAILED가 될 때까지 GET /v1/async/task/{id}로 조회하거나, webhook.url을 넣어 같은 task, credits, response를 서버로 받으세요. 결과는 태스크가 끝난 뒤 24시간 동안 조회됩니다.

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

오류

EVIDENCE_UNSUPPORTEDHTTP 422

화면을 줄 수 없는 엔진에 include.html을 켰습니다. CHATGPT, GEMINI, PERPLEXITY, META_AI, GOOGLE, AIMODE만 화면을 돌려줍니다.

VALIDATION_ERRORHTTP 400

필드가 빠졌거나 허용 범위를 벗어났습니다. details에 해당 필드가 나옵니다.

MISSING_API_KEYHTTP 401

Authorization 헤더가 빠졌거나, 키가 잘못됐거나 만료 또는 폐기됐습니다.

INSUFFICIENT_CREDITSHTTP 402

잔액이 태스크 가격보다 적습니다. 크레딧을 충전하거나 플랜을 올린 뒤 다시 보내세요.

요금

ChatGPT, Perplexity, Meta AI는 엔진 가격에 0.25크레딧이 더해집니다. 이 0.25크레딧은 제출할 때 잡아 두고 html.status가 ok일 때만 차감합니다. Gemini, Google AI 개요, AI 모드는 화면이 무료입니다. 화면을 켜면 여섯 엔진 모두 태스크 하나에 1.25크레딧이며, 예시의 Perplexity 태스크도 1.25크레딧이 차감됐습니다.