Google AI Overview schema

This section documents the AI Overview data returned by the Google Search endpoint. AI Overview is part of the Google response when requested via include.aioverview, so no separate API call is needed. For use cases, pricing context, and copy-paste examples, see the Google AI Overview API page on the product site.

Overview

AI Overview is Google’s AI-generated summary that appears at the top of certain search results. It includes a text summary, cited sources, optional videos, and occasionally sponsored ads.

AI Overview availability varies by country. Some regions are not supported and return an UnsupportedInputError when include.aioverview is set — this is a region-level error, not a query failure. Other supported regions may return aioverview: null when Google does not show an AI Overview for a specific query. In both cases, all other Google Search result data is returned normally. Use the /v1/countries endpoint with model=aioverview to check current regional availability before sending requests.

Example request

AI Overview is opt-in: set include.aioverview in your request to include it in the response.

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

This produces a response containing the aioverview object documented below.

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 (if requested)
`result.aioverview.sources`	array	Sources referenced in AI Overview
`result.aioverview.citationPills`	array	Inline citation pills, denormalized per cited source (when present)
`result.aioverview.relatedLinks`	array	Pill “related links” — grouped-but-uncited URLs, not in `sources` (when present)
`result.aioverview.videos`	array	Videos included in AI Overview
`result.aioverview.ads`	array	Sponsored ads injected in AI Overview

Sources

result.aioverview.sources follows the common sources structure (position, url, label, and description).

Citation pills

Inline citation pills (e.g. [Chase Bank +3]) Google renders next to the AI Overview text are exposed denormalized: each entry is one (pill, source) pair carrying a per-source label (the source’s own page title). When a pill cites N sources, the array contains N entries sharing the same citationPillId but carrying different per-source label, url, and domain. Group by citationPillId to recover the pill-level structure. The field is omitted when the answer carries no pills.

Field	Type	Description
`label`	string	Per-source title from the sources rail (e.g. `"Best laptops for developers"`). Always present; may be an empty string when the rail has no title for this source — read `domain` / `url` for source identity in that case.
`citationPillId`	integer	Stable identifier shared by all entries from the same visible chip. 1-based ordinal assigned in document order.
`url`	string	Direct URL of the cited source.
`domain`	string	Host extracted from `url`, for grouping and display.
`description`	string	Source snippet from the sources rail when Google ships one. Omitted when absent.
`position`	integer	1-based position of this source in the sibling `result.aioverview.sources` array.

Alongside its cited sources, a citation chip can expose a “View related links” flyout — additional URLs Google groups under the chip that are not part of the sources rail (for example a Google Shopping comparison link or a tangential page). These surface separately in result.aioverview.relatedLinks so they never inflate sources or citationPills. Each entry shares the citationPillId of the chip it belongs to, so you can associate a related link with that chip’s citation pills. Unlike a citation pill, a related link has no position — it is deliberately absent from the sources array. Related links also render in the markdown field as inline [title](url) links, just like citations. As a result markdown can contain more URLs than sources / citationPills — the extra ones are always the related links accounted for in this array. The field is omitted when a chip carries no related links.

Field	Type	Description
`label`	string	The related page’s own title (e.g. `"Compare developer laptops"`). May be an empty string when Google ships none — read `domain` / `url` for identity.
`citationPillId`	integer	Matches the `citationPillId` of the chip’s citation-pill entries, so related links can be grouped with their pill.
`url`	string	Direct URL of the related link.
`domain`	string	Host extracted from `url`, for grouping and display.
`description`	string	Snippet Google ships for the related link. Omitted when absent.

Videos

Video content included in AI Overview. Videos appear in the order Google embeds them in the AI Overview answer; array index 0 is the first card shown.

Field	Type	Description
`url`	string	Direct URL to the video
`title`	string	Video title
`thumbnail`	string	Thumbnail image URL
`source`	string	Channel or source name
`platform`	string	Video platform (e.g., YouTube)
`date`	string	Upload date
`duration`	string	Video duration

Only url is guaranteed. Every other field is best-effort: Google does not attach every piece of metadata to every video card, and thumbnail and duration in particular are only available when Google renders the rich carousel preview (roughly 60% and 15% of videos in practice). Check for field presence before reading.

Sponsored ads injected by Google inside the AI Overview. Each entry in ads[] is one of two sub-types — text/lead-gen or shopping/product — discriminated by the type field. Sub-type-exclusive fields are only present when they apply to that ad.

Field	Type	Always present	Description
`position`	number	Yes	Position of ad (1-indexed)
`title`	string	Yes	Ad title
`url`	string	Yes	Ad destination URL
`type`	string	Yes	Sub-type discriminator: `"TEXT"` or `"SHOPPING"`
`domain`	string	When `type` is `TEXT`	Domain name of the advertiser
`description`	string	When `type` is `TEXT`	Ad description text
`price`	object	When `type` is `SHOPPING`	Product price
`old_price`	object	When `type` is `SHOPPING`, with sale pricing	Original price before discount
`store`	string	When `type` is `SHOPPING`	Retailer name
`image`	string	When extracted	Ad image URL (product photo for shopping ads, hero image for text ads)

Ad price object

price and old_price carry both a parsed and a raw representation:

Field	Type	Description
`value`	number	Numeric price. Present when the visible string parses unambiguously into a number.
`currency`	string	Currency symbol (e.g. `$`, `£`, `€`). Present when a recognized symbol is detected.
`raw`	string	Visible price text verbatim (e.g. `"$1,499"`, `"$0 down with 24 monthly payments"`).

raw is always present when price is emitted; value and currency only when the string parses unambiguously. Installment / down-payment labels parse the leading "$0" as value: 0 — use raw to disambiguate.

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

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

Google AI Overview schema

Overview

Example request

AI Overview structure

Sources

Citation pills

Videos

Ads

Ad price object

Response example

​Overview

​Example request

​AI Overview structure

​Sources

​Citation pills

​Related links

​Videos

​Ads

​Ad price object

​Response example

Overview

Example request

AI Overview structure

Sources

Citation pills

Related links

Videos

Ads

Ad price object

Response example