Specification
Product Feed Specification

Product Feed Specification

The Product Feed specification defines how merchants share structured product data with OpenAI so ChatGPT can accurately display products in search and shopping experiences.

📊 Supported Data Formats

Supported File Formats

  • TSV (Tab-Separated Values) - Recommended
  • CSV (Comma-Separated Values)
  • XML (Extensible Markup Language)
  • JSON (JavaScript Object Notation)

File Requirements

  • Encoding: UTF-8
  • Maximum File Size: 10GB
  • Compression: gzip compression supported
  • Update Frequency: Up to every 15 minutes

🏷️ Required Fields

Product Identification 

{
  "id": "prod_12345",                    // Unique product identifier
  "title": "Organic Single-Origin Coffee Beans",         // Product name
  "description": "Premium Ethiopian single-origin coffee beans, hand-roasted, rich and aromatic" // Product description
}

Pricing Information 

{
  "price": "29.99",                      // Current price
  "currency": "USD",                     // Currency code (ISO 4217)
  "sale_price": "24.99",                 // Sale price (optional)
  "availability": "in_stock"             // Stock status
}

Media Assets 

{
  "image_url": "https://example.com/coffee-main.jpg",     // Main product image
  "additional_images": [                                   // Additional images
    "https://example.com/coffee-detail1.jpg",
    "https://example.com/coffee-detail2.jpg"
  ]
}

📋 Recommended Fields

Product Categories 

{
  "category": "Food & Beverages > Coffee > Coffee Beans",
  "brand": "Mountain Peak Coffee",
  "product_type": "Coffee Beans",
  "tags": ["organic", "single-origin", "hand-roasted"]
}

Detailed Attributes 

{
  "weight": "500g",
  "origin": "Ethiopia",
  "roast_level": "Medium Roast",
  "flavor_notes": ["chocolate", "nuts", "citrus"],
  "material": "Arabica Coffee Beans",
  "certification": ["Organic Certified", "Fair Trade"]
}

Shipping Information 

{
  "shipping_weight": "600g",             // Packaged weight
  "shipping_dimensions": "15x10x5cm",    // Package dimensions
  "shipping_cost": "8.00",               // Shipping cost
  "free_shipping_threshold": "99.00",    // Free shipping threshold
  "estimated_delivery": "1-3 business days"       // Estimated delivery time
}

🔄 Update Mechanisms

Real-time Updates

Support high-frequency product data updates:

POST /feed/update
Content-Type: application/json

{
  "timestamp": "2025-01-15T10:30:00Z",
  "updates": [
    {
      "id": "prod_12345",
      "availability": "out_of_stock",
      "price": "32.99"
    }
  ]
}

Incremental Updates

Only transmit changed product data:

{
  "update_type": "incremental",
  "since": "2025-01-15T10:00:00Z",
  "products": [
    {
      "id": "prod_12345",
      "action": "update",
      "fields": {
        "price": "32.99",
        "availability": "in_stock"
      }
    },
    {
      "id": "prod_67890", 
      "action": "delete"
    }
  ]
}

🔒 Security Requirements

HTTPS Connection

All product feeds must be provided through encrypted HTTPS connections:

GET https://merchant.example.com/feed/products.json
Authorization: Bearer your_api_token
User-Agent: OpenAI-Commerce/1.0

Access Control 

{
  "access_control": {
    "api_key": "required",
    "ip_whitelist": ["openai_ip_ranges"],
    "rate_limit": "1000_requests_per_minute"
  }
}

📈 Optimization Best Practices

Product Title Optimization

  • Length: 50-150 characters
  • Keywords: Include important search keywords
  • Brand: Include brand name in appropriate position
  • Specifications: Include important product specifications

Example Comparison 

❌ Poor: "Coffee Beans"
✅ Good: "Mountain Peak Coffee Organic Ethiopian Single-Origin Arabica Coffee Beans Medium Roast 500g"

Product Description Optimization

  • Length: 200-500 characters
  • Features: Highlight unique selling points
  • Usage: Explain use cases and methods
  • Specifications: Detailed technical specifications

Image Quality Standards

  • Resolution: At least 800x800 pixels
  • Format: JPEG, PNG, WebP
  • Background: Pure white or transparent background
  • Angles: Multi-angle product detail display

📊 Data Validation

Format Validation 

# Use official validation tool
curl -X POST https://validator.agenticcommerce.pro/feed \
  -H "Content-Type: application/json" \
  -d @your_feed.json

Common Errors 

{
  "errors": [
    {
      "field": "price",
      "message": "Price must be in valid numeric format",
      "product_id": "prod_12345"
    },
    {
      "field": "image_url", 
      "message": "Image URL is not accessible",
      "product_id": "prod_67890"
    }
  ]
}

🔧 Integration Examples

Complete JSON Format Example 

{
  "feed_info": {
    "version": "1.0",
    "generated_at": "2025-01-15T10:30:00Z",
    "total_products": 1250
  },
  "products": [
    {
      "id": "coffee_beans_001",
      "title": "Mountain Peak Coffee Organic Ethiopian Single-Origin Arabica Coffee Beans",
      "description": "Premium Ethiopian Sidamo region Arabica coffee beans, grown at 1800-2200m altitude, hand-picked, sun-dried, medium roasted, featuring rich floral and fruity aromas with a smooth, sweet taste.",
      "price": "29.99",
      "currency": "USD",
      "sale_price": "24.99",
      "availability": "in_stock",
      "stock_quantity": 150,
      "category": "Food & Beverages > Coffee > Coffee Beans",
      "brand": "Mountain Peak Coffee",
      "weight": "500g",
      "origin": "Ethiopia",
      "roast_level": "Medium Roast",
      "flavor_notes": ["floral", "fruity", "chocolate"],
      "certification": ["Organic Certified", "Fair Trade"],
      "image_url": "https://merchant.com/images/coffee_beans_001_main.jpg",
      "additional_images": [
        "https://merchant.com/images/coffee_beans_001_detail1.jpg",
        "https://merchant.com/images/coffee_beans_001_package.jpg"
      ],
      "shipping_weight": "600g",
      "shipping_cost": "8.00",
      "free_shipping_threshold": "99.00",
      "estimated_delivery": "1-3 business days",
      "reviews": {
        "average_rating": 4.8,
        "review_count": 156
      },
      "seo": {
        "keywords": ["organic coffee beans", "ethiopian coffee", "single origin"],
        "meta_description": "Premium organic Ethiopian coffee beans with rich floral and fruity aromas"
      }
    }
  ]
}

Performance Optimization 

{
  "compression": "gzip",
  "caching": {
    "cache_control": "max-age=900",  // 15-minute cache
    "etag": "feed_version_123"
  },
  "cdn": {
    "enabled": true,
    "regions": ["us-east", "eu-west", "asia-pacific"]
  }
}

📞 Technical Support

Integration Support

Community Resources

By correctly implementing the Product Feed specification, your products will achieve optimal display and user discovery rates in ChatGPT.

SpecificationAgentic Checkout Specification