eBay Store Scraper

The Actor reads one or more eBay storefronts and saves the items each seller lists, stamping every row with the store it came from. Enabling enrichItemDetails adds the full item page to every row, which is what supplies price and condition for the cards that do not carry them.

{
  "store_names": [
    "https://www.ebay.com/str/adidas",
    "nike"
  ],
  "maxItems": 100,
  "enrichItemDetails": false
}

Accepted input

store_names is required and accepts a list in which each entry is either a full storefront link of the form https://www.ebay.com/str/<store_name> or the bare store name; the two forms can be mixed in one run. Store names are case-sensitive as eBay records them and are passed through unchanged, so a name copied from a storefront link works and a re-cased one may not.

maxItems bounds the number of records saved across the whole run rather than per store, and defaults to 100; a value of 0 disables the bound. With several stores and a low bound, the run fills from the first store before reaching the second. enrichItemDetails defaults to false.

Result fields

Each row carries item_id, url, title, image_url, and store_name, and carries price and currency where the storefront page publishes them in a form that can be read directly. With enrichItemDetails enabled each row additionally carries condition, availability, images, brand, mpn, gtin, model, breadcrumbs, seller, and item_detail.

{
  "item_id": "157967038228",
  "url": "https://www.ebay.com/itm/157967038228",
  "title": "adidas men Galaxy 7 Running Shoes",
  "image_url": "https://i.ebayimg.com/images/g/XLMAAeSwuKZqdagy/s-l300.jpg",
  "store_name": "adidas"
}

That is a live-verified row, and it is worth noting what is absent from it: this storefront published no price in a directly readable form, so price and currency are not present. What a storefront card carries varies between sellers, and the two price fields are independent — a row can carry price while currency is still null. This is common rather than exceptional. A run that needs a price, or a currency, on every row should enable enrichItemDetails, which reads each item's own page and is the dependable source for both.

How much of a storefront is returned

A storefront request returns the seller's listing page as eBay renders it; a live run against a large seller returned 48 items. This is the page eBay serves rather than the seller's complete inventory, so a seller with thousands of listings does not return thousands of rows. Raising maxItems does not change that, because the bound trims what was returned rather than requesting more. Where full coverage of a seller's range matters more than convenience, browsing the categories that seller lists in with the eBay Category Products Scraper reaches further.

Stores that cannot be read

A store name that is invalid, or a storefront that has been closed, is reported by the source as an empty response rather than as a failure; the Actor records that the store was not found, saves no rows for it, and continues to the next name in the list. A request that fails outright is treated the same way. One dead store name in a list of ten therefore costs only that store's rows.

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

Related Actors

The store_name field returned by the eBay Product Scraper is the exact input this Actor takes, so the two chain directly: read an item of interest, then list everything else that seller carries. For a category across many sellers rather than one seller's range, use the eBay Category Products Scraper together with the eBay Category Tree Scraper. For eBay's current promotions, use the eBay Deals Scraper.