ChatGPT entities schema

This section documents the entities data returned by the ChatGPT endpoint. Entities are part of the ChatGPT response, so no separate API call is needed. 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?",
  "model": "CHATGPT",
  "country": "US"
}

This produces a response containing the entities array documented below.

Overview

Entities are structured data objects extracted from ChatGPT responses when specific items, products, or concepts are identified. They provide information about individual items mentioned in the response, similar to shopping cards but more general. Entities appear in the order ChatGPT references them in the response; array index 0 is the first entity mentioned.

Entity structure

Each entity contains:

Field	Type	Description
`type`	string	Entity type identifier (e.g., “product”, “software”)
`name`	string	Entity name or title

Example usage

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

Response with entities:

{
  "success": true,
  "result": {
    "text": "Here are sneaker options under $100...",
    "entities": [
      {
        "type": "product",
        "name": "adidas Grand Court Lo"
      },
      {
        "type": "product",
        "name": "Reebok Club C 85 Vintage"
      },
      {
        "type": "product",
        "name": "Nike Dunk Low Retro SE"
      }
    ]
  }
}

Inline products Map entries

⌘I

Overview

ChatGPT

Google

Perplexity

Copilot

AI Mode

Grok

Gemini

Google News

Utilities

ChatGPT entities schema

Example request

Overview

Entity structure

Example usage

​Example request

​Overview

​Entity structure

​Example usage

Example request

Overview

Entity structure

Example usage