Skip to main content
POST
/
v1
/
monitor
/
chatgpt
Monitor ChatGPT Responses
curl --request POST \
  --url https://api.cloro.dev/v1/monitor/chatgpt \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "What do you know about Acme Corp?",
  "country": "US",
  "include": {
    "markdown": true,
    "rawResponse": true,
    "searchQueries": true
  }
}
'
{
  "success": true,
  "result": {
    "text": "The name \"Acme Corporation\" is used in various contexts, both fictional and real. Here's an overview:\n\n🐾 Acme Corporation in Fiction\nThe Acme Corporation is a fictional company featured prominently in Warner Bros. cartoons, particularly the Road Runner/Wile E. Coyote series.",
    "sources": [
      {
        "position": 1,
        "url": "https://www.rippling.com/blog/ai-recruiting?utm_source=chatgpt.com",
        "label": "Rippling",
        "description": "12 Best AI Recruiting Tools For HR in 2025 | Rippling"
      },
      {
        "position": 2,
        "url": "https://www.index.dev/blog/ai-recruiting-software-hiring-managers?utm_source=chatgpt.com",
        "label": "Index.dev",
        "description": "7 Best AI Recruiting Software for Hiring Managers in 2025"
      },
      {
        "position": 3,
        "url": "https://www.selectsoftwarereviews.com/buyer-guide/ai-recruiting?utm_source=chatgpt.com",
        "label": "SelectSoftware Reviews",
        "description": "10+ Best AI Recruiting Software for 2025: Expert Reviews + Pricing"
      }
    ],
    "html": "https://storage.cloro.dev/results/c45a5081-808d-4ed3-9c86-e4baf16c8ab8/page-1.html",
    "markdown": "The name \"Acme Corporation\" is used in various contexts, both fictional and real. Here's an overview:\n\n🐾 Acme Corporation in Fiction\nThe Acme Corporation is a fictional company featured prominently in Warner Bros. cartoons, particularly the Road Runner/Wile E. Coyote series.",
    "rawResponse": [
      {
        "type": "resume_conversation_token",
        "token": "eyJhbGciOiJFUzI1Ni...WaVoqQ",
        "conversation_id": "68efc64b-2d74-8012-b87d-28e59f3b8a49"
      },
      {
        "type": "message_start",
        "message": {
          "id": "msg_01JD6Q7H1ZKWM9GD34V5ZW1TYM",
          "role": "assistant",
          "model": "gpt-5"
        }
      },
      {
        "type": "message_delta",
        "delta": {
          "content": [
            {
              "type": "output_text_delta",
              "text_delta": "The name \"Acme Corporation\" is used in various contexts..."
            }
          ]
        }
      },
      {
        "type": "message_stop",
        "reason": "end_turn"
      }
    ],
    "searchQueries": [
      "What is Acme Corporation?",
      "Acme Corp company overview",
      "Acme Corporation products and services"
    ],
    "model": "gpt-5",
    "shoppingCards": [
      {
        "tags": [
          "stylish casual leather sneaker",
          "heritage retro leather sneaker"
        ],
        "products": [
          {
            "title": "Adidas VL Court 3.0",
            "url": "https://www.adidas.com/us/vl-court-3.0-shoes/ID8797.html?utm_source=chatgpt.com",
            "price": "$57.00",
            "featured_tag": "stylish casual leather sneaker",
            "merchant": "adidas + others",
            "imageUrls": [
              "https://images.openai.com/static-rsc-1/example.jpg"
            ],
            "rating": 4.7,
            "numReviews": 10394,
            "id": "3250714974047560249",
            "offers": [
              {
                "merchant_name": "adidas",
                "product_name": "Adidas Women's VL Court 3.0",
                "url": "https://www.adidas.com/us/vl-court-3.0-shoes/ID8797.html?utm_source=chatgpt.com",
                "price": "$57.00",
                "details": "In stock online and nearby, Delivery between Sat - Mon $4.99",
                "available": true,
                "checkoutable": false,
                "price_details": {
                  "base": "$57.00",
                  "total": "$57.00"
                },
                "tag": {
                  "text": "Best price"
                }
              }
            ],
            "rating_grouped_citation": {
              "title": "Adidas Women's VL Court 3.0",
              "url": "https://www.adidas.com/us/vl-court-3.0-shoes/ID8797.html",
              "supporting_websites": [
                {
                  "title": "Adidas Women's VL Court 3.0",
                  "url": "https://www.macys.com/shop/product/adidas-womens-vl-court-3.0-casual-sneakers-from-finish-line?ID=21107988&pla_country=US&CAGPSPN=pla"
                }
              ]
            }
          }
        ]
      }
    ],
    "entities": [
      {
        "type": "product",
        "name": "adidas Grand Court Lo"
      },
      {
        "type": "product",
        "name": "Reebok Club C 85 Vintage"
      },
      {
        "type": "product",
        "name": "Nike Dunk Low Retro SE"
      }
    ]
  }
}

