> ## Documentation Index
> Fetch the complete documentation index at: https://cloro.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Entities

> Schema for structured entity data extracted from ChatGPT responses, including products, brands, organizations, people, and concepts with descriptions.

This section documents the **entities** data returned by the [ChatGPT endpoint](/api-reference/endpoint/monitor-chatgpt). Entities are part of the ChatGPT response, so no separate API call is needed.

## Example request

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

```json theme={null}
{
  "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

```json theme={null}
{
  "prompt": "What are the best sneakers under $100?",
  "model": "CHATGPT",
  "country": "US"
}
```

**Response with entities:**

```json theme={null}
{
  "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"
      }
    ]
  }
}
```
