Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cloro.dev/llms.txt

Use this file to discover all available pages before exploring further.

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 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 structure (position, url, label, and description).
Sources in AI Overview

​
Videos

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

​
Ads

Sponsored ads injected by Google inside the AI Overview. Includes both text ads and shopping/product ads:
Ads in AI Overview
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": "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"
        }
      ]
    }
  }
}