Technical Documentation

Product Feed Specification

Complete guide to creating an Agent Commerce Protocol (ACP) ready product feed. Learn the required fields, AI optimization strategies, and best practices for maximum discoverability across ChatGPT, Perplexity, Claude, and Google AI.

Official Reference: This guide is based on the ACP Product Feed Specification. For the most up-to-date technical details, always refer to the official ACP documentation.

1. Overview & Requirements 2. Core Product Fields 3. AI Optimization Fields 4. Technical Specifications 5. Media & Assets 6. Policies & Compliance 7. Feed Formats 8. Validation & Testing

1. Overview & Requirements

Why ACP-Ready Feeds Matter

Traditional product feeds optimized for Google Shopping fail on AI platforms. AI agents need context-rich, conversational data to understand products and recommend them effectively. An ACP-ready feed increases your product discoverability by 3.2x across AI platforms.

Key Principles

Structured Product Data:Provide product information in a structured format that AI agents can easily parse and understand

Real-Time Accuracy:Keep pricing, availability, and product details synchronized in real-time

High-Quality Assets:Include multiple high-resolution images and detailed descriptions

API-First Approach:Expose product data through RESTful API endpoints for seamless integration

Delivery Method

RESTful API Endpoint (Required)

ACP requires you to expose your product catalog via a RESTful API endpoint that returns JSON data. This allows AI platforms to fetch real-time product information.

GET https://yourdomain.com/api/products

Supported Formats

JSON API (Required)

Primary format for ACP. Your API endpoint must return product data in JSON format

CSV (Reference)

Can be used internally to generate your JSON API, but not accepted directly by ACP

2. Core Product Fields

Field Name	Type	Required	Description	Example
`id`	String	Required	Unique product identifier	`prod_12345`
`name`	String	Required	Product name	Organic Coffee Beans
`description`	String	Required	Detailed product description	Premium single-origin organic coffee beans
`price`	Integer	Required	Price in minor currency units (e.g., cents)	`2999`
`currency`	String	Required	ISO 4217 currency code (lowercase)	`usd`
`availability`	Enum	Required	in_stock \| out_of_stock \| preorder \| backorder	`in_stock`
`condition`	Enum	Required	new \| refurbished \| used	`new`
`brand`	String	Recommended	Product brand or manufacturer name	AudioTech
`category`	String	Recommended	Google Product Category or custom taxonomy	Electronics > Audio > Headphones
`images`	Array	Required	Array of product image URLs (HTTPS)	["https://example.com/img.jpg"]
`product_url`	URL	Required	Direct link to product page (HTTPS)	https://example.com/product
`gtin`	String	Recommended	Global Trade Item Number (UPC, EAN, ISBN)	`0123456789012`
`mpn`	String	Optional	Manufacturer Part Number	`WH-1000XM5`

3. AI Optimization Fields

Critical for AI Discovery

These fields dramatically improve how AI agents understand and recommend your products. Products with complete AI optimization fields see 4.5x higher conversion rates on AI platforms.

`ai_description`

Highly Recommended

Type: String (500-1000 characters)
Purpose: Conversational, context-rich product description optimized for AI understanding

✅ Good Example:

"Experience immersive audio with our flagship wireless headphones featuring industry-leading active noise cancellation technology. Perfect for travel, work, or relaxation. The 30-hour battery life means you can go days without charging, and quick charge gives you 5 hours of playback in just 10 minutes. Comfortable memory foam cushions make these ideal for all-day wear, whether you're on a long flight or in back-to-back video calls."

❌ Bad Example:

"Wireless headphones. Noise cancelling. Bluetooth 5.2. 30hr battery. Buy now!"

`use_cases`

Highly Recommended

Type: Array of strings (5-10 use cases)
Purpose: Specific scenarios where customers would use this product

Examples:

•Travel companion for frequent flyers
•Focus tool for remote workers in noisy environments
•Premium audio for music enthusiasts and audiophiles
•Gaming immersion with spatial audio support
•Meditation and relaxation sessions

`target_audience`

Recommended

Type: Array of strings (3-7 audience segments)
Purpose: Who this product is designed for

Examples:

•Professionals working from home
•Frequent business and leisure travelers
•Audiophiles seeking premium sound quality
•Content creators and podcasters
•Students in shared living spaces

`key_features`

Highly Recommended

Type: Array of strings (5-12 features)
Purpose: Standout features that differentiate this product

Examples:

•Industry-leading Active Noise Cancellation (ANC)
•30-hour battery life on single charge
•Quick charge: 10 minutes = 5 hours playback
•Multi-point Bluetooth connection (2 devices)
•Intuitive touch controls for music and calls

`conversational_queries`

Recommended

Type: Array of strings (5-15 queries)
Purpose: Natural language queries that should surface this product

Examples:

•best headphones for working from home
•noise cancelling headphones for travel
•wireless headphones with long battery life
•comfortable headphones for all-day wear
•headphones for video calls and music

4. Technical Specifications

Detailed technical specifications help AI agents answer specific customer questions and make accurate comparisons between products.

Field Name	Type	Description	Example
`specifications`	Object	Structured technical specifications	See nested structure below
`compatibility`	Object/Array	Compatible devices, platforms, systems	iOS, Android, Windows, macOS
`material`	String	Materials used in construction	Memory foam, aluminum, vegan leather
`dimensions`	String	Product dimensions with units	7.3 x 3.0 x 9.9 inches
`weight`	String	Product weight with units	8.8 oz (250g)
`color_options`	Array	Available color variants	Black, Silver, Blue
`size_options`	Array	Available size variants	S, M, L, XL
`care_instructions`	String	How to care for and maintain the product	Wipe clean with soft dry cloth
`warranty_info`	String/Object	Warranty coverage details	2-year manufacturer warranty

