Gemini 답변의 출처마다 신뢰도가 붙어요

내 시장에서 Gemini 앱이 질문에 내놓는 답변을, 답변의 근거가 된 웹 출처와 출처별 신뢰도와 함께 받아요.

받는 결과

• text: Gemini 답변 전문입니다. 요청하면 markdown도 함께 받습니다.
• sources: Gemini가 답변의 근거로 삼은 웹 페이지를 URL, 제목과 함께 받습니다.
• 출처마다 붙는 confidence_level: Gemini가 그 출처를 답변과 얼마나 강하게 연결했는지 보여 줘, 인용에 가중치를 줄 수 있습니다.

동작 방식

태스크마다 지정한 국가에서 소비자용 Gemini 앱에 질문하고, 그 시장의 고객이 보는 답변을 돌려줍니다. Gemini는 스스로 아는 내용과 웹에서 찾은 내용을 함께 써서 답하고, 출처 목록은 답변을 뒷받침하는 페이지를 정확히 보여 줍니다.

ChatGPT, Perplexity에 보내는 질문을 Gemini에도 보내면 엔진마다 어떤 브랜드를 추천하고 어떤 페이지를 신뢰하는지 비교할 수 있습니다.

이렇게 활용하세요

• Gemini가 내 브랜드와 경쟁사를 어떻게 설명하는지 추적합니다.
• 신뢰도로 인용에 가중치를 줘서 내 카테고리에서 가장 영향력 있는 출처를 찾습니다.
• 하나의 질문 세트로 Gemini와 다른 엔진을 비교합니다.

요청 보내기

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": "GEMINI",
    "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",
      "include": { "markdown": true }
    }
  }'

요청 필드

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

true면 제목, 목록, 표, 링크를 살린 markdown을 함께 받습니다.

webhook.urlstring

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

idempotencyKeystring

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

응답

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

{
  "success": true,
  "task": {
    "id": "40b806b8-c057-4003-934e-98ab5fef2cef",
    "taskType": "GEMINI",
    "status": "COMPLETED",
    "createdAt": "2026-09-10T02:34:15.665Z"
  },
  "credits": { "creditsToCharge": 1, "creditsCharged": 1 },
  "response": {
    "markdown": "Here are 3 top wireless earbuds for commuting:\n\n* **[Bose QuietComfort Ultra Wireless Noise Cancelling Earbuds](…)**: The best choice for commuting, offering unmatched noise cancellation to block …\n…",
    "sources": [
      {
        "position": 3,
        "url": "https://google.com/search?q=EarFun+Air+Pro+4+Wireless+In-ear+headphones&…"
      },
      {
        "position": 5,
        "url": "https://google.com/search?q=Anker+Soundcore+Liberty+5+True+Wireless+Bluetooth+Earbuds&…"
      }
    ]
  }
}

task.statusstring

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

credits.creditsChargedinteger

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

response.textstring

답변 평문입니다.

response.markdownstring

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

response.sourcesarray

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

결과 받기

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

요금

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