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": {
    "html": true,
    "markdown": true,
    "rawResponse": true,
    "searchQueries": true,
    "ads": true,
    "shopping": 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": "12 Best AI Recruiting Tools For HR in 2025",
        "description": "Discover the top AI recruiting tools that can help HR professionals streamline their hiring process...",
        "footnote": false,
        "datePublished": "May 22, 2025"
      },
      {
        "position": 2,
        "url": "https://www.index.dev/blog/ai-recruiting-software-hiring-managers?utm_source=chatgpt.com",
        "label": "7 Best AI Recruiting Software for Hiring Managers in 2025",
        "description": "A comprehensive guide to the best AI recruiting software options available for hiring managers...",
        "footnote": false,
        "datePublished": "April 10, 2025"
      },
      {
        "position": 3,
        "url": "https://www.selectsoftwarereviews.com/buyer-guide/ai-recruiting?utm_source=chatgpt.com",
        "label": "10+ Best AI Recruiting Software for 2025: Expert Reviews + Pricing",
        "description": "Expert reviews and pricing information for the best AI recruiting software solutions...",
        "footnote": true
      }
    ],
    "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",
            "image_urls": [
              "https://images.openai.com/static-rsc-1/example.jpg"
            ],
            "rating": 4.7,
            "num_reviews": 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"
                }
              ]
            }
          }
        ]
      }
    ],
    "inlineProducts": [
      {
        "product": {
          "title": "Nike Court Vision Low Next Nature Shoes",
          "url": "https://www.amazon.in/Nike-Court-Vision-Shoes/dp/B098F6QPLK?utm_source=chatgpt.com",
          "description": "Classic sneaker with modern comfort features",
          "price": "$79.99",
          "original_price": "$99.99",
          "featured_tag": "stylish casual leather sneaker",
          "rating": 4.5,
          "num_reviews": 8703,
          "image_urls": [
            "<string>"
          ],
          "id": "prod_12345",
          "variants": "<unknown>",
          "offers": [
            {
              "merchant_name": "Amazon.in",
              "merchant_subtitle": "<string>",
              "product_name": "Nike Men's Court Vision Low Next Nature Shoes",
              "url": "https://www.amazon.in/dp/B098F6QPLK?utm_source=chatgpt.com",
              "price": "$79.99",
              "details": "In stock online, Free delivery",
              "original_price": "<string>",
              "available": true,
              "checkoutable": false,
              "is_digital": true,
              "checkout_payload": "<string>",
              "checkout_image_urls": [
                "<string>"
              ],
              "shop_id": "<string>",
              "provider": "p2",
              "price_details": {
                "display_price": "<string>",
                "base": "$79.99",
                "shipping": "<string>",
                "tax": "<string>",
                "total": "$79.99"
              },
              "tag": {
                "text": "Best price",
                "tooltip": "<string>"
              }
            }
          ],
          "rating_grouped_citation": {
            "title": "Nike Men's Court Vision Low Next Nature Shoes",
            "url": "https://www.amazon.in/dp/B098F6QPLK",
            "supporting_websites": [
              {}
            ]
          },
          "provider": "deprecated",
          "providers": [
            "product_info"
          ],
          "productLookupKey": {
            "data": "<string>"
          },
          "productLookupData": {
            "requestQuery": "<string>",
            "allIds": {},
            "metadataSources": [
              "<string>"
            ]
          },
          "showcaseMetadata": "<unknown>",
          "showPriceDisclosure": false,
          "analyticsMeta": {
            "productEventUuid": "<string>"
          },
          "metadataSources": [
            "p2"
          ],
          "productEventUuid": "<string>"
        },
        "render_as": "hero",
        "details": {
          "rationale": {
            "rationale": "<string>",
            "citations": [
              {}
            ]
          },
          "reviews": {
            "summary": "<string>",
            "reviews": [
              {
                "source": "Amazon",
                "theme": "Ease of Use",
                "summary": "<string>",
                "sentiment": "positive",
                "cite": "<string>",
                "rating": 123,
                "num_reviews": 123,
                "cite_url": "<string>"
              }
            ]
          }
        }
      }
    ],
    "entities": [
      {
        "type": "product",
        "name": "adidas Grand Court Lo"
      },
      {
        "type": "product",
        "name": "Reebok Club C 85 Vintage"
      },
      {
        "type": "product",
        "name": "Nike Dunk Low Retro SE"
      }
    ],
    "map": [
      {
        "name": "Blue Bottle Coffee",
        "category": "Coffee shop",
        "rating": 4.5,
        "review_count": 1234,
        "description": "Specialty coffee roaster known for their meticulous pour-over preparations",
        "directions_url": null,
        "website_url": "https://bluebottlecoffee.com",
        "phone_number": "+1-415-555-0123",
        "position": 1,
        "citations": null
      }
    ],
    "citationPills": [
      {
        "url": "https://example.com/article",
        "label": "Example Article Title",
        "description": "A detailed description of the cited content",
        "domain": "example.com",
        "datePublished": "2025-01-01",
        "citationPillId": 0
      }
    ],
    "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"
          }
        ]
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.cloro.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The ChatGPT endpoint extracts structured data from ChatGPT with features including shopping cards, brand entities, map entries, raw response data, and query fan-out. Useful for e-commerce tracking, local business monitoring, and detailed analysis.
Web search enabledThis endpoint automatically enables ChatGPT’s web search mode for all requests, so responses include current information from the web with source citations.

