Skip to main content

  • Important: Due to EU & UK Payments regulatory requirements, an additional security verification via Digital Signatures is required for certain API calls that are made by EU/UK sellers. Please refer to Digital Signatures for APIs to learn more on the impacted APIs and the process to create signature to be included in the HTTP payload.

  • OpenAPI Specification - Version 2.0 for all of our RESTful APIs will no longer be available starting April 5, 2023. We will continue leveraging OpenAPI Specification - Version 3.0 for new features in our RESTful APIs.

Note: This is a Limited Release(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.

This API allows third-party developers to search for and retrieve details about eBay deals and events, as well as the items associated with those deals and events.

deal_item

Method NameHTTP MethodPathSummarySamples
getDealItemsGET/deal_itemThis method returns a paginated set of deal items. The result set contains all deal items associated with the specified search criteria and marketplace ID.View getDealItems - /deal_item

event

Method NameHTTP MethodPathSummarySamples
getEventGET/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.View getEvent - /event/{event_id}
getEventsGET/eventThis method returns paginated results containing all eBay events for the specified marketplace.View getEvents - /event

event_item

Method NameHTTP MethodPathSummarySamples
getEventItemsGET/event_itemThis method returns a paginated set of event items. The result set contains all event items associated with the specified search criteria and marketplace ID.View getEventItems - /event_item