eBay Scraper

Search live eBay product listings and receive structured, normalized results in an Apify Dataset.

Use it for price research, marketplace monitoring, competitive listing discovery, or scheduled checks of a product keyword. Each run queries eBay.com directly; it does not return a cached catalog.

What it returns

Each Dataset row represents one eBay listing and can include:

• itemId, title, and canonical itemUrl
• price, currency, and condition
• imageUrl, shipping, and freeShipping
• rating, reviewCount, listingType, and seller signals
• source (ebay), keyword, and scrapedAt

Input

Field	Required	Default	Description
keyword	Yes	iphone 15	eBay search phrase.
country	No	US	Two-letter country used when configuring Apify Residential proxy.
useApifyProxy	No	true	Recommended. Starts with an Apify Residential proxy for reliable eBay access. If explicitly set to false, the Actor tries direct access first and performs one bounded Residential retry only if no usable listings are collected.
maxResults	No	60	Number of listings to collect, from 1 to 500.
categoryId	No	—	Optional eBay category ID.
condition	No	—	new, refurbished, or used.
buyItNow	No	false	Restrict results to Buy It Now listings.
minPrice / maxPrice	No	—	Optional USD price range.
sortBy	No	best_match	best_match, price_asc, price_desc, newly_listed, or ending_soonest.

Example

{
  "keyword": "sony headphones",
  "country": "US",
  "useApifyProxy": true,
  "maxResults": 20,
  "condition": "new",
  "sortBy": "best_match"
}

Reliability behavior

eBay may block cloud datacenter traffic. To avoid a successful run with an empty Dataset:

1. The default path uses an Apify Residential proxy.
2. If you deliberately disable it and direct access produces no usable rows, the Actor retries once with a fresh Residential proxy.
3. If no usable listing is collected after the configured acquisition path, the run fails explicitly and stores an ERROR_SUMMARY record instead of reporting a false success.

Each completed run also writes RUN_SUMMARY to the default key-value store with collected count, proxy selection summary, and recovery outcome.

Output example

{
  "itemId": "123456789012",
  "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
  "price": 249.99,
  "currency": "USD",
  "condition": "Brand New",
  "imageUrl": "https://i.ebayimg.com/images/g/example/s-l500.jpg",
  "itemUrl": "https://www.ebay.com/itm/123456789012",
  "shipping": "Free shipping",
  "freeShipping": true,
  "listingType": "buy_it_now",
  "source": "ebay",
  "keyword": "sony headphones",
  "scrapedAt": "2026-07-16T00:00:00+00:00"
}

Use from the API

Start the Actor with the standard Apify API and read items from the returned default Dataset. See the Apify API documentation for authentication and run-management details.