Skip to main content

Overview

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 at no extra cost.

Shopping Cards Array

The result.shoppingCards field contains an array of shopping card objects. Each shopping card represents a group of related products.
tags
array
Category tags for the shopping card (e.g., ["electronics", "deals"]).
products
array
Array of product information objects. See Product Fields below for detailed structure.

Product Fields

Each product object in the products array contains the following fields:
title
string
Product name.
url
string
Product page URL with ChatGPT attribution.
price
string
Current price (e.g., "$57.00").
Product category or style tag.
merchant
string
Merchant information (e.g., "Example Store + others").
imageUrls
array
Array of product image URLs.
rating
float
Product rating on a 0-5 scale.
numReviews
integer
Number of reviews.
id
string
Unique product identifier.
offers
array
Array of shopping offers from different merchants. See Offers Schema for detailed structure.
rating_grouped_citation
object
Rating source information object containing:

Example Shopping Card

{
  "tags": ["electronics", "deals"],
  "products": [
    {
      "title": "Example Product",
      "url": "https://example.com/product",
      "price": "$57.00",
      "featured_tag": "electronics",
      "merchant": "Example Store + others",
      "imageUrls": ["https://example.com/image.jpg"],
      "rating": 4.5,
      "numReviews": 128,
      "id": "prod_123",
      "offers": [
        {
          "merchant_name": "Example Store",
          "product_name": "Example Product",
          "url": "https://example.com/offer",
          "price": "$57.00",
          "details": "In stock, ships in 2-3 days",
          "available": true,
          "checkoutable": true,
          "price_details": {
            "base": "$57.00",
            "total": "$57.00"
          },
          "tag": {
            "text": "Best price",
            "type": "promotion"
          }
        }
      ],
      "rating_grouped_citation": {
        "title": "Product Reviews",
        "url": "https://example.com/reviews",
        "supporting_websites": ["example.com"]
      }
    }
  ]
}

Shopping Card Features

  • Comprehensive product data: Each shopping card includes product titles, prices, ratings, reviews, images, and merchant information
  • Multiple offers: Compare prices across different merchants for the same product
  • Rating citations: Track the source of product ratings and supporting websites
  • Promotional tags: Identify special offers like “Best price” or promotional deals
  • Stock information: Check product availability and delivery details

Use Cases

  • E-commerce monitoring: Track how ChatGPT surfaces and recommends products
  • Price comparison: Monitor pricing across different merchants and marketplaces
  • Product research: Extract structured product data for competitive analysis
  • Marketing intelligence: Understand which products ChatGPT highlights in responses

Next Steps

Offers Schema

Learn about product offer structure

Response Structure

Back to main response fields

Build docs developers (and LLMs) love