Skip to main content

​
Overview

Each product in a shopping card can have multiple offers from different merchants. The offers array contains detailed information about each merchant’s offer, including pricing, availability, and promotional tags.

​
Offer Fields

Each offer object in the products[].offers[] array contains the following fields:
​
merchant_name
string
Merchant name (e.g., "Example Store").
​
product_name
string
Product name as listed by the merchant.
​
url
string
Offer URL with ChatGPT attribution.
​
price
string
Offer price (e.g., "$57.00").
​
details
string
Stock and delivery information (e.g., "In stock, ships in 2-3 days").
​
available
boolean
Offer availability status. true if the product is available, false otherwise.
​
checkoutable
boolean
Whether the offer can be checked out directly. true if direct checkout is available, false otherwise.
​
price_details
object
Detailed price breakdown object containing:
​
tag
object
Promotional tag object (e.g., “Best price” badge) containing:

​
Example Offer

{
  "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"
  }
}

​
Multiple Offers Example

A product can have multiple offers from different merchants: 
{
  "title": "Example Product",
  "price": "$57.00",
  "offers": [
    {
      "merchant_name": "Example Store",
      "price": "$57.00",
      "available": true,
      "tag": {
        "text": "Best price",
        "type": "promotion"
      }
    },
    {
      "merchant_name": "Another Retailer",
      "price": "$62.99",
      "available": true,
      "tag": {
        "text": "Free shipping",
        "type": "promotion"
      }
    },
    {
      "merchant_name": "Third Store",
      "price": "$59.50",
      "available": false,
      "details": "Out of stock"
    }
  ]
}

​
Use Cases

  • Price comparison: Compare prices across different merchants for the same product
  • Availability tracking: Monitor which merchants have the product in stock
  • Promotional monitoring: Identify special offers and promotional deals
  • Checkout optimization: Find merchants that support direct checkout
  • Shipping analysis: Track delivery information and shipping times

​
Offer Features

  • Price breakdown: Separate base and total pricing for transparency
  • Stock information: Real-time availability status and delivery details
  • Promotional tags: Identify special offers like “Best price” or “Free shipping”
  • Direct checkout: Know which offers support immediate purchase
  • Merchant information: Track which retailers are offering the product

​
Next Steps

Shopping Cards Schema

Back to shopping card structure

Response Structure

View all response fields

Build docs developers (and LLMs) love

Get started for freeTalk to us