체인지로그개선

Google AI Overview를 Markdown으로 받아요

Google AI Overviews
Markdown으로 받은 Google AI Overview와, 같은 내용을 소제목과 표로 렌더링한 화면

aioverview.markdown으로 Google이 구성한 제목, 목록, 표가 그대로 담긴 AI Overview를 읽으세요.

달라진 점

  • aioverview.markdown: AI Overview를 Markdown으로 받습니다. 제목, 목록, 표, 굵은 글씨가 제자리에 있습니다.
  • aioverview.text는 같은 글자를 그대로 담으므로, 일반 텍스트를 읽던 코드도 그대로 동작합니다.
  • Google AI Mode 답변에는 같은 형식의 Markdown이 결과마다 markdown으로 담깁니다.

동작 방식

Google은 AI Overview를 제목, 번호 매긴 단계, 글머리 목록, 비교 표로 구성합니다. aioverview.text에는 글자가 담기고, aioverview.markdown은 이 구성까지 유지하므로 검색 사용자가 보는 모습대로 화면에 그리거나 코드에서 구조를 읽을 수 있습니다. 인용 페이지는 그대로 aioverview.sources에 있습니다.

include.aioverview.markdown: true로 켜세요. 다른 엔진에서 쓰는 공통 플래그 include.markdown: true로도 켜집니다.

이렇게 활용하세요

  • 자체 대시보드와 리포트에 AI Overview를 원래 서식 그대로 보여 줍니다.
  • AI Overview의 단계, 표, 비교 항목에 Google이 어떤 브랜드를 넣는지 찾습니다.
  • AI Overview를 섹션별로 나눠 Google이 어떤 주제를 먼저 다루는지 봅니다.

요청 보내기

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 robot vacuum for pet hair",
      "country": "US",
      "include": { "markdown": true }
    }
  }'

요청 필드

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

응답

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

JSON
{
  "success": true,
  "task": {
    "id": "8dcde5b1-2f53-40b3-b048-05075b03c4a9",
    "taskType": "GOOGLE",
    "status": "COMPLETED",
    "createdAt": "2026-10-02T17:16:57.237Z"
  },
  "credits": { "creditsToCharge": 2, "creditsCharged": 2 },
  "response": {
    "aioverview": {
      "text": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.",
      "markdown": "The Roborock Saros Z70 and the MOVA V50 are top choices for pet hair, combining powerful suction with specialized anti-tangle brush rollers.\n\n### Top Robot Vacuums for Pet Hair\n\n**Roborock Saros Z70**\n\nNamed a top overall pick by experts for its strong hard-floor pickup, smart obstacle recognition, and self-emptying dock. It costs around $1,000.\n\n**MOVA V50**\n\nPraised as a top performer in dog hair tests and obstacle avoidance. It features a dual brush roller and app controls for auto-emptying frequency, usually priced under $700.\n\n…",
      "sources": [
        {
          "position": 2,
          "url": "https://www.rtings.com/robot-vacuum/reviews/best/pet-hair",
          "label": "RTINGS.com"
        },
        {
          "position": 3,
          "url": "https://www.forbes.com/sites/forbes-personal-shopper/article/best-robot-vacuum-for-pet-hair/",
          "label": "Forbes Vetted"
        }
      ]
    }
  }
}
task.statusstring
QUEUED, PROCESSING을 거쳐 답변과 함께 COMPLETED로, 또는 error와 함께 FAILED로 끝납니다.
credits.creditsChargedinteger
끝난 태스크에 청구된 크레딧입니다. 실패한 태스크는 0입니다.
response.aioverviewobject
AI 개요의 text, sources, 요청 시 markdown입니다. 구글이 검색 결과만 보여 준 쿼리는 null로 표시됩니다.
response.aioverview.markdownstring
구글 화면 구조 그대로 옮긴 개요 Markdown입니다. ### 소제목, 목록, 표, 굵은 글씨가 담깁니다.

결과 받기

요청하면 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크레딧이며, Markdown도 포함됩니다.

다른 업데이트

새 소식을 받아보세요

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

RSS 구독