5. Media & Assets

High-quality media assets significantly improve product presentation and conversion rates on AI platforms.

Image Requirements

Primary Image

Minimum resolution: 800x800px
Recommended: 1200x1200px or higher
Format: JPG, PNG, WebP
White or transparent background preferred
Product should fill 80-90% of frame

Additional Images

3-8 additional images recommended
Show different angles and details
Include lifestyle/in-use images
Show scale/size comparison
Display key features visually

Video Content (Optional but Recommended)

15-60 second product demonstration or unboxing
Format: MP4, WebM, MOV
Resolution: 1080p minimum
Include captions for accessibility

6. Policies & Compliance

Clear policies build trust and reduce friction in the AI shopping experience. These fields are increasingly important for AI platforms.

`shipping_info`

Detailed shipping information including costs, timeframes, and restrictions

{
  "shipping_info": {
    "free_shipping_threshold": 50,
    "processing_time": "1-2 business days",
    "standard_shipping": "3-5 business days",
    "express_available": true,
    "express_shipping": "1-2 business days",
    "international_shipping": true,
    "restrictions": ["PO Boxes require standard shipping"]
  }
}

`return_policy`

Return and refund policy details

{
  "return_policy": {
    "return_window": "30 days",
    "free_returns": true,
    "refund_type": "Full refund",
    "conditions": "Product must be unopened and in original packaging",
    "restocking_fee": 0
  }
}

`sustainability_info`

Environmental and sustainability credentials (increasingly important for AI recommendations)

{
  "sustainability_info": {
    "carbon_neutral_shipping": true,
    "recyclable_packaging": true,
    "eco_friendly_materials": true,
    "certifications": ["CE certified", "RoHS compliant"],
    "manufacturing": "Energy-efficient manufacturing process"
  }
}

7. Feed Formats & Examples

CSV Format

id,name,description,price,currency,availability,images
"prod_12345","Organic Coffee Beans","Premium single-origin organic coffee beans","2999","usd","in_stock","https://example.com/coffee-1.jpg|https://example.com/coffee-2.jpg"
"prod_67890","Wireless Headphones","Premium noise-cancelling headphones with 30-hour battery","29999","usd","in_stock","https://example.com/headphones-1.jpg|https://example.com/headphones-2.jpg"

JSON Format (Recommended)

{
  "products": [
    {
      "id": "prod_12345",
      "name": "Organic Coffee Beans",
      "description": "Premium single-origin organic coffee beans sourced from sustainable farms in Colombia. Rich, smooth flavor with notes of chocolate and caramel. Perfect for pour-over, French press, or espresso.",
      "price": 2999,
      "currency": "usd",
      "availability": "in_stock",
      "images": [
        "https://example.com/coffee-1.jpg",
        "https://example.com/coffee-2.jpg",
        "https://example.com/coffee-3.jpg"
      ]
    },
    {
      "id": "prod_67890",
      "name": "Wireless Noise-Cancelling Headphones",
      "description": "Premium over-ear headphones with industry-leading active noise cancellation. 30-hour battery life, quick charge support, and comfortable memory foam cushions. Ideal for travel, work, and music listening.",
      "price": 29999,
      "currency": "usd",
      "availability": "in_stock",
      "images": [
        "https://example.com/headphones-1.jpg",
        "https://example.com/headphones-2.jpg",
        "https://example.com/headphones-3.jpg"
      ]
    }
  ]
}

8. Validation & Testing

Pre-Launch Checklist

All required fields are populated for every productAI descriptions are conversational and context-rich (500+ characters)Use cases cover 5+ realistic customer scenariosAll images are high-resolution (1200x1200px+) and HTTPSPrices and availability are accurate and up-to-dateProduct URLs lead directly to product pages (no redirects)Shipping and return policies are clearly definedFeed is accessible via HTTPS URLFeed updates automatically (at least daily)

Common Validation Errors

Missing Required Fields:

Ensure id, title, description, price, currency, availability, image_url, and product_url are present for all products

Invalid Image URLs:

All image URLs must be HTTPS and return valid image files (not 404 errors)

Keyword-Stuffed Descriptions:

AI platforms penalize unnatural, keyword-stuffed content. Write naturally

Incorrect Price Format:

Use numeric values only (299.99, not "$299.99" or "299.99 USD")

Need Help?

Our platform automatically validates your feed and provides detailed error reports. We also offer feed optimization services to maximize your AI discoverability.

Join Waitlist for Feed Validation

Ready to make your products AI-ready?

Join our platform to automatically optimize your product feed for AI commerce

Get Started

Product Feed Specification

Table of Contents

1. Overview & Requirements

Why ACP-Ready Feeds Matter

Key Principles

Delivery Method

RESTful API Endpoint (Required)

Supported Formats

JSON API (Required)

CSV (Reference)

2. Core Product Fields

3. AI Optimization Fields

Critical for AI Discovery

ai_description

use_cases

target_audience

key_features

conversational_queries

4. Technical Specifications

5. Media & Assets

Image Requirements

Primary Image

Additional Images

Video Content (Optional but Recommended)

6. Policies & Compliance

shipping_info

return_policy

sustainability_info

7. Feed Formats & Examples

CSV Format

JSON Format (Recommended)

8. Validation & Testing

Pre-Launch Checklist

Common Validation Errors

Need Help?

Ready to make your products AI-ready?

`ai_description`

`use_cases`

`target_audience`

`key_features`

`conversational_queries`

`shipping_info`

`return_policy`

`sustainability_info`