체인지로그새 기능

Google AI Mode의 대화형 답변도 가져와요

Google AI Mode
무선 이어폰을 다룬 Google AI Mode 답변과 JSON 결과

원하는 시장에서 Google AI Mode에 질문하고, 대화형 답변과 인용 페이지를 받아요.

받는 결과

  • text: AI Mode의 답변 전문입니다. 보통 AI Overview보다 길고 자세합니다.
  • sources: 답변이 인용한 페이지를 URL, 제목과 함께 받습니다.
  • 전용 태스크 타입 AIMODE: AI Mode와 AI Overview를 별개의 화면으로 나눠 측정합니다.

동작 방식

AI Mode는 Google의 대화형 검색입니다. 질문 하나에 근거 페이지 링크가 붙은 완성된 답변을 씁니다. 태스크마다 지정한 국가에서 AI Mode에 질문하고, 그 시장 사람들이 보는 그대로 답변과 출처를 돌려줍니다.

AI Mode는 비교와 추천 질문에 깊이 있게 답하고 추천 브랜드를 직접 언급합니다. AI Overview와 함께 추적하면 같은 검색어가 두 화면에서 어떻게 나타나는지 볼 수 있습니다.

이렇게 활용하세요

  • AI Mode가 브랜드를 언급하는 추천, 비교 검색어를 추적합니다.
  • 같은 검색어에서 AI Mode와 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": "AIMODE",
    "payload": {
      "query": "best robot vacuum for pet hair",
      "country": "US"
    }
  }'

요청 필드

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

응답

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

JSON
{
  "success": true,
  "task": {
    "id": "937d9eb6-4b33-49fd-b164-df8e2911b964",
    "taskType": "AIMODE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T17:16:57.384Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "markdown": "The **Dreame X50 Ultra** is the overall **best robot vacuum for pet hair**, offering a massive **20,000Pa of suction** and an anti-tangle dual-brush system specifically designed to prevent pet hair wrap.\n\nWhen shopping for a pet hair-focused robot vacuum, comparing suction power, brush design, and price helps identify the right model for your home and budget.\n\n| Model | Key Pet Hair Features | Approx. Price | Best For |\n| --- | --- | --- | --- |\n| **Dreame X50 Ultra** | 20,000Pa suction, Detangling DuoBrush | ~$900 | Heavy shedding & thick carpets |\n| **Roborock Saros Z70** | 5-axis mechanical arm, ultra-thin 7.98 cm body | ~$1,000 | Moving pet toys & low furniture |\n…",
    "shoppingCards": [
      {
        "position": 1,
        "title": "Dreame X50 Ultra",
        "price": { "raw": "$899.99", "value": 899.99, "currency": "$" },
        "store": "Dreametech",
        "rating": 4.5,
        "reviews": "538"
      }
    ],
    "inlineProducts": [
      {
        "position": 1,
        "title": "Dreame X50 Ultra",
        "productLink": "https://www.google.com/search?ibp=oshop&prds=pvt:hg,…"
      }
    ]
  }
}
task.statusstring
QUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.
credits.creditsChargedinteger
끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.
response.textstring
답변 평문입니다.
response.markdownstring
제목, 목록, 표를 살린 답변으로, 모든 결과에 담깁니다.
response.sourcesarray
답변이 인용한 페이지입니다. 엔진이 보여 준 순서대로 position, url, label이 담깁니다.
response.shoppingCardsarray
답변과 함께 나온 상품 카드입니다. 상품명, 가격, 판매처, 평점, 상품 링크가 담깁니다.
response.inlineProductsarray
답변 문장 안에 링크로 걸린 상품명입니다. position, productLink가 담깁니다.

결과 받기

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

요금

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

다른 업데이트

새 소식을 받아보세요

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

RSS 구독