eBay Product Scraper Actor

A production-grade, high-performance eBay Scraper Actor built for the Apify platform. Extract structured product data, pricing, original list prices, discounts, seller ratings, shipping fees, delivery estimates, categories, specifications, high-resolution images, and auction information across 8 international eBay marketplaces.

---

🌟 Key Features

• 🌍 Multi-Marketplace Support: Scrape eBay US, UK, Germany, Canada, Australia, France, Italy, and Spain.
• ⚡ Dual Scraping Modes:
  • Fast Search Mode (scrapeProductDetails: false): Rapidly parses listing cards directly from search result pages for maximum speed and minimal compute unit consumption.
  • Deep Product Mode (scrapeProductDetails: true): Opens individual /itm/... product pages to extract complete item specifics (specs table), full image galleries, breadcrumbs, return policies, and detailed seller profiles.
• 🏷️ Comprehensive Data Extraction:
  • Pricing & Discounts: Current price, original price, discount percentage/amount, currency code.
  • Product Classification: Category breadcrumb hierarchy, primary category, brand, model, MPN, UPC, country of origin.
  • Social Proof & Status: Top-Rated seller status, sponsored/promoted flag, watcher count, items sold.
  • Logistics: Shipping cost, estimated delivery window, seller location, return window.
  • Media: Low-res thumbnails automatically upgraded to high-resolution (s-l1600) images, full carousel galleries.
• 🛡️ Akamai & Bot Protection Bypass: Optimized browser headers, fingerprinting, and automatic residential proxy integration on Apify Cloud.
• 🔍 Rich Filtering & Sorting:
  • Filter by Condition: Brand New, Used / Pre-Owned, Refurbished.
  • Filter by Format: Buy It Now, Auction.
  • Sort By: Best Match, Lowest Price + Shipping, Highest Price, Newly Listed, Ending Soonest.
• 🧹 Clean Data: Strips badge spam ("Opens in a new window or tab", "derosnopS", "New Listing") and tracking telemetry from item URLs.

---

📥 Input Configuration

Parameter	Type	Default	Description
searchTerms	Array	["vintage leather jacket"]	Keywords to search on eBay.
startUrls	Array	[]	Direct eBay URLs (search listing URLs or individual /itm/... pages).
region	String	"US"	Target marketplace: US, UK, DE, CA, AU, FR, IT, ES.
sortBy	String	"bestMatch"	bestMatch, lowestPrice, highestPrice, newlyListed, endingSoonest.
condition	String	"all"	all, new, used, refurbished.
listingType	String	"all"	all, buyItNow, auction.
maxItems	Integer	20	Total maximum products to scrape across queries.
maxPagesPerQuery	Integer	5	Maximum search pagination pages per keyword.
scrapeProductDetails	Boolean	false	When true, fetches complete item specs, high-res gallery, and return policy.
proxyConfiguration	Object	{}	Apify Proxy configuration. Residential proxies recommended.

Example Input (INPUT.json)

{
  "searchTerms": ["mechanical keyboard", "rtx 4090"],
  "region": "US",
  "sortBy": "lowestPrice",
  "condition": "all",
  "listingType": "buyItNow",
  "maxItems": 25,
  "maxPagesPerQuery": 3,
  "scrapeProductDetails": true
}

---

📤 Output Data Format

The Actor pushes items to the default Apify Dataset. You can export results to JSON, CSV, Excel, or consume them via Apify API.

Sample Output Record (Deep Product Mode)

{
  "title": "Kraken Pro 60% Cotton Candy Keyboard",
  "subtitle": "Compact 60% RGB Mechanical Gaming Keyboard",
  "itemId": "117192284853",
  "price": 46.00,
  "rawPrice": "US $46.00",
  "originalPrice": 59.99,
  "discount": "23% off",
  "currency": "USD",
  "shippingCost": "Free Shipping",
  "estimatedDelivery": "Estimated between Tue, Oct 13 and Tue, Oct 27",
  "condition": "Used",
  "brand": "Kraken",
  "model": "Kraken Pro 60",
  "countryOfOrigin": "United States",
  "primaryCategory": "Keyboards & Keypads",
  "breadcrumbs": [
    "Electronics",
    "Computers/Tablets & Networking",
    "Keyboards, Mice & Pointers",
    "Keyboards & Keypads"
  ],
  "sellerName": "laurenkoller",
  "sellerPositiveRate": "100%",
  "sellerFeedbackScore": "158",
  "sellerStoreUrl": "https://www.ebay.com/sch/laurenkoller/m.html",
  "isTopRated": false,
  "isSponsored": false,
  "watchersCount": "11",
  "itemLocation": "United States",
  "listingType": "Buy It Now or Best Offer",
  "bidsCount": null,
  "url": "https://www.ebay.com/itm/117192284853",
  "thumbnail": "https://i.ebayimg.com/images/g/9mMAAeSwjiVqA70K/s-l500.webp",
  "highResImage": "https://i.ebayimg.com/images/g/9mMAAeSwjiVqA70K/s-l1600.webp",
  "description": "Barely used cotton candy kraken keyboard. Comes with box no cord no issues.",
  "shippingDetails": "US $90.97 eBay International Shipping with tracking",
  "returnPolicy": "30 days returns. Buyer pays for return shipping.",
  "itemSpecifics": {
    "Brand": "Kraken",
    "Type": "Mechanical",
    "Color": "Cotton Candy",
    "Keyboard Layout": "QWERTY (Standard)",
    "Model": "Kraken Pro 60",
    "Connectivity": "Wired, USB"
  },
  "galleryImages": [
    "https://i.ebayimg.com/images/g/9mMAAeSwjiVqA70K/s-l1600.webp",
    "https://i.ebayimg.com/images/g/dL4AAeSwNylqA71E/s-l1600.webp"
  ],
  "scrapedAt": "2026-09-12T06:40:21.002Z"
}

---

🚀 Running on Apify

1. Deploy the Actor using the Apify CLI:

   $apify push
   

2. Or run remotely via Apify Console or API:

   $curl --request POST "https://api.apify.com/v2/acts/datablow~ebay-product-scraper/runs?token=<YOUR_TOKEN>"