# Deal API API

> Deal API API on Apizie: 4 endpoints (This method retrieves a paginated set of deal items. The result set contains all deal items associated with…, This method returns paginated results containing all eBay events for the specified marketplace. Request…, This method retrieves the details for an eBay event. The result set contains detailed information associated…, This method returns a paginated set of event items. The result set contains all event items associated with…) 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-deal/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Note: This is a (Limited Release) API available only to select developers approved by business units. This API allows third-party developers to search for and retrieve details about eBay deals and events, as well as…

## Endpoints

### This method retrieves a paginated set of deal items. The result set contains all deal items associated with…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-deal/get-deal-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category_ids | string | no | The unique identifier of the eBay category for the search. |
| commissionable | string | no | A filter for commissionable deals. Restriction: This filter is currently only supported for the US marketplace. |
| delivery_country | string | no | A filter for items that can be shipped to the specified country. |
| limit | string | no | The maximum number of items, from the current result set, returned on a single page. |
| offset | string | no | The number of items that will be skipped in the result set. This is used with the limit field to control the pagination of the output. For… |
| X-EBAY-C-MARKETPLACE-ID | string | yes | A header used to specify the eBay marketplace ID. |

### This method returns paginated results containing all eBay events for the specified marketplace. Request…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-deal/get-events` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | string | no | The maximum number of items, from the current result set, returned on a single page. Default: 20 Maximum Value: 100 |
| offset | string | no | The number of items that will be skipped in the result set. This is used with the limit field to control the pagination of the output. For… |
| X-EBAY-C-MARKETPLACE-ID | string | yes | A header used to specify the eBay marketplace ID. |

### This method retrieves the details for an eBay event. The result set contains detailed information associated…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-deal/get-event` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-EBAY-C-MARKETPLACE-ID | string | yes | A header used to specify the eBay marketplace ID. |
| event_id | string | yes | The unique identifier for the eBay event. |

### This method returns a paginated set of event items. The result set contains all event items associated with…
`GET https://apizie.tech/v1/ecommerce:ebay-buy-deal/get-event-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| category_ids | string | no | The unique identifier of the eBay category for the search. Maximum Value: 1 |
| delivery_country | string | no | A filter for items that can be shipped to the specified country. |
| event_ids | string | yes | The unique identifiers for the eBay events. Maximum Value: 1 |
| limit | string | no | The maximum number of items, from the current result set, returned on a single page. Default: 20 |
| offset | string | no | The number of items that will be skipped in the result set. This is used with the limit field to control the pagination of the output. For… |
| X-EBAY-C-MARKETPLACE-ID | string | yes | A header used to specify the eBay marketplace ID. |

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

## FAQ

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

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

### Can AI agents use the Deal API 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-deal.

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