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 — no separate API call is needed.

Overview

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.videosarrayVideos included in AI Overview
result.aioverview.adsarraySponsored ads injected in AI Overview

Sources

result.aioverview.sources follows the common sources structureposition, url, label, and description.

Videos

Video content included 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

Ads

Sponsored ads injected by Google inside the AI Overview. Includes both text ads and shopping/product ads:
FieldTypeDescription
positionnumberPosition of ad (1-indexed)
titlestringAd title
urlstringAd destination URL
domainstringDomain name of the advertiser
descriptionstringAd description text
priceobjectProduct price for shopping ads
old_priceobjectOriginal price before discount (shopping ads)
storestringRetailer name for shopping ads

Ad price object

FieldTypeDescription
valuenumberNumeric price value
currencystringCurrency symbol (e.g., $)

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...",
      "sources": [
        {
          "position": 1,
          "url": "https://example.com/best-dev-laptops",
          "label": "Best laptops for developers",
          "description": "Comprehensive guide to laptops for software development."
        }
      ],
      "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,
          "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.",
          "price": {
            "value": 1799,
            "currency": "$"
          },
          "store": "Dell"
        }
      ]
    }
  }
}