The API lets you manage product feed data through three API surfaces:
- Feeds creates product feeds and retrieves feed metadata.
- Products retrieves products for a feed and upserts partial product changes.
- Promotions retrieves promotions for a feed and upserts partial promotion changes.
Use these APIs together when you want to create a feed, retrieve current data, and upsert product and promotion changes through API-based delivery instead of file upload.
REST endpoints
All API endpoints use the same request headers and response
headers. The Feeds, Products, and Promotions subtabs define the endpoint-
specific request and response bodies.
Request headers
| Field | Description | Example Value |
|---|---|---|
Authorization | API key used to make requests | Bearer api_key_123 |
Accept-Language | The preferred locale for content like messages and errors | en-US |
User-Agent | Information about the client making this request | ChatGPT/2.0 (Mac OS X 15.0.1; arm64; build 0) |
Idempotency-Key | Key used to ensure requests are idempotent | idempotency_key_123 |
Request-Id | Unique key for each request for tracing purposes | request_id_123 |
Content-Type | Type of request content | application/json |
Timestamp | Formatted as an RFC 3339 string | 2025-09-25T10:30:00Z |
API-Version | API version | 2025-09-12 |
Response headers
| Field | Description | Example Value |
|---|---|---|
Idempotency-Key | Idempotency key passed in the request | idempotency_key_123 |
Request-Id | Request ID passed in the request | request_id_123 |