Product Offers Schema

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:

string

Merchant name (e.g., "Example Store").

string

Product name as listed by the merchant.

string

Offer URL with ChatGPT attribution.

string

Offer price (e.g., "$57.00").

string

Stock and delivery information (e.g., "In stock, ships in 2-3 days").

boolean

Offer availability status. true if the product is available, false otherwise.

boolean

Whether the offer can be checked out directly. true if direct checkout is available, false otherwise.

object

Detailed price breakdown object containing:

Show properties

string

Base price before additional fees or discounts.

string

Total price including all fees and discounts.

object

Promotional tag object (e.g., “Best price” badge) containing:

Show properties

string

Tag text (e.g., "Best price").

string

Tag type (e.g., "promotion").

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

Endpoints

Response Schema

Overview

Offer Fields

Example Offer

Multiple Offers Example

Use Cases

Offer Features

Next Steps

Shopping Cards Schema

Response Structure

​Overview

​Offer Fields

​Example Offer

​Multiple Offers Example

​Use Cases

​Offer Features

​Next Steps

Shopping Cards Schema

Response Structure

Overview

Offer Fields

Example Offer

Multiple Offers Example

Use Cases

Offer Features

Next Steps