eBay Product Scraper

Apify Actor for scraping product listings from eBay with advanced filtering and multi-marketplace support.

Features

• Multi-Marketplace Support: US, UK, DE, FR, IT, ES, AU, CA
• Advanced Filtering: Condition, price range, listing type, category
• Flexible Sorting: Best match, price, newly listed, ending soonest
• Comprehensive Data: Title, price, shipping, seller info, bids, watchers, images
• Rate Limiting: Built-in delays to avoid blocking
• Error Handling: Automatic retries with exponential backoff
• User-Agent Rotation: Multiple user agents for better reliability

Input Parameters

Parameter	Type	Description	Default
searchQuery	string	Search keyword	"iPhone 15"
searchUrl	string	Direct eBay search URL (overrides searchQuery)	-
marketplace	select	eBay marketplace (US, UK, DE, FR, IT, ES, AU, CA)	"US"
category	string	eBay category ID	-
condition	select	Item condition (all, new, open_box, refurbished, used)	"all"
listingType	select	Listing type (all, auction, buy_it_now)	"all"
minPrice	number	Minimum price filter	-
maxPrice	number	Maximum price filter	-
sortBy	select	Sort order (best_match, price_asc, price_desc, newly_listed, ending_soonest)	"best_match"
freeShipping	boolean	Show only free shipping items	false
maxResults	number	Maximum products to scrape	100

Output Data

Each product contains:

{
  "title": "Apple iPhone 15 Pro Max 256GB Blue Titanium",
  "price": 1199.99,
  "currency": "$",
  "shippingCost": "Free shipping",
  "condition": "Brand New",
  "sellerName": "example_seller",
  "sellerRating": "99.8%",
  "sellerReviewCount": 15420,
  "bids": null,
  "timeLeft": "",
  "listingType": "Buy It Now",
  "itemId": "123456789",
  "itemUrl": "https://www.ebay.com/itm/123456789",
  "imageUrl": "https://i.ebayimg.com/...",
  "location": "United States",
  "soldCount": 245,
  "watchers": 12
}

Example Usage

Search for iPhones under $500

{
  "searchQuery": "iPhone",
  "marketplace": "US",
  "maxPrice": 500,
  "condition": "used",
  "sortBy": "price_asc",
  "maxResults": 50
}

Search UK marketplace with free shipping

{
  "searchQuery": "PlayStation 5",
  "marketplace": "UK",
  "freeShipping": true,
  "condition": "new",
  "maxResults": 100
}

Use custom search URL

{
  "searchUrl": "https://www.ebay.com/sch/i.html?_nkw=laptop&_sop=15",
  "maxResults": 200
}

Rate Limiting

• 2-3 seconds delay between pages
• Exponential backoff on errors (5s, 10s, 15s)
• User-agent rotation to avoid detection
• Max 3 retries per page

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run locally
npm start

# Build Docker image
docker build -t ebay-scraper .

# Run in Docker
docker run -e APIFY_INPUT_JSON='{"searchQuery":"iPhone"}' ebay-scraper

Deployment

# Login to Apify
apify login

# Push to Apify
apify push

# Run on Apify platform
apify run

Notes

• eBay may change their HTML structure, requiring selector updates
• Some data fields may not be available for all listings
• Respect eBay's Terms of Service and robots.txt
• Use reasonable maxResults values to avoid long-running actors

License

MIT