ChatGPT entities schema

This section documents the entities data returned by the ChatGPT endpoint: structured objects for the specific items, products, brands, or concepts ChatGPT identifies in its answer — like shopping cards but more general — part of the ChatGPT response so no separate API call is needed. Entities appear in the order ChatGPT references them; array index 0 is the first entity mentioned. For use cases, pricing context, and copy-paste examples, see the ChatGPT brand mentions API page on the product site.

Example request

Entities are returned by default when ChatGPT mentions identifiable items; no flag is required.

{
  "prompt": "What are the best sneakers under $100?",
  "country": "US"
}

Entity structure

Field	Type	Description
`type`	string	Entity type identifier (e.g., “product”, “software”)
`name`	string	Entity name or title
`product`	object	The product listing that ChatGPT attached to the entity: price, URL and merchant offers. Same structure as a shopping card product, without `position`. Only with `include.shopping: true`, a paid add-on. The listing of a gpt-6 product card is in `inlineProducts` instead

ChatGPT does not attach a listing to every product that it names, so most entities have no product. Two entities have the same name when ChatGPT attaches two listings to one product name. Some answers show a product with a price and a merchant but no full listing. Its product then has only title, price, merchants, rating and num_reviews, with no id and no offers.

Response example

{
  "success": true,
  "result": {
    "text": "Here are sneaker options under $100...",
    "entities": [
      {
        "type": "product",
        "name": "adidas Grand Court Lo",
        "product": {
          "id": "23920641",
          "title": "adidas Grand Court Lo Sneaker",
          "url": "https://www.nordstrom.com/s/adidas-grand-court-lo/7654321?utm_source=chatgpt.com",
          "price": "$75.00",
          "merchants": "Nordstrom",
          "cite": "turn0product4",
          "offers": [
            {
              "merchant_name": "Nordstrom",
              "price": "$75.00",
              "details": "In stock",
              "available": true
            }
          ]
        }
      },
      {
        "type": "product",
        "name": "Reebok Club C 85 Vintage"
      },
      {
        "type": "product",
        "name": "Nike Dunk Low Retro SE"
      }
    ]
  }
}

Overview

ChatGPT

Google

Google AI Mode

Bing AI Mode

Gemini

Google News

Async tasks

Utilities

ChatGPT entities schema

Example request

Entity structure

Response example