Overview

The ChatGPT endpoint extracts structured data from ChatGPT with advanced features including shopping cards, brand entities, raw response data, and query fan-out. It’s the most comprehensive monitoring endpoint, ideal for e-commerce tracking and deep analysis.

Unique features

  • Shopping cards: Automatically extracts structured product information with pricing, ratings, offers, and commercial details
  • Entity extraction: Identifies and extracts named entities like products, brands, and concepts mentioned in responses
  • Raw response access: Includes the complete streaming response payload for advanced debugging
  • Query fan-out insights: Reveals the actual query fan-out ChatGPT used to generate responses

Request parameters

Uses common parameters. ChatGPT-specific options:
  • include.rawResponse (boolean): Include raw streaming response events. Defaults to false (+2 credits)
  • include.searchQueries (boolean): Include search model queries (fan-out queries) that ChatGPT uses internally to gather information. Defaults to false (+2 credits)

Shopping cards

Shopping cards are automatically extracted when ChatGPT returns product or commercial information. No additional parameters are required - shopping cards are included by default when available in the response.

Shopping card structure

Each shopping card contains:
FieldTypeDescription
tagsarrayCategory tags for the shopping card (e.g., [“electronics”, “deals”])
productsarrayArray of product information objects

Product information

Each product includes comprehensive e-commerce data:
FieldTypeDescription
titlestringProduct name
urlstringProduct page URL with ChatGPT attribution
pricestringCurrent price (e.g., “$57.00”)
featured_tagstringProduct category or style tag
merchantstringMerchant information (e.g., “adidas + others”)
imageUrlsarrayArray of product image URLs (multiple sizes)
ratingfloatProduct rating (0-5 scale)
numReviewsintegerNumber of reviews
idstringUnique product identifier
offersarrayArray of shopping offers from different merchants
rating_grouped_citationobjectRating source information with supporting websites

Offer information

Each offer contains merchant-specific details:
FieldTypeDescription
merchant_namestringMerchant name (e.g., “adidas”, “Macy’s”)
product_namestringProduct name as listed by merchant
urlstringOffer URL with ChatGPT attribution
pricestringOffer price (e.g., “$57.00”)
detailsstringStock and delivery information
availablebooleanOffer availability status
checkoutablebooleanWhether offer can be checked out directly
price_detailsobjectDetailed price breakdown
tagobjectPromotional tag (e.g., “Best price”)

Price details

Offers include detailed price breakdown:
FieldTypeDescription
basestringBase product price
totalstringTotal price including any additional costs

Rating citation information

Products include rating source attribution:
FieldTypeDescription
titlestringSource title
urlstringSource URL
supporting_websitesarrayArray of supporting website references

Example usage

