Product Feed Specification
Define how merchants share structured product data with AI agents for discovery and purchase.
Delivery Format
| Format | Extension | Description |
|---|---|---|
| JSON Lines | .jsonl.gz | One JSON object per line, gzip compressed |
| CSV | .csv.gz | Comma-separated values, gzip compressed |
Update frequency: Up to every 15 minutes.
Required Fields
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier (max 100 chars) |
title | string | Product name (max 150 chars) |
description | string | Full description (max 5000 chars) |
link | URL | Product page URL |
image_link | URL | Main image (JPEG/PNG) |
price | string | Price with currency (“29.99 USD”) |
availability | enum | in_stock, out_of_stock, preorder |
enable_search | bool | Allow AI discovery |
enable_checkout | bool | Allow direct purchase |
Example
{
"id": "SKU001",
"title": "Nike Air Max 90",
"description": "Classic running shoe with visible Air cushioning.",
"link": "https://example.com/products/nike-air-max-90",
"image_link": "https://example.com/images/air-max-90.jpg",
"price": "129.99 USD",
"availability": "in_stock",
"enable_search": true,
"enable_checkout": true,
"brand": "Nike",
"product_category": "Apparel > Shoes > Athletic",
"seller_privacy_policy": "https://example.com/privacy",
"seller_tos": "https://example.com/terms"
}Recommended Fields
| Field | Type | Description |
|---|---|---|
brand | string | Product brand |
gtin | string | Universal product code |
product_category | string | Category path using ”>“ |
product_review_count | int | Number of reviews |
product_review_rating | float | Average rating (0-5) |
seller_privacy_policy | URL | Required for checkout |
seller_tos | URL | Required for checkout |
Prohibited Content
đźš«
Not allowed: adult content, weapons, prescription medications, illegal goods, counterfeit products.