체인지로그2026년 5월 5일새 기능

Google AI Overview를 지원해요

Google AI Overviews

검색어를 보내면 Google AI Overview와 인용 페이지를, 같은 페이지의 일반 검색 결과, 관련 질문, 관련 검색어와 함께 받아요.

받는 결과

aioverview.text, aioverview.sources: AI Overview 본문과 인용 페이지입니다.
organicResults: 같은 페이지의 일반 검색 결과로, 순위, 제목, 링크, 요약문이 담깁니다.
Google이 보여 주면 peopleAlsoAsk, relatedSearches, knowledgeGraph, ads도 함께 받습니다.

동작 방식

태스크마다 지정한 국가에서 Google에 검색어를 입력하고 결과 페이지 전체를 읽습니다. AI Overview를 보여 줄지는 Google이 검색마다 정하고, 완료된 결과마다 AI Overview가 나왔는지 기록됩니다. 나왔으면 aioverview에 담기고, 일반 검색 결과만 있는 페이지면 null이 됩니다.

이 기록이 그대로 지표가 됩니다. 키워드 세트에서 AI Overview가 나온 검색어의 비율이 노출률이고, AI Overview 내용은 Google이 앞세우는 브랜드와 페이지를 보여 줍니다.

이렇게 활용하세요

목표 키워드 중 AI Overview가 뜨는 비율을 시장별로 측정합니다.
내 페이지가 AI Overview에 인용되는지, 아래 일반 검색 결과에 노출되는지 확인합니다.
관련 질문과 관련 검색어에서 추적할 새 질문을 찾습니다.

요청 보내기

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": "GOOGLE",
    "payload": {
      "query": "best wireless earbuds for commuting",
      "country": "US"
    }
  }'

요청 필드

taskTypestring필수: 실행할 엔진입니다. CHATGPT, GOOGLE 같은 값을 넣습니다.
payload.querystring필수: 사용자가 검색창에 입력하듯 쓴 검색어입니다.
payload.countrystring: 질문할 시장의 두 글자 국가 코드입니다. US, KR, JP 등. 기본값 US.
payload.include.markdownboolean: true면 Google 화면 그대로 제목, 목록, 표를 살린 aioverview.markdown을 함께 받습니다.
webhook.urlstring: 서버의 HTTPS 주소입니다. 태스크가 끝나는 즉시 결과를 이 주소로 보냅니다.
idempotencyKeystring: 요청에 붙이는 고유 ID입니다. 키 하나는 계정에서 태스크 하나를 만들므로, 다시 보내도 태스크는 하나로 유지됩니다.

응답

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

JSON

{
  "success": true,
  "task": {
    "id": "310ab45d-209e-4a15-8379-9379ab041d48",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T15:53:21.022Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Anker Soundcore Space A40 is the best wireless earbud for commuting due to its strong adaptive noise cancellation, long battery life, and compact value.",
      "sources": [
        {
          "position": 1,
          "url": "https://www.soundcore.com/products/space-a40-a3936011",
          "label": "Anker Soundcore Space A40"
        },
        {
          "position": 2,
          "url": "https://www.techtimes.com/articles/313618/20260101/best-wireless-bluetooth-earbuds-under-100-are-they-really-worth-price.htm",
          "label": "Tech Times"
        }
      ],
      "shoppingCards": [
        {
          "position": 1,
          "title": "Anker Soundcore Space A40",
          "price": { "raw": "$54.99", "value": 54.99, "currency": "$" },
          "store": "soundcore US",
          "rating": 4.4,
          "reviews": "1.2K"
        }
      ]
    },
    "organicResults": [
      {
        "position": 1,
        "title": "Highest Rated Wireless Earbuds",
        "link": "https://www.amazon.com/Highest-Rated-Wireless-Earbuds/s?k=Highest+Rated+Wireless+Earbuds",
        "snippet": "Soundcore by Anker P20i True Wireless Earbuds, 10mm Drivers with Big Bass, Bluetooth 5.3, 30H Long Playtime, Water-Resistant, 2 Mics for AI Clear Calls, ..."
      }
    ],
    "peopleAlsoAsk": [
      { "question": "What are the best wireless earbuds for office work?" }
    ],
    "relatedSearches": [
      { "query": "Best wireless earbuds for commuting reddit" },
      { "query": "Best wireless earbuds for commuting iphone" }
    ]
  }
}

task.statusstring: QUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.
credits.creditsChargedinteger: 끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.
response.aioverviewobject: AI 개요의 text, sources, 요청 시 markdown입니다. 구글이 검색 결과만 보여 준 쿼리는 null로 표시됩니다.
response.aioverview.shoppingCardsarray: 개요에 나온 상품 카드입니다. 상품명, 가격, 판매처, 평점, 리뷰 수, 상품 링크가 담깁니다.
response.organicResultsarray: 페이지의 검색 결과입니다. position, title, link, snippet, page가 담깁니다.
response.peopleAlsoAskarray: 구글이 페이지에 보여 준 관련 질문입니다.
response.relatedSearchesarray: 페이지 하단의 관련 검색어입니다.

결과 받기

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

요금

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

다른 업데이트

Answers2026년 10월 3일개선
이제 ChatGPT, Gemini, Google에서 중국 본토를 지원해요
CHATGPT, GEMINI, GOOGLE 태스크의 country를 CN이나 HK로 정해 중국 본토와 홍콩 사용자가 보는 답변을 받으세요.
Answers2026년 10월 3일개선
정확한 위치 지정이 Google AI Mode, AI Overview, 검색 결과로 넓어졌어요
GOOGLE, AIMODE, GOOGLE_SERP 태스크에 payload.location을 넣어 그 장소의 사용자가 보는 AI Overview, AI Mode 답변, 검색 결과를 받으세요.

제품 업데이트를 이메일로 보내드립니다.

RSS 구독