---
name: deal-api
description: "Deal API skill. Use when working with Deal for deal_item, event, event_item. Covers 4 endpoints."
version: 1.0.0
generator: lapsh
---

# Deal API
API version: v1.3.0

## Auth
OAuth2

## Base URL
https://api.ebay.com/buy/deal/v1

## Setup
1. Configure auth: OAuth2
2. GET /deal_item -- this method retrieves a paginated set of deal items. the result set contains all deal items associated with the specified search criteria and marketplace id.restrictionsthis method can return a maximum of 10,000 items. for a list of supported sites and other restrictions, see api restrictions.ebay partner network:  in order to receive a commission for your sales, you must use the url returned in the itemaffiliateweburl field to forward your buyer to the ebay.com site.
3. Explore available endpoints below

## Endpoints
4 endpoints across 3 groups. See references/api-spec.lap for full details.

### Deal_item
| Method | Path | Description |
|--------|------|-------------|
| GET | /deal_item | This method retrieves a paginated set of deal items. The result set contains all deal items associated with the specified search criteria and marketplace ID.RestrictionsThis method can return a maximum of 10,000 items. For a list of supported sites and other restrictions, see API Restrictions.eBay Partner Network:  In order to receive a commission for your sales, you must use the URL returned in the itemAffiliateWebUrl field to forward your buyer to the ebay.com site. |

### Event
| Method | Path | Description |
|--------|------|-------------|
| GET | /event/{event_id} | This method retrieves the details for an eBay event. The result set contains detailed information associated with the specified event ID, such as applicable coupons, start and end dates, and event terms.Restrictions This method can return a maximum of 10,000 items. For a list of supported sites and other restrictions, see API Restrictions.eBay Partner Network:  In order to receive a commission for your sales, you must use the URL returned in the itemAffiliateWebUrl field to forward your buyer to the ebay.com site. |
| GET | /event | This method returns paginated results containing all eBay events for the specified marketplace.Restrictions This method can return a maximum of 10,000 items. For a list of supported sites and other restrictions, see API Restrictions.eBay Partner Network:  In order to receive a commission for your sales, you must use the URL returned in the itemAffiliateWebUrl field to forward your buyer to the ebay.com site. |

### Event_item
| Method | Path | Description |
|--------|------|-------------|
| GET | /event_item | This method returns a paginated set of event items. The result set contains all event items associated with the specified search criteria and marketplace ID.Restrictions This method can return a maximum of 10,000 items. For a list of supported sites and other restrictions, see API Restrictions.eBay Partner Network:  In order to receive a commission for your sales, you must use the URL returned in the itemAffiliateWebUrl field to forward your buyer to the ebay.com site. |

## Common Questions
Match user requests to endpoints in references/api-spec.lap. Key patterns:
- "List all deal_item?" -> GET /deal_item
- "Get event details?" -> GET /event/{event_id}
- "List all event?" -> GET /event
- "List all event_item?" -> GET /event_item
- "How to authenticate?" -> See Auth section above

## Response Tips
- Check response schemas in references/api-spec.lap for field details
- Paginated endpoints accept limit/offset or cursor parameters
- Error responses include status codes and descriptions in the spec

## References
- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

> Generated from the official API spec by [LAP](https://lap.sh)