Fetch the current eBay Daily Deals grid with sale price, was-price and shipping for a marketplace domain.

View all eBay Product Listings & Seller Data endpoints →

Returns the promoted discounts currently shown on the eBay Daily Deals page for one marketplace domain, with no search query required. The optional domain parameter selects one of 13 verified eBay sites (com, co.uk, de, com.au, ca, fr, it, es, nl, at, ch, ie, pl) and sets currency and local listings; the optional max_results parameter sets how many deal cards are returned, up to 240. The response uses an ok/meta/data envelope and data.results[] holds one card per deal with item_id, title, price{value, currency, raw}, was_price{value, currency, raw}, shipping, deal_badge, image and url. Observed in a live probe (domain com, max_results 5): five cards priced in USD; four carried a was_price object, one had was_price null, shipping was either the text Free shipping or null, and deal_badge was null on every card, so treat was_price, shipping and deal_badge as optional. meta.record_count reported 5 and meta.domain reported com.

API Features

Sale price with was-price Each card has price and was_price, both with numeric value, currency and a raw display string, so a discount percentage is one subtraction away; was_price is null when no reference price is shown (1 of 5 cards in the probe).
No query required A call with only domain, or even an empty body, returns the site-wide promoted deals grid, so there is nothing to tune before a first request.
Shipping label on each card The shipping field carries the label shown on the deal, such as Free shipping, or null when the grid shows none, which lets you filter for free-shipping offers.
Deal badge field deal_badge is included for separating promoted deal types; it was null on all five probe cards, so code against it as optional rather than as a guaranteed label.
Item IDs that link onward Every card includes item_id and a listing url, so a promising deal can be passed to the item-detail operation for specifics, seller and return terms.
Local currency per marketplace domain decides which eBay site's deals are returned, and prices come back in that site's currency (USD for com in the probe).

Live API Demo

POST /api/project/ebay/deals

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X POST 'https://api.opendata-api.com/api/project/ebay/deals?key=<API_KEY>'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

Do I need to send a search query?

No. The deals operation takes only the optional domain and max_results parameters. It returns the current promoted grid for the chosen marketplace, so an empty JSON body is a valid request.

What fields does each deal card contain?

item_id, title, price, was_price, shipping, deal_badge, image and url. price and was_price are objects with value, currency and raw; the observed probe returned all eight keys on every one of its five cards.

How do I calculate the discount percentage?

Compute (was_price.value - price.value) / was_price.value for cards where was_price is not null. In the probe, four of five cards had a was_price and one had null, so skip cards without it rather than assuming a zero discount.

Why is deal_badge null?

It was null on all five cards in the observed probe, so the field is present but may be empty. Do not rely on it as a required label; fall back to comparing price and was_price.

How many deals can I get per call?

max_results accepts 1 to 240 and larger values are capped at 240. The probe asked for 5 and received 5 cards, with meta.record_count confirming the number returned.

How do I get full details for a deal?

Take the item_id from the card and send it to the item-detail operation. That returns brand, model, item specifics, seller, shipping and return policy, which the deals grid does not include.

Which currency are prices in?

The currency follows the selected domain. The probe used domain com and every price and was_price came back with currency USD, with a raw string such as the formatted amount shown on the listing.

Related operations

Guides

View Subscription Plans →