Google AI Overview 수집 API

응답 구조

검색 결과 봉투 안의 aioverview에 AI 답변이 들어갑니다. organicResults와 peopleAlsoAsk로 함께 수집된 검색 결과를 확인합니다. 일반 답변 엔진처럼 최상위 text만 읽지 말고 중첩 구조를 확인하세요.

aioverview.text, aioverview.sources: AI 개요 본문과 인용 페이지입니다. 먼저 aioverview가 null인지 확인하세요.
organicResults: 제공된 일반 검색 결과이며 AI 개요의 인용 출처와는 별개입니다.
peopleAlsoAsk: 제공되는 관련 질문입니다. 검색 패널은 선택 항목이므로 필드 누락을 검색 순위 0으로 처리하지 마세요.

{
  "task": {
    "taskType": "GOOGLE"
  },
  "response": {
    "sources": [
      {
        "url": "https://www.techgearlab.com/topics/audio/best-wireless-earbuds",
        "label": "TechGearLab (+1) - Related results",
        "position": 1
      },
      {
        "url": "https://www.rtings.com/headphones/reviews/best/wireless-earbuds",
        "label": "RTINGS.com (+1) - Related results",
        "position": 2
      },
      {
        "url": "https://www.forbes.com/sites/forbes-personal-shopper/article/the-best-wireless-earbuds/",
        "label": "Forbes (+1) - Related results",
        "position": 3
      },
      {
        "url": "https://www.cnet.com/tech/mobile/best-wireless-earbuds/",
        "label": "CNET - Related results",
        "position": 4
      },
      {
        "url": "https://www.youtube.com/watch?v=23My2YGjKzE",
        "label": "1:40",
        "position": 5
      },
      {
        "url": "https://www.youtube.com/watch?v=JLGn9NLfE6g&t=496",
        "label": "Best Running Earbuds 2026: 5 That Stay Put Through Any ..., Video, watch on YouTube",
        "position": 6
      }
    ],
    "peopleAlsoAsk": [
      {
        "question": "What is the 60-60 rule for earbuds?"
      },
      {
        "question": "What are the best wireless earbuds for home office use?"
      },
      {
        "question": "Which earbuds are best while driving?"
      },
      {
        "question": "Which earbuds are best for daily use?"
      }
    ],
    "aioverview": {
      "text": "The best wireless earbuds for commuting are the Sony WF-1000XM6\nGo to product viewer dialog for this item.\n, which provide incredible active noise cancellation (ANC) to silence loud transit sounds like subway rumbles and traffic.\nTop Commuter Picks\nBest Overall for Noise Blocking: Sony WF-1000XM6\nGo to product viewer dialog for this item.\noffer top-tier noise isolation, rich customizable sound, a great microphone for calls on the go, and over 8 hours of battery life with ANC on.",
      "sources": [
        {
          "url": "https://www.techgearlab.com/topics/audio/best-wireless-earbuds",
          "label": "TechGearLab (+1) - Related results",
          "position": 1
        },
        {
          "url": "https://www.rtings.com/headphones/reviews/best/wireless-earbuds",
          "label": "RTINGS.com (+1) - Related results",
          "position": 2
        },
        {
          "url": "https://www.forbes.com/sites/forbes-personal-shopper/article/the-best-wireless-earbuds/",
          "label": "Forbes (+1) - Related results",
          "position": 3
        },
        {
          "url": "https://www.cnet.com/tech/mobile/best-wireless-earbuds/",
          "label": "CNET - Related results",
          "position": 4
        },
        {
          "url": "https://www.youtube.com/watch?v=23My2YGjKzE",
          "label": "1:40",
          "position": 5
        },
        {
          "url": "https://www.youtube.com/watch?v=JLGn9NLfE6g&t=496",
          "label": "Best Running Earbuds 2026: 5 That Stay Put Through Any ..., Video, watch on YouTube",
          "position": 6
        }
      ]
    },
    "text": "The best wireless earbuds for commuting are the Sony WF-1000XM6\nGo to product viewer dialog for this item.\n, which provide incredible active noise cancellation (ANC) to silence loud transit sounds like subway rumbles and traffic.\nTop Commuter Picks\nBest Overall for Noise Blocking: Sony WF-1000XM6\nGo to product viewer dialog for this item.\noffer top-tier noise isolation, rich customizable sound, a great microphone for calls on the go, and over 8 hours of battery life with ANC on."
  }
}

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

핵심 검색어에 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": "GOOGLE",
  "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은 모든 검색에 AI 오버뷰를 생성하지 않습니다. 수집은 완료됐지만 오버뷰가 없는 결과도 정상 관측입니다. 국가와 검색어에 따라서도 제공 여부가 달라집니다.

상세 API 문서 (영문) ↗