eBay Product Scraper

The Actor reads one or more eBay listings and saves each as a structured record containing the title, price and currency, condition, stock state, every image on the page, the manufacturer identifiers the seller filled in, the category path the listing sits in, and the seller's eBay Store name. Listings that have been removed produce no dataset record rather than an error.

{
  "item_ids": [
    "https://www.ebay.com/itm/157392565949",
    "146334712345"
  ]
}

Accepted input

item_ids is required and accepts a list in which each entry is either a full item page link or the bare numeric item ID; the two forms can be mixed in one run. eBay appends a tracking query to nearly every link it hands out, and older links place a title slug before the ID; both shapes are reduced to the numeric ID before the request is made, so a link copied from anywhere on eBay is accepted as-is.

Result fields

item_id, url, title, price, and currency describe the listing itself. condition is eBay's own wording, such as New or Pre-owned, and availability reports the stock state as InStock or OutOfStock. images holds every image on the page at full resolution, and image_url repeats the first of them so the dataset preview has a thumbnail column.

brand, mpn, gtin, and model come from the listing's structured product data. These four are filled in by the seller rather than by eBay, and a listing whose seller left them blank returns null for each; this is common on used and single-item listings and is not an error.

breadcrumbs is the listing's own category path as an ordered array from eBay's home page down to the leaf category, each entry carrying position, name, and url. seller holds the seller summary, and store_name repeats the store name at the top level where the seller runs an eBay Store; sellers without one return null. item_detail carries the complete record for anything not broken out into its own field.

{
  "item_id": "157392565949",
  "url": "https://www.ebay.com/itm/157392565949",
  "title": "adidas women Grand Court 2.0 Shoes",
  "price": 24,
  "currency": "USD",
  "condition": "New",
  "availability": "InStock",
  "brand": "adidas",
  "mpn": null,
  "gtin": null,
  "model": null,
  "images": [
    "https://i.ebayimg.com/images/g/3XEAAeSwJtNqdX3T/s-l1600.jpg",
    "https://i.ebayimg.com/images/g/BgYAAeSwXudqdX3T/s-l1600.jpg"
  ],
  "breadcrumbs": [
    { "position": 1, "name": "eBay", "url": "https://www.ebay.com" },
    { "position": 4, "name": "Women's Shoes", "url": "https://www.ebay.com/b/Womens-Shoes/3034/bn_740022" }
  ],
  "seller": { "store_name": "adidas" }
}

This is a trimmed, live-verified result; images and breadcrumbs are shown with two entries each and returned in full.

Behaviour on partial results

Each item is a separate page and therefore a separate request. A listing that has been removed, or an ID that never existed, is reported by the source as an empty response rather than as a failure; the Actor records that the item was not found, saves no row for it, and continues with the rest of the list. A request that fails outright is treated the same way. A run of ten IDs in which two are dead finishes normally with eight rows saved, so one bad entry in a pasted list does not cost the other nine.

A run whose item_ids list is empty is rejected before any request is made.

Prices are the listed price only

price is the price shown on the listing page in the listing's own currency. Auction listings therefore report the current bid at the moment of the run rather than a final sale price, and no shipping, tax, or best-offer adjustment is included. The Actor does not read sold or completed listings.

Related Actors

store_name from any result is the exact input the eBay Store Scraper takes, so the two chain directly: read an item, then list everything else that seller carries. To collect item IDs in bulk before enriching them here, use the eBay Category Products Scraper or the eBay Deals Scraper; both offer the same item detail as an optional per-row add-on, which avoids exporting IDs and re-importing them. The eBay Category Tree Scraper lists the categories those runs accept, and the eBay Keyword Tool expands seed terms into the phrases shoppers actually search.