Skip to main content
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.

​
Overview

AI Overview in Google Search

AI Overview in Google Search

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.

​
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

FieldTypeDescription
result.aioverviewobjectGoogle AI Overview data (if requested)
result.aioverview.textstringAI Overview text content
result.aioverview.markdownstringAI Overview in markdown format (if requested)
result.aioverview.sourcesarraySources referenced in AI Overview
result.aioverview.citationPillsarrayInline citation pills, denormalized per cited source (when present)
result.aioverview.videosarrayVideos included in AI Overview
result.aioverview.adsarraySponsored ads injected in AI Overview

​
Sources

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

Sources in AI Overview

​
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.
FieldTypeDescription
labelstringPer-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.
citationPillIdintegerStable identifier shared by all entries from the same visible chip. 1-based ordinal assigned in document order.
urlstringDirect URL of the cited source.
domainstringHost extracted from url, for grouping and display.
descriptionstringSource snippet from the sources rail when Google ships one. Omitted when absent.
positioninteger1-based position of this source in the sibling result.aioverview.sources array.

​
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.
Videos in AI Overview

Videos in AI Overview

FieldTypeDescription
urlstringDirect URL to the video
titlestringVideo title
thumbnailstringThumbnail image URL
sourcestringChannel or source name
platformstringVideo platform (e.g., YouTube)
datestringUpload date
durationstringVideo 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.

​
Ads

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.
Ads in AI Overview

Ads in AI Overview

FieldTypeAlways presentDescription
positionnumberYesPosition of ad (1-indexed)
titlestringYesAd title
urlstringYesAd destination URL
typestringYesSub-type discriminator: "TEXT" or "SHOPPING"
domainstringWhen type is TEXTDomain name of the advertiser
descriptionstringWhen type is TEXTAd description text
priceobjectWhen type is SHOPPINGProduct price
old_priceobjectWhen type is SHOPPING, with sale pricingOriginal price before discount
storestringWhen type is SHOPPINGRetailer name
imagestringWhen extractedAd 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:
FieldTypeDescription
valuenumberNumeric price. Present when the visible string parses unambiguously into a number.
currencystringCurrency symbol (e.g. $, £, €). Present when a recognized symbol is detected.
rawstringVisible 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)",
      "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
        }
      ],
      "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..."
        }
      ]
    }
  }
}
Sources in AI Overview
Videos in AI Overview
AI Overview in Google Search
Ads in AI Overview