Google AI Overview schema

AI Overview is Google’s AI-generated summary at the top of certain search results, with a text summary, cited sources, optional videos, and occasionally sponsored ads. It is returned by the Google Search endpoint when you set include.aioverview — no separate API call. For use cases, pricing context, and copy-paste examples, see the Google AI Overview API page on the product site.

When Google shows no AI Overview, including in a country where Google doesn’t offer one, the response is a 200 with no aioverview key and the rest of the search data intact. That case is not retried, and the AI Overview add-on is still charged. Call the /v1/countries endpoint with model=aioverview for the countries where AI Overview is available.

Example request

{
  "query": "best laptops for programming",
  "country": "US",
  "include": {
    "aioverview": {
      "markdown": true
    }
  }
}

include.aioverview: true and include.aioverview: {} return the AI Overview without markdown. Send {"markdown": true}, as above, to get result.aioverview.markdown. AI Overview requests are geo-targeted the same way as any Google Search request. Pass country and, when you need city- or state-level precision, a single location string in Google’s canonical format (for example Olympia,Washington,United States). There are no separate city or state parameters. See city and state-level geo-targeting.

AI Overview structure

Field	Type	Description
`result.aioverview`	object	Google AI Overview data (if requested)
`result.aioverview.text`	string	AI Overview text content
`result.aioverview.markdown`	string	AI Overview in markdown format (only with `include.aioverview.markdown: true`)
`result.aioverview.sources`	array	Sources referenced in AI Overview
`result.aioverview.citationPills`	array	Inline citation pills, one entry per cited source (when present)
`result.aioverview.relatedLinks`	array	Related links of a pill, not in `sources` (when present)
`result.aioverview.videos`	array	Videos included in AI Overview
`result.aioverview.places`	array	Place cards in AI Overview (when present)
`result.aioverview.map`	array	Place cards Google geo-tagged, with coordinates (when present)
`result.aioverview.inlineProducts`	array	Product cards in AI Overview, with a token for their merchant offers (when present)
`result.aioverview.ads`	array	Sponsored ads in AI Overview

Response example

{
  "success": true,
  "result": {
    "aioverview": {
      "text": "For programming, look for laptops with at least 16GB of RAM, a fast SSD, and a comfortable keyboard...",
      "markdown": "For programming, look for laptops with at least **16GB of RAM**, a fast SSD, and a comfortable keyboard...[Best laptops for developers](https://example.com/best-dev-laptops)[Compare developer laptops](https://www.google.com/search?q=developer+laptops&ibp=oshop)",
      "sources": [
        {
          "position": 1,
          "url": "https://example.com/best-dev-laptops",
          "label": "Best laptops for developers",
          "description": "Guide to laptops for software development."
        }
      ],
      "citationPills": [
        {
          "label": "Best laptops for developers",
          "citationPillId": 1,
          "url": "https://example.com/best-dev-laptops",
          "domain": "example.com",
          "description": "Guide to development laptops",
          "position": 1
        }
      ],
      "relatedLinks": [
        {
          "label": "Compare developer laptops",
          "citationPillId": 1,
          "url": "https://www.google.com/search?q=developer+laptops&ibp=oshop",
          "domain": "google.com"
        }
      ],
      "videos": [
        {
          "url": "https://www.youtube.com/watch?v=example",
          "title": "Top 5 Laptops for Programmers",
          "thumbnail": "https://i.ytimg.com/vi/example/hqdefault.jpg",
          "source": "Tech Channel",
          "platform": "YouTube",
          "date": "2026-02-10",
          "duration": "12:34"
        }
      ],
      "ads": [
        {
          "position": 1,
          "type": "TEXT",
          "title": "Dell XPS 15 — Developer Edition",
          "url": "https://www.dell.com/xps-15-developer",
          "domain": "dell.com",
          "description": "Pre-configured for Linux development with 32GB RAM.",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQ..."
        },
        {
          "position": 2,
          "type": "SHOPPING",
          "title": "ThinkPad X1 Carbon Gen 12",
          "url": "https://www.bestbuy.com/site/thinkpad-x1-carbon-gen-12/abc123",
          "price": {
            "value": 1499,
            "currency": "$",
            "raw": "$1,499"
          },
          "old_price": {
            "value": 1799,
            "currency": "$",
            "raw": "$1,799"
          },
          "store": "Best Buy",
          "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR..."
        }
      ]
    }
  }
}

Overview

ChatGPT

Google

Google AI Mode

Bing AI Mode

Gemini

Google News

Async tasks

Utilities

Google AI Overview schema

Example request

AI Overview structure

Response example