Ads - cloro docs

API Reference › ChatGPT › Ads

Advertising blocks that cloro pulls out of a ChatGPT answer — the advertiser's brand identity plus the carousel of promoted product cards shown alongside it.

Overview

Ads are delivered inline with the standard ChatGPT extraction, so there is no dedicated endpoint or extra request to make. Because the field adds weight to the payload, it is off by default: flip include.ads to true in your request body and cloro will append an ads array to the result whenever ChatGPT surfaces sponsored content for that prompt.

Entries preserve the visual order of the answer — the item at index 0 is the ad ChatGPT rendered first, and the cards inside each ad follow the same left-to-right ordering as the on-screen carousel. When a prompt returns no advertising, the ads array is simply empty.

Enabling ads

{
  "prompt": "What are the best running shoes?",
  "model": "CHATGPT",
  "country": "US",
  "include": {
    "ads": true
  }
}

Ad object

Field	Type	Description
brand	object	Identity of the advertiser — see the Brand object below.
cards	array	Ordered carousel cards, each promoting a product or offer.

Brand object

Field	Type	Description
name	string	Display name of the advertiser.
url	string	Landing URL for the advertiser, including any attribution parameters.
favicon	string	Icon URL for the advertiser's site. May be absent.

Card object

Field	Type	Description
title	string	Headline shown on the card.
body	string	Supporting copy describing the product or offer.
url	string	Click-through destination for the card, with attribution parameters attached.
image	string	Thumbnail image for the card. May be absent.

Response example

{
  "success": true,
  "result": {
    "text": "Here are a few running shoes worth considering...",
    "ads": [
      {
        "brand": {
          "name": "Acme Shoes",
          "url": "https://www.acmeshoes.com?utm_source=chatgpt.com",
          "favicon": "https://www.acmeshoes.com/favicon.ico"
        },
        "cards": [
          {
            "title": "Premium Running Shoes",
            "body": "Lightweight trainers with responsive cushioning for daily miles.",
            "url": "https://www.acmeshoes.com/running?utm_source=chatgpt.com",
            "image": "https://cdn.acmeshoes.com/img/running.jpg"
          },
          {
            "title": "Trail Running Shoes",
            "body": "Rugged, high-grip build engineered for off-road terrain.",
            "url": "https://www.acmeshoes.com/trail?utm_source=chatgpt.com",
            "image": "https://cdn.acmeshoes.com/img/trail.jpg"
          }
        ]
      }
    ]
  }
}

Notes

favicon and image are optional — treat them as nullable when parsing.
Ads only appear when ChatGPT actually serves them; a missing or empty ads array is expected for most prompts.
Questions about ad coverage or field behavior can go to [email protected].