eBay Sold Listings Scraper

📝 Description

The eBay Sold Listings Scraper extracts confirmed eBay sold prices — not asking prices. Get real market data from completed listings across 8 eBay marketplaces. Perfect for resellers, collectors, estate sales, and market research.

✨ Key Features

• ✅ Real Sold Prices - Scrape actual transaction prices, not listing prices
• 🌍 8 Marketplaces - US, UK, Germany, France, Italy, Spain, Canada, Australia
• ⚡ Two Modes - Fast mode (10-30s) or detailed mode (2-5min)
• 📊 Rich Data - Prices, shipping, seller info, item details
• 🔍 Advanced Filters - Price range, days, condition, category, location
• 🛡️ Anti-Scraping - Rate limiting, proxy support, realistic headers

🚀 Use Cases

• Market Research - Analyze sold prices for products
• Price Comparison - Compare asking vs. sold prices
• Reselling - Find underpriced items to flip
• Collections - Track market value of collectibles
• Estate Sales - Get realistic pricing for inherited items
• Competitive Intelligence - Monitor competitor sold prices

📦 Input Parameters

Parameter	Type	Required	Default	Description
keyword	string	✅ Yes	-	Search keyword (e.g., "iphone 13")
count	integer	No	100	Max results (1-300)
daysToScrape	integer	No	30	Days back to scrape (1-90)
ebaySite	string	No	"ebay.com"	eBay site to scrape
categoryId	string	No	"0"	eBay category ID (0 = All Categories)
sortOrder	string	No	"endedRecently"	How to sort results
minPrice	number	No	-	Minimum sold price filter
maxPrice	number	No	-	Maximum sold price filter
itemLocation	string	No	"default"	Filter by location (default/domestic/worldwide)
itemCondition	string	No	"any"	Filter by condition (any/new/used)
detailedSearch	boolean	No	false	Visit each item page (slower, more data)
currencyMode	string	No	"localized"	Currency handling (localized/USD)

Supported eBay Sites

• ebay.com - United States
• ebay.co.uk - United Kingdom
• ebay.de - Germany
• ebay.fr - France
• ebay.it - Italy
• ebay.es - Spain
• ebay.ca - Canada
• ebay.com.au - Australia

Sort Options

• endedRecently - Ended recently (newest)
• timeNewlyListed - Time newly listed
• pricePlusPostageLowest - Price + postage: lowest first
• pricePlusPostageHighest - Price + postage: highest first
• distanceNearest - Distance: nearest first

📤 Output

Fast Mode Output

{
  "itemId": "1234567890",
  "url": "https://www.ebay.com/itm/1234567890",
  "title": "Apple iPhone 13 128GB Midnight - Unlocked",
  "categoryId": "9355",
  "category": "Cell Phones, Smartphones & Accessories",
  "endedAt": "2026-04-10T14:30:00.000Z",
  "soldPrice": "450.00",
  "soldCurrency": "USD",
  "shippingPrice": "0.00",
  "shippingCurrency": "USD",
  "shippingType": "free",
  "totalPrice": "450.00",
  "sellerUsername": "seller123",
  "sellerPositivePercent": 99.5,
  "sellerFeedbackScore": 1500,
  "scrapedAt": "2026-04-14T12:00:00.000Z"
}

Detailed Mode Output (Additional Fields)

{
  "categoryPath": "Electronics > Cell Phones > Smartphones > iPhones",
  "condition": "New",
  "itemSpecifics": {
    "Brand": "Apple",
    "Model": "iPhone 13",
    "Storage Capacity": "128GB",
    "Color": "Midnight",
    "Network": "Unlocked"
  },
  "productDetails": {
    "Screen Size": "6.1\"",
    "Processor": "A15 Bionic",
    "RAM": "4GB",
    "Operating System": "iOS 16"
  },
  "itemLocation": "New York, NY, United States",
  "quantitySold": 1,
  "bids": 12
}

⚡ Performance

Mode	100 Results	300 Results
Fast Mode	~10-30 seconds	~1-2 minutes
Detailed Mode	~2-5 minutes	~10-15 minutes

Note: eBay shows ~60 items per page with a maximum of 5 pages per run, giving a hard cap of ~300 results. For larger datasets, run multiple times with different date ranges or keywords.

🎯 Category IDs Reference

Find eBay category IDs at: https://sold-comps.com/ebay-categories

Common categories:

• 0 - All Categories
• 9355 - Cell Phones, Smartphones & Accessories
• 13997 - Computers/Tablets & Networking
• 1249 - Sporting Goods
• 267 - Books

📖 Usage Examples

Example 1: Basic Search (Fast Mode)

curl -X POST https://api.apify.com/v2/acts/syncnet/ebay-sold-listings-scraper/runs \
  -H 'Content-Type: application/json' \
  -d '{
    "keyword": "iphone 13",
    "count": 50,
    "daysToScrape": 30
  }'

Example 2: With Filters

curl -X POST https://api.apify.com/v2/acts/syncnet/ebay-sold-listings-scraper/runs \
  -H 'Content-Type: application/json' \
  -d '{
    "keyword": "gaming pc",
    "minPrice": 500,
    "maxPrice": 1000,
    "itemCondition": "used",
    "itemLocation": "domestic",
    "count": 100
  }'

Example 3: UK Marketplace (Detailed Mode)

curl -X POST https://api.apify.com/v2/acts/syncnet/ebay-sold-listings-scraper/runs \
  -H 'Content-Type: application/json' \
  -d '{
    "keyword": "ps5",
    "ebaySite": "ebay.co.uk",
    "detailedSearch": true,
    "count": 25
  }'

Example 4: Node.js SDK

const { Actor } = require('apify');

const run = await Actor.call('syncnet/ebay-sold-listings-scraper', {
  keyword: 'macbook pro',
  minPrice: 800,
  maxPrice: 1500,
  daysToScrape: 14,
  detailedSearch: true
});

const { items } = await run.client.dataset(run.defaultDatasetId).listItems();
console.log('Results:', items);

Example 5: Python SDK

from apify_client import ApifyClient

client = ApifyClient('YOUR_APIFY_TOKEN')

run = client.actor('syncnet/ebay-sold-listings-scraper').call(
  keyword='nintendo switch',
  ebaySite='ebay.com',
  count=100,
  daysToScrape=7
)

items = client.dataset(run['defaultDatasetId']).list_items()
print(f"Scraped {items['total']} items")

🛠️ Development

Build

npm install
npm run build

Run Locally

$npm start

Test

$npm test

🔒 Anti-Scraping Measures

• Rate limiting (2 requests/second)
• Realistic User-Agent headers
• Random delays between requests
• Proxy rotation support (Apify Proxy)
• Proper error handling (429, 403)

📊 Pricing

Pay-per-event pricing. Cost depends on:

• Number of results scraped
• Mode used (fast vs. detailed)
• Marketplace
• Proxy usage

🤝 Support

• Issues: Report via Apify Console
• Questions: Contact via Apify Actor page
• Documentation: See Apify Actor page

📄 License

MIT

⚠️ Disclaimer

This scraper extracts publicly available data from eBay. Please ensure your use complies with eBay's Terms of Service and applicable laws.

---

Made with ❤️ by syncnet