# EBay Scraper (Cheap) (`data_api/ebay-scraper-cheap`) Actor eBay Search Scraper collects product listings from any eBay search URL, so you can track prices, monitor availability, and pull structured data into spreadsheets, databases, or comparison tools without writing a single line of code. - **URL**: https://apify.com/data\_api/ebay-scraper-cheap.md - **Developed by:** [Data API](https://apify.com/data_api) (community) - **Categories:** Automation, E-commerce, Developer tools - **Stats:** 2 total users, 1 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. 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 Product Scraper ![eBay Product Scraper](cover.jpg) Copying eBay products into a spreadsheet by hand is slow, and the page makes it harder than it should be. Sponsored cards sit next to real results, prices come in whatever currency the seller used, and the seller name is buried in small side text. This scraper reads a whole eBay search results page and hands back every product as a clean row: name, price, currency, condition, delivery, seller, and a direct link. Set up your search on eBay, copy the URL, paste it here, then export the lot as JSON, CSV, or Excel. ### What you get Each product on the search page becomes one tidy row with the same set of columns every time, so the output drops straight into a sheet or database. Fields that eBay doesn't show for a given listing come back as `null` rather than disappearing. You get: - **Product basics** — `itemNumber`, `productName`, `currentPrice`, `currencyCode`, `itemCondition`, `imageLink`, `productUrl` - **Selling signals** — `deliveryInfo`, `shipsFrom`, `unitsSold`, `watcherCount`, `sponsoredFlag` - **Seller** — `sellerHandle`, `sellerRating` - **Run metadata** — `sourceUrl`, `collectedAt` ### Quick start 1. On eBay, search for what you want and apply any keyword, category, price, or sort filter. 2. Copy the search results URL from your browser's address bar. 3. Open the input form, paste it into **eBay search results URL**, and adjust **Request timeout** only if needed. 4. Press **Start**, then download the results as JSON, CSV, Excel, or XML once the run finishes. ![How it works](how-it-works.jpg) ### Use cases - **Price tracking** — pull a search every day and watch how prices and conditions shift over time - **Reseller sourcing** — scan a niche for underpriced items, sold counts, and active watchers worth a bid - **Competitive research** — see who is selling what, at which price, and how their listings are positioned - **Catalog building** — turn a category search into a structured product list with images and links - **Market sizing** — measure how many listings, sellers, and conditions exist for a product line - **Dropshipping research** — gather candidate products with prices, shipping notes, and seller handles in one pass ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchPageUrl` | string | Yes | The eBay search results URL to read. Build it on eBay with your filters applied, then paste the link. One results page is read per run. | | `timeoutSeconds` | integer | No | Seconds to wait for the page before giving up on a request. Default `45`; raise it if you see timeouts. | #### Example input ```json { "searchPageUrl": "https://www.ebay.com/sch/i.html?_nkw=mechanical+keyboard&_sop=12", "timeoutSeconds": 45 } ```` ### Output Every product found on the search page becomes one row, and all fields are present on each row — anything eBay didn't display comes back as `null` so the dataset stays rectangular. #### Example output ```json { "itemNumber": "296812345678", "productName": "Mechanical Gaming Keyboard RGB Backlit Hot-Swappable Brown Switch", "currentPrice": "59.99", "currencyCode": "USD", "itemCondition": "Brand New", "deliveryInfo": "Free shipping", "shipsFrom": "Portland, Oregon", "unitsSold": "238 sold", "watcherCount": "27 watchers", "sellerHandle": "keyboard_corner", "sellerRating": "99.6% positive", "productUrl": "https://www.ebay.com/itm/296812345678", "imageLink": "https://i.ebayimg.com/thumbs/images/g/abcAAOSwxxxx/s-l300.jpg", "sponsoredFlag": false, "sourceUrl": "https://www.ebay.com/sch/i.html?_nkw=mechanical+keyboard&_sop=12", "collectedAt": "2026-06-29T12:00:00.000000+00:00" } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `itemNumber` | string | eBay's numeric identifier for the product | | `productName` | string | Listing headline as shown in search results | | `currentPrice` | string | Price as a plain number string; may be a range for combo listings | | `currencyCode` | string | Three-letter currency code worked out from the price symbol | | `itemCondition` | string | Condition label such as New, Used, or Refurbished | | `deliveryInfo` | string | Shipping cost or delivery note printed on the card | | `shipsFrom` | string | Where the item is located, when eBay shows it | | `unitsSold` | string | How many have sold, when that figure appears | | `watcherCount` | string | Number of people watching, when eBay surfaces it | | `sellerHandle` | string | Public eBay username of the seller | | `sellerRating` | string | Seller feedback score or positive percentage, when shown | | `productUrl` | string | Direct link to the full eBay listing page | | `imageLink` | string | URL of the main thumbnail image | | `sponsoredFlag` | boolean | True when the listing is a paid sponsored placement | | `sourceUrl` | string | The search results URL this product came from | | `collectedAt` | string | ISO 8601 UTC timestamp of when the row was captured | ### Tips for best results - **Filter on eBay first.** Set category, price band, condition, and sort order on eBay before copying the URL — the scraper reads exactly what that page shows. - **Sort by newest with `_sop=12`.** Adding it to the URL puts the freshest listings at the top, which is handy for daily price tracking. - **Expect some empty cells.** `unitsSold`, `watcherCount`, and `shipsFrom` only fill in when eBay prints them on the card; a `null` there is normal, not a failure. - **Watch the sponsored flag.** Sponsored cards sit alongside organic results; filter on `sponsoredFlag` if you want only the unpaid listings. - **Raise `timeoutSeconds` on a slow run.** If a run reports timeouts, bump it toward 90 and try again. ### How can I use eBay product data? **How can I use the eBay Product Scraper to track prices over time?** Save the search URL for the product you care about, run the scraper on a schedule, and keep each day's output. Comparing `currentPrice`, `itemCondition`, and `unitsSold` across runs shows you how a market moves — useful for repricing your own listings or timing a buy. **How can I find profitable products to resell from eBay search results?** Search a niche, sort by newest or by best match, and run it. The rows give you `currentPrice`, `deliveryInfo`, `unitsSold`, and `watcherCount` side by side, so you can spot items that are selling well or drawing watchers and judge margins before you bid or list your own. **How can I export eBay listings to a spreadsheet without copying them by hand?** Paste your eBay search URL, press Start, and download the dataset as CSV or Excel. Every product on the page lands as a row with name, price, currency, condition, seller, and a direct link — a full export of the search in one run, no manual copy-paste. ### Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Support Questions, feature requests, or a field you'd like added? Reach out at and we'll get back to you. # Actor input Schema ## `searchPageUrl` (type: `string`): Paste the eBay search results URL you want to pull products from. Build it on eBay first with any keyword, category, price, or sort filter applied, then copy the link. One results page is read per run. ## `timeoutSeconds` (type: `integer`): How long to wait for the page before giving up on a single request. Raise it if the run reports frequent timeouts. ## Actor input object example ```json { "searchPageUrl": "https://www.ebay.com/sch/i.html?_nkw=vintage+film+camera&_sacat=0", "timeoutSeconds": 45 } ``` # 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 = { "searchPageUrl": "https://www.ebay.com/sch/i.html?_nkw=mechanical+keyboard&_sop=12" }; // Run the Actor and wait for it to finish const run = await client.actor("data_api/ebay-scraper-cheap").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 = { "searchPageUrl": "https://www.ebay.com/sch/i.html?_nkw=mechanical+keyboard&_sop=12" } # Run the Actor and wait for it to finish run = client.actor("data_api/ebay-scraper-cheap").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 '{ "searchPageUrl": "https://www.ebay.com/sch/i.html?_nkw=mechanical+keyboard&_sop=12" }' | apify call data_api/ebay-scraper-cheap --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=data_api/ebay-scraper-cheap", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "EBay Scraper (Cheap)", "description": "eBay Search Scraper collects product listings from any eBay search URL, so you can track prices, monitor availability, and pull structured data into spreadsheets, databases, or comparison tools without writing a single line of code.", "version": "0.0", "x-build-id": "Cr4RdgwU9i2EcgKt8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_api~ebay-scraper-cheap/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_api-ebay-scraper-cheap", "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/data_api~ebay-scraper-cheap/runs": { "post": { "operationId": "runs-sync-data_api-ebay-scraper-cheap", "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/data_api~ebay-scraper-cheap/run-sync": { "post": { "operationId": "run-sync-data_api-ebay-scraper-cheap", "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": [ "searchPageUrl" ], "properties": { "searchPageUrl": { "title": "eBay search results URL", "type": "string", "description": "Paste the eBay search results URL you want to pull products from. Build it on eBay first with any keyword, category, price, or sort filter applied, then copy the link. One results page is read per run." }, "timeoutSeconds": { "title": "Request timeout (seconds)", "minimum": 10, "maximum": 180, "type": "integer", "description": "How long to wait for the page before giving up on a single request. Raise it if the run reports frequent timeouts.", "default": 45 } } }, "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 } } } } } } } } } } ```