ChatGPT를 지원해요

원하는 시장에서 ChatGPT에 질문하고, 그 시장의 실제 방문자가 보는 답변을 모든 인용 출처와 함께 JSON으로 받아요.

받는 결과

• text, markdown: 답변 전문을 일반 텍스트와 서식이 살아 있는 형태로 받습니다.
• sources: 답변이 인용한 모든 페이지를 순서대로 URL, 제목과 함께 받습니다.
• searchQueries: ChatGPT가 답하면서 실행한 웹 검색어입니다. 질문을 어떻게 조사했는지 보여 줍니다.
• model: 해당 세션에서 답한 모델입니다.

동작 방식

태스크마다 지정한 국가에서 새 ChatGPT 세션을 열고 질문을 쓴 그대로 묻습니다. 그 시장에 처음 방문한 사용자가 받는 답변을 받으므로, 추천 브랜드와 인용 페이지가 실제 고객이 읽는 내용과 같습니다.

실행할 때마다 새로운 관측입니다. 같은 질문을 일정에 따라 반복하고 실행 결과를 비교하면 답변, 추천 브랜드, 인용 페이지가 시간에 따라 어떻게 바뀌는지 볼 수 있습니다.

이렇게 활용하세요

• 구매자가 묻는 질문에 ChatGPT가 내 브랜드를 추천하는지 확인합니다.
• 내 카테고리에서 ChatGPT가 인용하는 페이지를 찾아 콘텐츠 계획에 반영합니다.
• 같은 질문에 대한 답변을 국가별로 비교합니다.

요청 보내기

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": "CHATGPT",
    "payload": {
      "prompt": "Search the web and recommend 3 wireless earbuds for commuting. Compare noise cancellation and battery life in a short table, with source links. Keep the answer under 180 words.",
      "country": "US"
    }
  }'

요청 필드

taskTypestring필수

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

payload.promptstring필수

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

payload.countrystring

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

payload.locationstring

country 안의 장소입니다. 역, 구, 도로명주소 등 최대 200자. 엔진이 그 자리에 있는 사용자에게 답하듯 답합니다. CHATGPT, GEMINI, GOOGLE, AIMODE, GOOGLE_SERP에서 씁니다.

payload.include.markdownboolean

제목, 목록, 표, 링크를 살린 markdown을 돌려줍니다. 기본으로 켜져 있습니다.

payload.include.searchQueriesboolean

ChatGPT가 답을 위해 실행한 웹 검색어 searchQueries를 돌려줍니다. 기본으로 켜져 있습니다.

payload.include.shoppingboolean

ChatGPT가 보여 주는 상품 카드를 shoppingCards로 돌려줍니다. 기본으로 켜져 있습니다.

payload.include.rawResponseboolean

true면 구조화된 결과 옆에 엔진 원본 출력을 함께 받아 직접 파싱할 수 있습니다. 기본값은 꺼짐.

webhook.urlstring

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

idempotencyKeystring

요청에 붙이는 고유 ID입니다. 키 하나는 계정에서 태스크 하나를 만들므로, 다시 보내도 태스크는 하나로 유지됩니다.

응답

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

{
  "success": true,
  "task": {
    "id": "8bafb0ff-3cc7-4bc4-99bf-32dbacaf7736",
    "taskType": "CHATGPT",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:15.604Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "text": "For commuting, I’d prioritize strong ANC (trains, buses, traffic) and 6+ hours of playback. These three are top picks:",
    "markdown": "| Earbuds | Noise cancellation | Battery life (ANC on) |\n|---|---|---|\n| Bose QuietComfort Ultra Earbuds (2nd Gen) | Excellent — among the strongest ANC available | ~6 hrs (24 hrs with case) … |\n…",
    "sources": [
      {
        "position": 1,
        "url": "https://www.wired.com/gallery/best-noise-canceling-earbuds/",
        "label": "Best Noise-Canceling Earbuds: Bose, Sony, Apple, and More | WIRED",
        "attribution": "WIRED",
        "datePublished": "March 29, 2026"
      },
      {
        "position": 2,
        "url": "https://www.tomsguide.com/audio/earbuds/best-noise-canceling-earbuds",
        "label": "Best noise-canceling earbuds in 2026: Tested and reviewed | Tom's Guide",
        "attribution": "Tom's Guide",
        "datePublished": "July 24, 2026"
      }
    ],
    "searchQueries": [
      "best wireless earbuds commuting noise cancellation battery life Sony Bose Apple"
    ]
  }
}

task.statusstring

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

credits.creditsChargedinteger

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

response.textstring

답변 평문입니다.

response.markdownstring

서식을 살린 답변입니다. 제목, 목록, 표, 링크가 그대로 담깁니다.

response.sourcesarray

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

response.searchQueriesarray

엔진이 답을 쓰려고 실행한 웹 검색어입니다.

response.shoppingCardsarray

답변과 함께 나온 상품 카드입니다. 상품명, 가격, 판매처, 평점, 상품 링크가 담깁니다.

결과 받기

요청하면 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"

요금

완료된 ChatGPT 태스크마다 2크레딧이 차감됩니다.