eBay Deals Scraper

The Actor exports the items currently listed on eBay's deals page, saving each one with its title, discounted price and currency, image, item ID, and link. A live run returns roughly 115 items. Enabling enrichItemDetails adds the full item page to every row.

{
  "maxItems": 0,
  "enrichItemDetails": false
}

Accepted input

maxItems bounds the number of records saved and defaults to 0, which disables the bound. The default differs from the rest of this domain deliberately: the deals page arrives whole in a single request, so a cap discards rows that have already been fetched rather than saving a request. enrichItemDetails defaults to false.

There is no keyword, category, or region input. The deals page is a single curated listing that eBay composes itself, and it is returned as eBay presents it.

Result fields

Each row carries item_id, url, title, price, currency, and image_url. With enrichItemDetails enabled each row additionally carries condition, availability, images, brand, mpn, gtin, model, breadcrumbs, seller, store_name, and item_detail.

{
  "item_id": "157392565949",
  "url": "https://www.ebay.com/itm/157392565949?_trkparms=5373%3A0%7C5374%3AFeatured",
  "title": "adidas women Grand Court 2.0 Shoes",
  "price": 24,
  "currency": "USD",
  "image_url": "https://i.ebayimg.com/images/g/wJAAAeSw1KtqdLPP/s-l400.jpg"
}

Fields a card does not carry

The structured fields are read from the deals page's own markup. Most cards carry all of them, but a card that omits a price, a currency, or an image is saved without that field rather than with a guessed one; item_id and url are always present. Enabling enrichItemDetails fills these gaps from the item's own page, which is the reliable source for anything beyond the card.

Where a card and the item page disagree, the item page wins on enrichment. This matters for two fields in particular: title on a deals card is frequently truncated, and url carries the tracking parameters eBay stamps onto every promoted link. Enrichment replaces both with the full title and the canonical link, while leaving any field the item page has no value for exactly as the card reported it.

What the price means

price is the promoted price shown on the deals page at the moment of the run. It is a live figure rather than a historical one, and no pre-discount price or discount percentage is published by this listing. Tracking how a promoted price moves therefore requires scheduling the Actor and comparing runs; a single run captures one point in time.

Related Actors

Scheduling this Actor daily and keying on item_id is the usual way to build a price history of what eBay promotes. For a specific set of listings rather than eBay's own selection, use the eBay Product Scraper. For everything in a category rather than everything on promotion, use the eBay Category Products Scraper, with the eBay Category Tree Scraper to find the category link it takes. For a single seller's catalogue, use the eBay Store Scraper.