Google AI Mode 답변 수집 API

응답 구조

대화형 답변의 text·markdown과 인용 출처를 받습니다. AI Mode는 일반 검색 결과의 AI 오버뷰 박스와 별개이며, 독립된 taskType과 응답을 사용합니다.

text, markdown: 구글 AI 모드의 대화형 답변 본문입니다.
sources: 답변과 함께 반환된 인용 페이지입니다. 전체 응답과 함께 보관하세요.
taskType: AIMODE와 payload.query로 AI 모드를 선택합니다. AI 개요는 별도 GOOGLE 요청으로 측정하세요.

{
  "task": {
    "taskType": "AIMODE"
  },
  "response": {
    "sources": [
      {
        "url": "https://www.rtings.com/headphones/reviews/best/wireless-earbuds",
        "label": "RTINGS.com (+1) - Related results",
        "position": 1
      },
      {
        "url": "https://www.bestbuy.com/product/bose-quietcomfort-ultra-earbuds-2nd-gen-true-wireless-noise-cancelling-in-ear-earbuds-with-immersive-audio-black/J7C5V6WCKZ/sku/6628900",
        "label": "Best Buysn._setImageSrc('img-VBeiarKEOqOrmLQPgbPn4A8_8','data:image\\/jpeg;base64,\\/9j\\/4AAQSkZJRgABAQAAAQABAAD\\/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys\\/RD84QzQ",
        "position": 2
      },
      {
        "url": "https://bose.com/p/in-ear/bose-quietcomfort-headphones/QCEARB24-HEADPHONEIN-DDPMNT-WW.html?srsltid=AfmBOopSWVnMoZsTe-s7lRVx33x-GwqE6r0mDIQhAG9H7WkHN_AtM9MX_f4",
        "label": "Bose Store",
        "position": 3
      },
      {
        "url": "https://www.target.com/p/beats-solo-buds-true-wireless-bluetooth-earbuds-transparent-red/-/A-92146819",
        "label": "Target",
        "position": 4
      }
    ],
    "text": "The Bose QuietComfort Ultra Earbuds (2nd Gen)\nGo to product viewer dialog for this item. and the budget-friendly Anker Soundcore Space A40\nGo to product viewer dialog for this item. are the best wireless earbuds for commuting, offering top-tier active noise cancellation (ANC) to block out subway rumbles and bus engine noise.\nTop Wireless Earbuds for Commuting\nPrice: ~$249 – $299\nBest For: Absolute silence and supreme comfort.\nKey Features: World-class adjustable ANC, CustomTune technology that calibrates sound to your ear shape, and Bose Immersive Audio spatial sound. Offers up to 6 hours of battery life (4 hours with immersive mode) plus an IPX4 water-resistance rating. You can check availability at local retailers via Best Buy.\nPrice: Under $100\nBest For: Value and price-to-performance ratio.\nKey Features: Adaptive ANC that automatically scales to transit noise, multipoint Bluetooth pairing, and an impressive 8 hours of continuous battery life with ANC on (plus 4 extra charges in the case).\nPrice: ~$149\nBest For: Heavy-duty noise isolation on a moderate budget.\nKey Features: Features 11 levels of adjustable noise cancellation, secure stability bands for crowded trains, and up to 8.5 hours of battery life. Available directly from the Bose Store.\nPrice: ~$70\nBest For: Ultra-portable pocket minimalist design.\nKey Features: Tiny form-factor case, robust Apple/Android one-touch pairing, and up to 18 hours of combined power. Note that they rely on passive noise isolation rather than active noise cancellation. Check stock locally through Target.\nIf you want to narrow down your choice, tell me:\nWhat is your maximum budget?\nDo you prefer a stem design (like AirPods) or a bud design?\nWhat phone do you use (iPhone or Android)?"
  }
}

Google AI Mode 브랜드 언급·인용을 분석하는 방법

긴 AI 답변을 유도하는 추천·비교 질문을 추적합니다. 일반 AI 오버뷰와 인용 근거를 비교하되 응답 스키마와 답변 생성률을 같은 지표로 섞지 마세요.

API로 답변을 수집하는 순서

대시보드에서 발급한 키를 서버 환경 변수 QUERYING_API_KEY에 저장한 뒤 아래 명령을 실행하세요. 국가 코드는 수집 국가를 설정하며, 질문을 번역하지 않습니다.

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "taskType": "AIMODE",
  "payload": {
    "query": "출퇴근용 무선 이어폰 추천",
    "country": "KR"
  }
}'

접수 ID로 완료 결과 읽기

TASK_ID를 접수 응답의 task.id로 바꿉니다. QUEUED·RUNNING이면 간격을 두고 다시 확인하고, COMPLETED이면 response 안의 엔진별 필드를 읽으세요. FAILED는 오류로 처리합니다. 완료 후 24시간 안에 결과를 가져와 저장하거나 웹훅으로 받으세요.

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

비용과 이용 범위

플랜별 요청 비용
플랜	1회	1,000회
Basic	약 5.6원	약 5,600원
Max	약 2.7원	약 2,667원

월 포함 크레딧을 모두 사용했을 때의 환산 단가입니다. 원화는 $1 ≈ 1,400원 기준입니다.

완료된 요청당 2크레딧이며 실패한 요청은 과금하지 않습니다. 지원 지역과 동시 요청 한도를 확인하세요.

결과를 해석할 때의 제약

지원 지역과 답변 제공 여부는 바뀔 수 있습니다. 출처는 Google이 반환한 내용에 따라 달라집니다. 수집 오류와 인용 누락을 구분하고, 누락 원인을 조사할 때 서비스 상태를 확인하세요.

상세 API 문서 (영문) ↗