Skip to main content
This section documents the ads data returned by the ChatGPT endpoint. Ads are part of the ChatGPT response — no separate API call is needed, but you must opt-in with include.ads: true.

​
Example request

Ads are opt-in: set include.ads: true in your request to include them in the response. 
{
  "prompt": "What are the best running shoes?",
  "model": "CHATGPT",
  "country": "US",
  "include": {
    "ads": true
  }
}
This produces a response containing the ads array documented below.

​
Overview

Ads are automatically extracted when ChatGPT displays advertising content in responses. To include ads in your response, set include.ads: true in your request.
Opt-in featureAds extraction is disabled by default. You must explicitly set include.ads: true to extract ads from ChatGPT responses.

​
Ad structure

Each ad contains:
FieldTypeDescription
brandobjectAdvertiser brand information (name, url, favicon)
cardsarrayArray of carousel cards promoting products/services

​
Brand structure

The brand object includes:
FieldTypeDescription
namestringAdvertiser brand name
urlstringAdvertiser brand URL with attribution
faviconstringAdvertiser brand favicon URL (optional)

​
Card structure

Each carousel card includes:
FieldTypeDescription
titlestringCard title/heading
bodystringCard description text
urlstringCard destination URL with attribution
imagestringCard image URL (optional)

​
Example usage

{
  "prompt": "What are the best running shoes?",
  "model": "CHATGPT",
  "country": "US",
  "include": {
    "ads": true
  }
}
Response with ads: 
{
  "success": true,
  "result": {
    "text": "Here are some excellent running shoes...",
    "ads": [
      {
        "brand": {
          "name": "Acme Shoes",
          "url": "https://www.acmeshoes.com?utm_source=chatgpt.com",
          "favicon": "https://images.openai.com/favicon.ico"
        },
        "cards": [
          {
            "title": "Premium Running Shoes",
            "body": "Lightweight performance running shoes with advanced cushioning technology",
            "url": "https://www.acmeshoes.com/running?utm_source=chatgpt.com",
            "image": "https://images.openai.com/product.jpg"
          },
          {
            "title": "Trail Running Shoes",
            "body": "Durable shoes designed for off-road running with superior grip",
            "url": "https://www.acmeshoes.com/trail?utm_source=chatgpt.com",
            "image": "https://images.openai.com/product2.jpg"
          }
        ]
      }
    ]
  }
}