# Ebay Search Scraper (`crw/ebay-search-scraper`) Actor Turn any eBay search into a clean, structured dataset in minutes. Filter by condition, price range, and shipping destination. Get prices, seller ratings, return policies, bid counts, and more — up to 500 listings per run, no API key needed. - **URL**: https://apify.com/crw/ebay-search-scraper.md - **Developed by:** [CRW](https://apify.com/crw) (community) - **Categories:** E-commerce, Developer tools, Automation - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 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. 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 and extract structured product listings at scale — no API key, no manual browsing, no pagination headaches. Point it at any keyword. Get back a clean dataset with prices, shipping costs, seller info, condition, and direct listing links. --- ### Who is this for? **E-commerce sellers & resellers** Monitor competitor pricing across thousands of listings. Track what similar items sell for — with or without Best Offer — and adjust your pricing strategy in real time. **Price comparison & deal sites** Pull live eBay listings into your platform automatically. Filter by condition, price range, and shipping destination without touching eBay's API rate limits. **Market researchers & analysts** Analyze pricing trends across categories, track sponsored vs. organic listing ratios, and compare seller feedback across the market. **Developers & data engineers** Plug eBay listing data directly into your pipeline via the Apify API or SDK. Full JSON output, Apify dataset storage, and SDK support for Python and JavaScript. --- ### What you get Every listing comes with: | Field | Example | |-------|---------| | `listing_id` | `358719187633` | | `title` | Apple iPhone 15 Plus 128GB Blue (Unlocked) | | `price` | $628.95 | | `shipping` | Free shipping | | `condition` | Pre-Owned | | `listing_type` | Buy It Now | | `best_offer` | `true` | | `bid_count` | `5` (auctions only) | | `auction_end` | Jun-24 20:03 (auctions only) | | `return_policy` | Free returns | | `seller_name` | apple_reseller_99 | | `seller_feedback` | 99.8% positive (4.2K) | | `rating` | 4.5 out of 5 stars. | | `rating_count` | 312 product ratings | | `is_sponsored` | `false` | | `image_url` | Image URL | | `url` | Direct link to the eBay listing | #### Sample record ```json { "listing_id": "358719187633", "title": "Apple iPhone 15 Plus 128GB Blue (Unlocked)", "price": "$628.95", "shipping": "Free shipping", "condition": "Pre-Owned", "listing_type": "Buy It Now", "best_offer": true, "bid_count": null, "auction_end": null, "return_policy": "Free returns", "location": "Located in United States", "seller_name": "apple_reseller_99", "seller_feedback": "99.8% positive (4.2K)", "rating": "4.5 out of 5 stars.", "rating_count": "312 product ratings", "is_sponsored": false, "image_url": "https://i.ebayimg.com/images/g/abc123/s-l500.webp", "url": "https://www.ebay.com/itm/358719187633" } ```` *** ### Getting started #### 1. Set your search | Parameter | Required | Default | Description | |-----------|----------|---------|-------------| | `query` | Yes | — | Search keyword (e.g. `"iphone 15"`, `"digital camera"`) | | `maxResults` | No | `50` | Maximum number of listings to collect (20–500) | | `maxSearchPages` | No | `5` | Maximum pages to scrape. Each page has up to 60 listings (1–20) | | `sort` | No | `best_match` | Sort order — see Sort options below | | `conditions` | No | — | Condition filter — see Condition filter below | | `minPrice` | No | — | Minimum price in USD | | `maxPrice` | No | — | Maximum price in USD | | `shipToCountry` | No | — | Filter by shipping destination country (ISO 3166-1 alpha-3, e.g. `USA`, `GBR`) | | `shipToZipCode` | No | — | US ZIP code for more precise location filtering (USA only, e.g. `10001`) | #### 2. Run it Click **Start** in the Apify console, or use the API: ```json { "query": "iphone 15", "maxResults": 100, "sort": "price_asc", "conditions": "1000", "maxPrice": 700, "shipToCountry": "USA" } ``` #### 3. Get your data Results are saved to an Apify dataset as each page completes. Export as **JSON**, **CSV**, or **Excel** — or stream directly into your app via the Apify API. *** ### Sort options | Value | Description | |-------|-------------| | `best_match` (default) | eBay's default relevance ranking | | `newly_listed` | Most recently listed first | | `ending_soonest` | Auction end time, soonest first | | `price_asc` | Price + shipping, lowest first | | `price_desc` | Price + shipping, highest first | | `distance` | Nearest first (requires `shipToCountry`) | *** ### Condition filter eBay condition codes vary by category. To find the right value for your search: 1. Run a search on eBay and apply the condition filter you want 2. Copy the `LH_ItemCondition` value from the URL (e.g. `1000%7C1500`) 3. Paste it into the `conditions` input field — URL-encoded values are handled automatically **Common condition codes:** | Code | Condition | |------|-----------| | `1000` | New | | `1500` | Open box | | `2000` | Certified Refurbished | | `3000` | Used | | `7000` | For parts or not working | Combine multiple conditions with `|` — for example `1000|3000` for New and Used. *** ### For developers #### JavaScript / TypeScript ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('YOUR_ACTOR_ID').call({ query: 'iphone 15', maxResults: 100, sort: 'price_asc', shipToCountry: 'USA', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_API_TOKEN') run = client.actor('YOUR_ACTOR_ID').call(run_input={ 'query': 'iphone 15', 'maxResults': 100, 'sort': 'price_asc', 'shipToCountry': 'USA', }) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` *** ### You might also need Selling on eBay and Walmart at the same time? Most serious resellers do. Here's how the two actors complement each other: | | eBay Search Scraper | Walmart Products Scraper | |---|---|---| | **Best for** | Used, refurbished, auction, and niche items | New retail products at fixed prices | | **Pricing model** | Auction + Buy It Now, Best Offer | Fixed retail price, rollback deals | | **Seller intel** | Feedback %, seller name | Brand, stock status, delivery dates | | **Typical use** | Resale pricing, collectibles, parts market | Retail arbitrage, inventory benchmarking | **[Walmart Products Scraper](https://apify.com/crw/walmart-products-scraper)** — Scrape Walmart US and Canada product listings by keyword or category. Get prices, discounts, ratings, delivery dates, and stock status. If you're benchmarking retail prices or sourcing products to flip on eBay, this is the other half of your workflow. #### Looking for the supply side? If your workflow includes finding where products are sourced cheapest: - **[Temu Products Scraper](https://apify.com/crw/temu-products-scraper)** — Search Temu's full catalog by keyword. Direct-from-manufacturer pricing across millions of SKUs. - **[Temu Category Trend Report](https://apify.com/crw/temu-category-trend-report)** — Daily top-100 rankings and price momentum across 30 categories. Useful for spotting sourcing opportunities before they show up on Western resale markets. *** ### Limitations - **Volume:** Up to 500 listings per run (up to 20 pages × 60 listings per page). - **Search results only:** Data is extracted from search result pages. Listing detail pages (full description, all images) are not visited. - **Auction bid counts:** Live bid counts may be slightly delayed as eBay updates them periodically. # Actor input Schema ## `query` (type: `string`): eBay search keyword. E.g. 'iphone 15', 'digital camera' ## `maxSearchPages` (type: `integer`): Maximum number of search result pages to scrape. Each page has up to 60 products. ## `maxResults` (type: `integer`): Maximum number of listings to collect (20–500). Acts as an additional cap on top of Max Search Pages. ## `conditions` (type: `string`): Filter by item condition. Copy the LH\_ItemCondition value from an eBay search URL. E.g. '1000' for New, '1000|3000' for New + Used. Leave blank for Any Condition. ## `sort` (type: `string`): How to sort the search results ## `shipToCountry` (type: `string`): Filter results to show only items that can be shipped to the selected country. Leave blank to use eBay default (based on your IP location). ## `shipToZipCode` (type: `string`): US ZIP code for more precise location filtering. Only applies when Ship-to Country is USA. E.g. 10001 for Manhattan, 90210 for Beverly Hills. ## `minPrice` (type: `number`): Minimum item price in USD. Leave blank for no lower limit. ## `maxPrice` (type: `number`): Maximum item price in USD. Leave blank for no upper limit. ## Actor input object example ```json { "query": "wireless earbuds", "maxSearchPages": 5, "maxResults": 50, "sort": "best_match" } ``` # Actor output Schema ## `api` (type: `string`): REST API endpoint to download the dataset programmatically. # 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": "wireless earbuds" }; // Run the Actor and wait for it to finish const run = await client.actor("crw/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": "wireless earbuds" } # Run the Actor and wait for it to finish run = client.actor("crw/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": "wireless earbuds" }' | apify call crw/ebay-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crw/ebay-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Ebay Search Scraper", "description": "Turn any eBay search into a clean, structured dataset in minutes. Filter by condition, price range, and shipping destination. Get prices, seller ratings, return policies, bid counts, and more — up to 500 listings per run, no API key needed.", "version": "0.0", "x-build-id": "aEKVqu2ODGdgcLStV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crw~ebay-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crw-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/crw~ebay-search-scraper/runs": { "post": { "operationId": "runs-sync-crw-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/crw~ebay-search-scraper/run-sync": { "post": { "operationId": "run-sync-crw-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", "minLength": 1, "type": "string", "description": "eBay search keyword. E.g. 'iphone 15', 'digital camera'" }, "maxSearchPages": { "title": "Max Search Pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of search result pages to scrape. Each page has up to 60 products.", "default": 5 }, "maxResults": { "title": "Max Results", "minimum": 20, "maximum": 500, "type": "integer", "description": "Maximum number of listings to collect (20–500). Acts as an additional cap on top of Max Search Pages.", "default": 50 }, "conditions": { "title": "Condition Filter", "type": "string", "description": "Filter by item condition. Copy the LH_ItemCondition value from an eBay search URL. E.g. '1000' for New, '1000|3000' for New + Used. Leave blank for Any Condition." }, "sort": { "title": "Sort Order", "enum": [ "best_match", "ending_soonest", "newly_listed", "price_asc", "price_desc", "distance" ], "type": "string", "description": "How to sort the search results", "default": "best_match" }, "shipToCountry": { "title": "Ship-to Country", "enum": [ "", "USA", "CAN", "GBR", "AFG", "ALB", "DZA", "ASM", "AND", "AGO", "AIA", "ATG", "ARG", "ARM", "ABW", "AUS", "AUT", "AZE", "BHS", "BHR", "BGD", "BRB", "BLR", "BEL", "BLZ", "BEN", "BMU", "BTN", "BOL", "BIH", "BWA", "BRA", "VGB", "BRN", "BGR", "BFA", "MMR", "BDI", "KHM", "CMR", "CPV", "CYM", "CAF", "TCD", "CHL", "CHN", "COL", "COM", "COD", "COG", "COK", "CRI", "CIV", "HRV", "CYP", "CZE", "DNK", "DJI", "DMA", "DOM", "ECU", "EGY", "SLV", "GNQ", "ERI", "EST", "ETH", "FLK", "FJI", "FIN", "FRA", "GUF", "PYF", "GAB", "GMB", "GEO", "DEU", "GHA", "GIB", "GRC", "GRL", "GRD", "GLP", "GUM", "GTM", "GIN", "GNB", "GUY", "HTI", "HND", "HKG", "HUN", "ISL", "IND", "IDN", "IRL", "ISR", "ITA", "JAM", "JPN", "JOR", "KAZ", "KEN", "KIR", "KOR", "KWT", "KGZ", "LAO", "LVA", "LBN", "LIE", "LTU", "LUX", "MAC", "MKD", "MDG", "MWI", "MYS", "MDV", "MLI", "MLT", "MHL", "MTQ", "MRT", "MUS", "MYT", "MEX", "MDA", "MCO", "MNG", "MSR", "MAR", "MOZ", "NAM", "NRU", "NPL", "NLD", "ANT", "NCL", "NZL", "NIC", "NER", "NGA", "NIU", "NOR", "OMN", "PAK", "PLW", "PAN", "PNG", "PRY", "PER", "PHL", "POL", "PRT", "PRI", "QAT", "ROU", "RUS", "RWA", "SHN", "KNA", "LCA", "SPM", "VCT", "SMR", "SAU", "SEN", "SYC", "SLE", "SGP", "SVK", "SVN", "SLB", "SOM", "ZAF", "ESP", "LKA", "SUR", "SWZ", "SWE", "CHE", "TWN", "TJK", "TZA", "THA", "TGO", "TON", "TTO", "TUN", "TUR", "TKM", "TCA", "TUV", "UGA", "UKR", "ARE", "URU", "UZB", "VUT", "VAT", "VEN", "VNM", "VIR", "WLF", "ESH", "WSM", "YEM", "ZMB", "ZWE", "FSM", "REU", "MNE", "SRB" ], "type": "string", "description": "Filter results to show only items that can be shipped to the selected country. Leave blank to use eBay default (based on your IP location)." }, "shipToZipCode": { "title": "Ship-to ZIP Code (USA only)", "type": "string", "description": "US ZIP code for more precise location filtering. Only applies when Ship-to Country is USA. E.g. 10001 for Manhattan, 90210 for Beverly Hills." }, "minPrice": { "title": "Min Price (USD)", "minimum": 0, "type": "number", "description": "Minimum item price in USD. Leave blank for no lower limit." }, "maxPrice": { "title": "Max Price (USD)", "minimum": 0, "type": "number", "description": "Maximum item price in USD. Leave blank for no upper limit." } } }, "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 } } } } } } } } } } ```