{
  "prompt": "What are the best sneakers under $100?",
  "model": "CHATGPT",
  "country": "US"
}
Response with shopping cards:
{
  "success": true,
  "result": {
    "text": "If you're shopping for good sneakers under $100, it's definitely doable...",
    "shoppingCards": [
      {
        "tags": [
          "stylish casual leather sneaker",
          "heritage retro leather sneaker",
          "canvas everyday skate-inspired"
        ],
        "products": [
          {
            "title": "Adidas VL Court 3.0",
            "url": "https://www.adidas.com/us/vl-court-3.0-shoes/ID8797.html?utm_source=chatgpt.com",
            "price": "$57.00",
            "featured_tag": "stylish casual leather sneaker",
            "merchant": "adidas + others",
            "imageUrls": [
              "https://images.openai.com/static-rsc-1/AY2CiYu1AtGyrY1sX2_dN8Y7naInL0DvIvB1GO-loo2SdZW-LiT6_5gDEgLFJhrM60Vxg2uSbf8tn6WWltaLtpeZkkaGxjwbTm0PlICUvbMwZhhJBABlb-kVVV8m8bYX01_WnkdZrLO2uKEKcYzx3dt1w-E_i-5S4Qarcvp8-hTIM49zkLoHoZcVobqOx8CrulkNdcAoTyegDV532upAMzt1gH7PhFfVVQGyuFsWS_1iaY7_M5qdiKhB01R02Btl"
            ],
            "id": "3250714974047560249",
            "rating": 4.7,
            "numReviews": 10394,
            "offers": [
              {
                "merchant_name": "adidas",
                "product_name": "Adidas Women's VL Court 3.0",
                "url": "https://www.adidas.com/us/vl-court-3.0-shoes/ID8797.html?utm_source=chatgpt.com",
                "price": "$57.00",
                "details": "In stock online and nearby, Delivery between Sat - Mon $4.99",
                "available": true,
                "checkoutable": false,
                "price_details": {
                  "base": "$57.00",
                  "total": "$57.00"
                },
                "tag": {
                  "text": "Best price"
                }
              },
              {
                "merchant_name": "Macy's",
                "product_name": "Adidas Women's VL Court 3.0",
                "url": "https://www.macys.com/shop/product/adidas-womens-vl-court-3.0-casual-sneakers-from-finish-line?ID=21107988&pla_country=US&CAGPSPN=pla&utm_source=chatgpt.com",
                "price": "$60.00",
                "details": "In stock online and nearby, Free delivery between Fri - Mon",
                "available": true,
                "checkoutable": false,
                "price_details": {
                  "base": "$60.00",
                  "total": "$60.00"
                }
              }
            ],
            "rating_grouped_citation": {
              "title": "Adidas Women's VL Court 3.0",
              "url": "https://www.adidas.com/us/vl-court-3.0-shoes/ID8797.html",
              "supporting_websites": [
                {
                  "title": "Adidas Women's VL Court 3.0",
                  "url": "https://www.macys.com/shop/product/adidas-womens-vl-court-3.0-casual-sneakers-from-finish-line?ID=21107988&pla_country=US&CAGPSPN=pla"
                }
              ]
            }
          }
        ]
      }
    ]
  }
}

Entities

The entities object is currently not being returned by OpenAI. The field remains in the schema to support potential future availability.
Entities are structured data objects extracted from ChatGPT responses when specific items, products, or concepts are identified. Entities provide detailed information about individual items mentioned in the response, similar to shopping cards but more general in nature.

Entity structure

Each entity contains:
FieldTypeDescription
typestringEntity type identifier (e.g., “product”, “software”)
namestringEntity 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 some great 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"
      }
    ]
  }
}

Response schema

Includes common response fields plus:
FieldTypeDescription
result.rawResponsearrayArray of ChatGPT’s streamed response events (included when include.rawResponse is true)
result.searchQueriesarrayArray of search model queries (fan-out queries) ChatGPT used internally to gather information (included when include.searchQueries is true)
result.shoppingCardsarrayArray of shopping/product cards extracted from response (when available)
result.entitiesarrayArray of entities extracted from response (when available)
result.sourcesarrayArray of sources referenced in the response (when available)
result.modelstringThe ChatGPT model used to generate the response
ChatGPT doesn’t provide sources for certain promptsWhen web search is triggered but no sources are available, the sources field will return an empty array.Example response when no sources are available:
{
  "success": true,
  "result": {
    "text": "Here's the response without any source citations...",
    "sources": []
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request parameters for monitoring ChatGPT responses

prompt
string
required

The prompt to send to ChatGPT

Required string length: 1 - 10000
Example:

"What do you know about Acme Corp?"

country
string
default:US

Optional country/region code for localized monitoring

Example:

"US"

include
object

Optional flags for including additional response formats

Example:
{
"markdown": true,
"rawResponse": true,
"searchQueries": true
}

Response

successful ChatGPT monitoring response

success
boolean
required
Example:

true

result
object
required

ChatGPT's response data