Google AI Overviews, now in Markdown

Read AI Overviews through aioverview.markdown, with the headings, lists and tables Google lays out.

What changed

• aioverview.markdown: the AI Overview as Markdown, with its headings, lists, tables and bold text in place.
• aioverview.text stays exactly as before and carries the same words, so code that reads the plain text keeps working.
• Google AI Mode answers carry the same Markdown as markdown on every result.

How it works

Google lays out an AI Overview with headings, numbered steps, bullet lists and comparison tables. aioverview.text holds the words, and aioverview.markdown keeps the layout too, so you can render the overview the way searchers see it or read its structure in code. The cited pages stay in aioverview.sources.

Turn it on with include.aioverview.markdown: true. The shared flag include.markdown: true, which other engines already read, turns it on too.

Where it helps

• Show AI Overviews in your own dashboards and reports with their original formatting.
• Find which brands Google lists in an overview’s steps, tables and comparisons.
• Split an overview into its sections to see which topics Google covers first.

Send a request

Send the request with your API key in the Authorization header.

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 }
    }
  }'

Request fields

taskTypestringRequired

The engine to run, such as CHATGPT or GOOGLE.

payload.querystringRequired

The search query, written the way a user types it into the search box.

payload.countrystring

Two-letter country code of the market to ask from, such as US, KR or JP. Default US.

payload.include.markdownboolean

true adds aioverview.markdown: the overview with its headings, lists and tables, laid out as Google shows it.

webhook.urlstring

An HTTPS address on your server. The finished task is posted there the moment it completes.

Response

A finished task looks like this, trimmed for length.

{
  "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, then COMPLETED with the answer or FAILED with error.

credits.creditsChargedinteger

Credits charged for the finished task. A failed task charges 0.

response.aioverviewobject

The AI Overview with its text, sources and, on request, markdown. null marks a query that Google answers with search results alone.

response.aioverview.markdownstring

The overview as Markdown, in the layout Google shows: ### headings, lists, tables and bold text.

Receive the result

The request returns the task right away with status QUEUED. Poll GET /v1/async/task/{id} until status is COMPLETED or FAILED, or add webhook.url and the finished task arrives at your server with the same task, credits and response. Results stay available for 24 hours after a task finishes.

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

Pricing

The price stays at 2 credits per completed task, Markdown included.