​
Unique features

  • Sources: Sources include publication dates and footnote indicators for distinguishing primary from secondary references
  • Shopping cards: Extracts structured product information with pricing, ratings, offers, and commercial details
  • Inline products: Individual product references with pricing, offers, and rendering hints for inline display
  • Entity extraction: Identifies and extracts named entities like products, brands, and concepts mentioned in responses
  • Map entries: Extracts business and place information including ratings, reviews, contact details, and location data
  • Citation pills: Captures inline citations with metadata including labels, descriptions, domains, and publication dates
  • Ads: Extracts structured ad information including advertiser branding and product carousel cards
  • Raw response access: Includes the full streaming response payload for debugging
  • Query fan-out insights: Reveals the query fan-out ChatGPT used to generate responses

​
Request parameters

Uses common parameters. All ChatGPT-specific include.* flags are listed in the auto-generated request schema below.
Additional credit costEnabling any of include.rawResponse, include.searchQueries, include.ads, or include.shopping (or any combination) adds +2 credits to the base cost.

​
Response objects

The response includes the following sections. See each subpage for the full schema and examples.
SectionDescription
SourcesSource citations with publication dates and footnote indicators
Shopping cardsStructured product information with pricing, ratings, and offers
Inline productsIndividual product references with rationale and themed reviews
EntitiesNamed entities like products, brands, and concepts
Map entriesBusiness and place information from Yelp and Google
Citation pillsInline citations with rich metadata
AdsAdvertiser branding and product carousel cards

​
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.adsarrayArray of ads displayed in ChatGPT response (included when include.ads is true)
result.shoppingCardsarrayArray of shopping/product cards extracted from response (included when include.shopping is true)
result.inlineProductsarrayArray of inline products with pricing and offers (included when include.shopping is true)
result.entitiesarrayArray of entities extracted from response (when available)
result.maparrayArray of business/place map entries extracted from response (when available)
result.citationPillsarrayArray of inline citation pills extracted from response (when available)
result.sourcesarrayArray of sources referenced in the response. See Sources for ChatGPT-specific fields
result.modelstringThe ChatGPT model used to generate the response

​
Common questions

​
Can I get the search queries that ChatGPT uses?

Yes, you can get the actual search queries (fan-out queries) that ChatGPT uses internally by setting include.searchQueries: true in your ChatGPT requests.

​
Are query fan-outs available for all ChatGPT responses?

ChatGPT uses gpt-5-3 and gpt-5-3-mini that include fan-out queries; newer models may not include explicit fan-outs. ChatGPT automatically selects which model to use for each request, so we cannot control the presence of query fan-outs.

​
Are query fan-outs available for other providers?

For a complete comparison of query fan-out support across all providers, see the Providers & pricing guide.

​
Why is a fan-out query a single long string instead of separated keywords?

This is expected behaviour. ChatGPT’s search model decides the shape of each fan-out query, and it often emits a single long natural-language query rather than a comma-separated keyword list. The length and structure vary between runs, even for the same prompt, and cloro returns the queries exactly as ChatGPT generates them without reformatting. Community write-ups such as this LinkedIn post by Stefan Landwehr document the same behaviour.

​
Why aren’t shopping cards appearing in my responses?

Shopping cards only appear when the prompt is related to products or shopping: 
# ✅ Good - shopping related
"best laptops under $1000"
"compare iPhone vs Samsung"
"top rated headphones 2026"

# ❌ Bad - not shopping related
"what is the capital of France"
"how does photosynthesis work"
Not all shopping queries will return shopping cards. It depends on what ChatGPT finds and how it formats the response.

​
Which providers support shopping cards?

For a complete comparison of shopping card support across all providers, see the Providers & pricing guide.

​
What’s the difference between shopping cards and inline products?

Shopping cards are grouped collections of products displayed together (like a carousel):
  • Contain multiple products
  • Include category tags
  • For browsing multiple options
Inline products are individual product references:
  • Single product per entry
  • Include pricing, offers, images, and ratings
  • Can be embedded inline in text, comparison tables, or featured displays
  • Have rendering hints (inline, hero, block)
Both are extracted only when include.shopping: true is set in the request.

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

Country/region code for localized response

Example:

"US"

​
include
object

Optional flags for including additional response formats

Example:
{
  "html": true,
  "markdown": true,
  "rawResponse": true,
  "searchQueries": true,
  "ads": true,
  "shopping": true
}

Response

successful ChatGPT monitoring response

​
success
boolean
required
Example:

true

​
result
object
required

ChatGPT's response data