# Item Feed Service API

> Item Feed Service API on Apizie: 4 endpoints (This method lets you download a TSV_GZIP (tab separated value gzip) Item feed file. The feed file contains…, This method lets you download a TSV_GZIP (tab separated value gzip) Item Group feed file. An item group is…, Using this method, you can download a TSV_GZIP (tab separated value gzip) Item Priority feed file, which…, The Hourly Snapshot feed file is generated each hour every day for most categories. This method lets you…) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/ecommerce:ebay-buy-feed/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ecommerce:ebay-buy-feed`
- Category: E-commerce
- Status: byok
- Source: https://ebay.com
- Page: https://apizie.tech/api/ecommerce/ebay-buy-feed
- OpenAPI: https://apizie.tech/api/ecommerce/ebay-buy-feed/openapi.json

Note: This is a (Limited Release) API available only to select developers approved by business units. For information on how to obtain access to this API in production, see the Buy APIs Requirements . The Feed API…

## Endpoints

### This method lets you download a TSV_GZIP (tab separated value gzip) Item feed file. The feed file contains…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-feed/get-item-feed` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-EBAY-C-MARKETPLACE-ID | string | yes | The ID of the eBay marketplace where the item is hosted. Note: This value is case sensitive. For example: &nbsp;&nbsp;… |
| Range | string | yes | This header specifies the range in bytes of the chunks of the gzip file being returned. Format: bytes= startpos - endpos For example, the… |
| feed_scope | string | yes | Specifies the type of feed file to return. Valid Values: NEWLY_LISTED - Returns the daily Item feed file containing all Good 'Til… |
| category_id | string | yes | An eBay top-level category ID of the items to be returned in the feed file. The list of eBay category IDs changes over time and category… |
| date | string | no | The date of the daily Item feed file ( feed_scope = NEWLY_LISTED ) you want. The date is required only for the daily Item feed file. If… |

### This method lets you download a TSV_GZIP (tab separated value gzip) Item Group feed file. An item group is…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-feed/get-item-group-feed` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-EBAY-C-MARKETPLACE-ID | string | yes | The ID of the eBay marketplace where the item is hosted. Note: This value is case sensitive. For example: &nbsp;&nbsp;… |
| Range | string | no | This header specifies the range in bytes of the chunks of the gzip file being returned. Format: bytes= startpos - endpos For example, the… |
| feed_scope | string | yes | Specifies the type of file to return. Valid Values: NEWLY_LISTED - Returns the Item Group feed file containing the item group variation… |
| category_id | string | yes | An eBay top-level category ID of the items to be returned in the feed file. The list of eBay category IDs changes over time and category… |
| date | string | no | The date of the daily Item Group feed file ( feed_scope = NEWLY_LISTED ) you want. The date is required only for the daily Item Group feed… |

### Using this method, you can download a TSV_GZIP (tab separated value gzip) Item Priority feed file, which…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-feed/get-item-priority-feed` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-EBAY-C-MARKETPLACE-ID | string | yes | The ID of the eBay marketplace where the item is hosted. Note: This value is case sensitive. For example: &nbsp;&nbsp;… |
| Range | string | yes | Header specifying content range to be retrieved. Only supported range is bytes. Example : bytes = 0-102400 . |
| category_id | string | yes | An eBay top-level category ID of the items to be returned in the feed file. The list of eBay category IDs changes over time and category… |
| date | string | yes | The date of the feed you want returned. This can be up to 14 days in the past but cannot be set to a date in the future. Format: yyyyMMdd… |

### The Hourly Snapshot feed file is generated each hour every day for most categories. This method lets you…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-feed/get-item-snapshot-feed` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-EBAY-C-MARKETPLACE-ID | string | yes | The ID of the eBay marketplace where the item is hosted. Note: This value is case sensitive. For example: &nbsp;&nbsp;… |
| Range | string | yes | This header specifies the range in bytes of the chunks of the gzip file being returned. Format: bytes= startpos - endpos For example, the… |
| category_id | string | yes | An eBay top-level category ID of the items to be returned in the feed file. The list of eBay category IDs changes over time and category… |
| snapshot_date | string | yes | The date and hour of the snapshot feed file you want. Each file contains the items that changed within the hour in the specified category.… |

## Example
```
curl "https://apizie.tech/v1/ecommerce:ebay-buy-feed/get-item-feed" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Item Feed Service API?
Create a free Apizie key, then send GET https://apizie.tech/v1/ecommerce:ebay-buy-feed/get-item-feed with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Item Feed Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Item Feed Service itself also needs your own key from ebay.com.

### Can AI agents use the Item Feed Service API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ecommerce:ebay-buy-feed.

### What is the status of the Item Feed Service API?
Needs your own provider key (bring your own key)
