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 ads data returned by the Google AI Mode endpoint. Ads are part of the AI Mode response — no separate API call is needed.

​
Example request

Ads are intent-detected: send a prompt with high commercial intent (for example, comparing or buying a specific product category). No flag is required. 
{
  "prompt": "best 3D printers for hobbyists",
  "country": "US"
}
This produces a response containing the ads object documented below.

​
Overview

Sponsored ad section extracted from the response when AI Mode surfaces sponsored shopping results.
Ads in AI Mode
ads is an object, not an array. AI Mode wraps sponsored results in an AdSection object with a section title and an ads array of individual ad items. This differs from other providers (e.g., ChatGPT ads) where ads is a flat array — check the wrapper shape when parsing.

​
AdSection structure

FieldTypeDescription
titlestringSection title for the ads (e.g., “Here are some 3D printers to consider”)
adsarrayArray of sponsored ad items

​
Ad item structure

FieldTypeDescription
titlestringAd product title
urlstringAd click-through URL
positionintegerPosition index of the ad
priceobjectStructured pricing with value and currency
storestringMerchant/store name
ratingnumberProduct rating
reviewsstringReview count

​
price

FieldTypeDescription
valuenumberNumeric price
currencystringCurrency symbol

​
Response example

{
  "success": true,
  "result": {
    "text": "Here are some 3D printers to consider...",
    "ads": {
      "title": "Here are some 3D printers to consider",
      "ads": [
        {
          "title": "Bambu Lab X2D",
          "url": "https://www.google.com/aclk?sa=L&ai=abc",
          "position": 1,
          "price": {
            "value": 899.0,
            "currency": "$"
          },
          "store": "Bambu Lab US",
          "rating": 4.7,
          "reviews": "584"
        }
      ]
    }
  }
}