# eBay Search Scraper (`burbn/ebay-search-scraper`) Actor Search eBay products by keyword across 20+ global marketplaces. Extract product titles, prices, discounts, seller ratings, shipping info, conditions & more. Filter by condition, buying format, price range & listing attributes. Supports US, UK, Germany, France, Australia, Canada & 15+ eBay domains. - **URL**: https://apify.com/burbn/ebay-search-scraper.md - **Developed by:** [Kevin](https://apify.com/burbn) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## eBay Search Scraper | Search eBay Products API Search eBay products by keyword across 20+ international marketplaces. Extract product titles, prices, conditions, seller info, shipping details, discounts, ratings, and more from eBay search results. Filter by condition, buying format, price range, sort order, and listing attributes. The best eBay search scraper for product research, price monitoring, and e-commerce analysis. ### ❓ What is eBay Search Scraper? **eBay Search Scraper** is a powerful Apify actor that lets you search and extract product listings from **eBay** by keyword — across 20+ international marketplaces. Perfect for e-commerce sellers, market researchers, price comparison tools, and dropshipping businesses. With this eBay search tool, you can: - 🔍 **Search products by keyword** — Enter any product name or keyword (e.g., "iphone 17", "samsung s25", "vintage rolex") - 🌍 **20+ Marketplaces** — Search eBay US, UK, Germany, France, Australia, Canada, and 15+ more - 📊 **Sort results** — Best Match, Ending Soonest, Newly Listed, Price Low to High, Price High to Low - 📦 **Filter by condition** — New, Used, Open Box, Refurbished, For Parts - 🛒 **Filter by format** — Buy It Now, Auction, Accepts Offers - 💰 **Price range filter** — Set minimum and maximum price - 🏷️ **Listing attributes** — Free returns, free shipping, deals & savings, sold items, and more - 📄 **Automatic pagination** — Scrape multiple pages with up to 60 results each ### 🎯 What Data Can You Extract from eBay Search? | Field | Description | |-------|-------------| | `itemId` | Unique eBay item identifier | | `title` | Product listing title | | `url` | Direct link to eBay listing | | `image` | Product image URL | | `price` | Current price | | `currency` | Price currency (USD, GBP, EUR, etc.) | | `originalPrice` | Original price before discount | | `discount` | Discount percentage (e.g., "33% off") | | `condition` | Item condition (New, Used, Refurbished, etc.) | | `isSponsored` | Whether the listing is sponsored | | `shipping` | Shipping cost or "Free shipping" | | `location` | Seller location | | `sellerName` | Seller username | | `sellerFeedbackPercentage` | Seller positive feedback percentage | | `sellerFeedbackCount` | Total seller feedback count | | `sellerTopRated` | Whether seller is eBay Top Rated | | `watchers` | Number of watchers | | `itemsSold` | Number of items sold | | `freeReturns` | Whether free returns are available | | `rating` | Product rating (1-5 stars) | | `reviewCount` | Number of product reviews | | `buyingFormat` | Buying format (Buy It Now, Auction) | | `timeLeft` | Time remaining for auction listings | | `bidCount` | Number of bids (auctions) | | `position` | Position in search results | ### 🚀 How to Use eBay Search Scraper #### Step 1: Enter Search Query Enter the product keyword you want to search for on eBay. #### Step 2: Set Filters (Optional) | Input | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | `query` | String | ✅ Yes | `iphone 17` | Product keyword to search | | `domain` | Enum | ❌ No | `com` | eBay marketplace (com, co.uk, de, etc.) | | `sort_by` | Enum | ❌ No | `BEST_MATCH` | Sort order for results | | `condition` | Array | ❌ No | `[]` | Item condition filter | | `buying_format` | Enum | ❌ No | — | Buying format filter | | `show_only` | Array | ❌ No | `[]` | Listing attribute filters | | `min_price` | Number | ❌ No | — | Minimum price filter | | `max_price` | Number | ❌ No | — | Maximum price filter | | `page` | Integer | ❌ No | `1` | Starting page number (1-100) | | `maxPages` | Integer | ❌ No | `1` | Maximum pages to scrape (1-100) | #### Step 3: Run and Download Results Click **Start** to run the scraper. Results are available in JSON, CSV, Excel, XML, and RSS formats. ### 📋 Example Input ```json { "query": "iPhone 15", "domain": "com", "sort_by": "BEST_MATCH", "condition": ["new"], "buying_format": "buy_it_now", "show_only": ["free_shipping"], "maxPages": 3 } ```` ### 📋 Example Output ```json { "itemId": "287062440001", "title": "Apple iPhone 15 128GB Factory Unlocked AT&T T-Mobile Verizon Very Good Condition", "url": "https://www.ebay.com/itm/287062440001", "image": "https://i.ebayimg.com/thumbs/images/g/K~oAAOSw5UdnxSHa/s-l500.jpg", "price": 400.49, "currency": "USD", "originalPrice": 599.99, "discount": "33% off", "condition": "Very Good - Refurbished", "isSponsored": true, "shipping": "Free shipping", "location": "United States", "sellerName": "wirelesssource", "sellerFeedbackPercentage": 98.7, "sellerFeedbackCount": 125432, "sellerTopRated": true, "watchers": null, "itemsSold": 1200, "freeReturns": true, "rating": 4.5, "reviewCount": 342, "buyingFormat": "Buy It Now", "timeLeft": null, "bidCount": null, "position": 1 } ``` ### 🎨 Dataset Views | View | Description | |------|-------------| | 📊 **Products Overview** | Title, price, condition, shipping, location, and link | | 💰 **Pricing Details** | Original price, discount, buying format, bid count, time left | | 🏪 **Seller Details** | Seller name, feedback, top rated status, free returns, items sold | ### 💡 Use Cases - **Product Research** — Find and compare products across eBay marketplaces worldwide - **Price Monitoring** — Track prices for specific products over time - **Dropshipping** — Discover trending products and competitive pricing for dropshipping - **E-commerce Analysis** — Analyze competitor listings, pricing strategies, and seller performance - **Deal Hunting** — Find the best deals with discount and free shipping filters - **Market Research** — Study product demand, pricing trends, and seller landscape - **Auction Monitoring** — Track auction listings with bid counts and time remaining ### 🔧 Tips for Best Results 1. **Be specific** — Use specific product names for more relevant results 2. **Use condition filter** — Filter by "new" or "refurbished" to narrow results 3. **Set price range** — Use min/max price to find products in your budget 4. **Try different marketplaces** — Search across multiple eBay domains to compare prices 5. **Increase maxPages** — Set to 10+ for comprehensive product research 6. **Use show\_only filters** — Combine "free\_shipping" with "free\_returns" for buyer-friendly listings ### 🏷️ Tags `ebay` `ebay scraper` `ebay search` `ebay products` `ebay search scraper` `ebay api` `product search` `price comparison` `ebay crawler` `ebay extractor` `product research` `price monitoring` `dropshipping` `e-commerce` `ebay listings` `ebay data` `marketplace scraper` `online shopping` ### 🎁 Get $5 Free Apify Credits New to Apify? [Sign up using this link](https://apify.com?fpr=free-credits) and get **$5 free credits** to start scraping eBay right away! No credit card required. ### 📞 Support For questions, feedback, or issues, please contact us through Apify or open an issue. *** **Happy searching eBay products! 🔍✨** # Actor input Schema ## `query` (type: `string`): Enter the product keyword to search for on eBay (e.g., iphone 17 pro max, playstation 5, lenovo thinkpad x1 carbon gen 12). ## `domain` (type: `string`): Select the eBay domain/marketplace to search. Sets the country, language, and currency. ## `sort_by` (type: `string`): Sort order for search results. ## `condition` (type: `array`): Filter by item condition. Select one or more conditions. ## `buying_format` (type: `string`): Filter by buying format. ## `show_only` (type: `array`): Filter results by listing attributes. Select one or more. ## `min_price` (type: `number`): Only return products with price greater than this value (in the currency of the selected marketplace). ## `max_price` (type: `number`): Only return products with price less than this value (in the currency of the selected marketplace). ## `page` (type: `integer`): Starting page number (each page has up to 60 results). Range: 1-100. ## `maxPages` (type: `integer`): Maximum number of pages to scrape (each page has up to 60 results). Set to 1 for a quick test, or higher for comprehensive data. ## Actor input object example ```json { "query": "iphone 17", "domain": "com", "sort_by": "BEST_MATCH", "condition": [], "buying_format": "", "show_only": [], "page": 1, "maxPages": 1 } ``` # Actor output Schema ## `overview` (type: `string`): View all products with title, price, condition, shipping, location, and link. ## `pricing` (type: `string`): View pricing details with original price, discount, buying format, bid count, and time left. ## `sellers` (type: `string`): View seller info with name, feedback percentage, feedback count, top rated status, and items sold. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "query": "iphone 17", "domain": "com", "sort_by": "BEST_MATCH", "buying_format": "", "page": 1, "maxPages": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("burbn/ebay-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "query": "iphone 17", "domain": "com", "sort_by": "BEST_MATCH", "buying_format": "", "page": 1, "maxPages": 1, } # Run the Actor and wait for it to finish run = client.actor("burbn/ebay-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "query": "iphone 17", "domain": "com", "sort_by": "BEST_MATCH", "buying_format": "", "page": 1, "maxPages": 1 }' | apify call burbn/ebay-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=burbn/ebay-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "eBay Search Scraper", "description": "Search eBay products by keyword across 20+ global marketplaces. Extract product titles, prices, discounts, seller ratings, shipping info, conditions & more. Filter by condition, buying format, price range & listing attributes. Supports US, UK, Germany, France, Australia, Canada & 15+ eBay domains.", "version": "1.0", "x-build-id": "o3GGvhFKcBlflGRaD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/burbn~ebay-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-burbn-ebay-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/burbn~ebay-search-scraper/runs": { "post": { "operationId": "runs-sync-burbn-ebay-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/burbn~ebay-search-scraper/run-sync": { "post": { "operationId": "run-sync-burbn-ebay-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "query" ], "properties": { "query": { "title": "🔎 Search Query", "type": "string", "description": "Enter the product keyword to search for on eBay (e.g., iphone 17 pro max, playstation 5, lenovo thinkpad x1 carbon gen 12).", "default": "iphone 17" }, "domain": { "title": "🌍 eBay Marketplace", "enum": [ "com", "co.uk", "com.au", "de", "ca", "fr", "it", "es", "at", "ch", "com.sg", "com.my", "ph", "ie", "pl", "nl", "be", "com.hk", "com.mx", "com.br" ], "type": "string", "description": "Select the eBay domain/marketplace to search. Sets the country, language, and currency.", "default": "com" }, "sort_by": { "title": "📊 Sort By", "enum": [ "BEST_MATCH", "ENDING_SOONEST", "NEWLY_LISTED", "PRICE_LOWEST", "PRICE_HIGHEST" ], "type": "string", "description": "Sort order for search results.", "default": "BEST_MATCH" }, "condition": { "title": "📦 Item Condition", "type": "array", "description": "Filter by item condition. Select one or more conditions.", "items": { "type": "string", "enum": [ "new", "used", "open_box", "refurbished", "for_parts" ], "enumTitles": [ "New", "Used", "Open Box", "Refurbished", "For Parts" ] }, "default": [] }, "buying_format": { "title": "🛒 Buying Format", "enum": [ "", "buy_it_now", "auction", "accepts_offers" ], "type": "string", "description": "Filter by buying format.", "default": "" }, "show_only": { "title": "🏷️ Show Only", "type": "array", "description": "Filter results by listing attributes. Select one or more.", "items": { "type": "string", "enum": [ "free_returns", "deals_and_savings", "returns_accepted", "authorized_seller", "sold_items", "completed_items", "free_shipping", "local_pickup" ], "enumTitles": [ "Free Returns", "Deals & Savings", "Returns Accepted", "Authorized Seller", "Sold Items", "Completed Items", "Free Shipping", "Local Pickup" ] }, "default": [] }, "min_price": { "title": "💰 Minimum Price", "type": "number", "description": "Only return products with price greater than this value (in the currency of the selected marketplace)." }, "max_price": { "title": "💰 Maximum Price", "type": "number", "description": "Only return products with price less than this value (in the currency of the selected marketplace)." }, "page": { "title": "📄 Start Page", "minimum": 1, "maximum": 100, "type": "integer", "description": "Starting page number (each page has up to 60 results). Range: 1-100.", "default": 1 }, "maxPages": { "title": "🎯 Maximum Pages", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of pages to scrape (each page has up to 60 results). Set to 1 for a quick test, or higher for comprehensive data.", "default": 1 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```