# eBay Motors Vehicle & Parts Scraper (`crawlerbros/ebay-motors-scraper`) Actor Scrape eBay Motors listings for cars, trucks, motorcycles, boats, RVs, ATVs, and parts. Search by keyword, vehicle type, condition, price range, and year. Returns full listing details including price, mileage, specs, seller info, and images. - **URL**: https://apify.com/crawlerbros/ebay-motors-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** E-commerce, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 7 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Motors Vehicle & Parts Scraper Extract vehicle listings, parts & accessories from eBay Motors — prices, specs, mileage, seller info, images, and more. ### What You Can Scrape - **Vehicle listings** — cars, trucks, motorcycles, boats, RVs, ATVs, commercial trucks - **Parts & accessories** — car parts, motorcycle parts, boat parts, ATV parts - **Individual listings** — enrich specific eBay Motors item URLs with full detail - **Pricing data** — asking price, auction bids, shipping costs - **Vehicle specs** — year, make, model, trim, mileage, body style, fuel type, transmission, drivetrain, color - **Seller info** — seller name, feedback score, positive percentage - **Media** — primary image, full image gallery URLs - **Listing metadata** — condition, listing type (Buy It Now / Auction / Best Offer), watch count, time remaining ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `mode` | Select | `searchVehicles` | `searchVehicles` — search by keyword and vehicle type; `searchParts` — search parts & accessories; `byListingUrls` — scrape specific listing URLs | | `searchQuery` | Text | `toyota camry` | Keyword(s) to search for (e.g., "honda civic", "ford mustang gt") | | `vehicleType` | Select | `cars-trucks` | Vehicle category for `searchVehicles` mode: Cars & Trucks, Motorcycles, Boats, RVs & Campers, ATVs, Commercial Trucks, Other | | `partCategory` | Select | `car-truck-parts` | Parts category for `searchParts` mode: Car & Truck Parts, Motorcycle Parts, Boat Parts, ATV Parts, Other | | `condition` | Select | `all` | Filter by condition: All, New, Used, Certified Pre-Owned, For Parts/Not Working | | `sortBy` | Select | `best-match` | Sort order: Best Match, Price Lowest, Price Highest, Newly Listed, Ending Soonest, Distance Nearest | | `minPrice` | Integer | — | Minimum listing price in USD | | `maxPrice` | Integer | — | Maximum listing price in USD | | `minYear` | Integer | — | Minimum model year (e.g., 2015) | | `maxYear` | Integer | — | Maximum model year (e.g., 2024) | | `startUrls` | List | — | eBay Motors listing URLs for `byListingUrls` mode | | `maxItems` | Integer | `50` | Maximum number of listings to return (1–5000) | ### Output Each record in the dataset contains: | Field | Type | Description | |-------|------|-------------| | `listingId` | String | eBay item ID | | `title` | String | Full listing title | | `url` | String | Canonical eBay listing URL | | `price` | Float | Numeric price in USD | | `priceFormatted` | String | Formatted price (e.g., "$22,500") | | `originalPrice` | Float | Original price before discount (if on sale) | | `condition` | String | Listing condition (e.g., "Used", "New") | | `mileage` | Integer | Vehicle mileage (if available) | | `year` | Integer | Model year | | `make` | String | Vehicle make (e.g., "Toyota") | | `model` | String | Vehicle model (e.g., "Camry") | | `trim` | String | Trim level (e.g., "SE", "XLE") | | `bodyStyle` | String | Body style (e.g., "Sedan", "SUV") | | `fuelType` | String | Fuel type (e.g., "Gasoline", "Electric") | | `transmission` | String | Transmission type | | `drivetrain` | String | Drivetrain (e.g., "FWD", "AWD", "4WD") | | `exteriorColor` | String | Exterior color | | `sellerName` | String | Seller username | | `sellerUrl` | String | Seller profile URL | | `sellerFeedbackScore` | Integer | eBay feedback score | | `sellerPositivePercent` | Float | Positive feedback percentage | | `shippingCost` | Float | Shipping cost in USD (0.0 = free) | | `shippingType` | String | Shipping type: "Free", "Calculated", "Freight" | | `location` | String | Seller location (city, state) | | `imageUrl` | String | Primary listing image URL | | `images` | List | All listing image URLs | | `listingType` | String | "BuyItNow", "Auction", or "BestOffer" | | `timeRemaining` | String | Time remaining on auction | | `bids` | Integer | Number of bids (auction listings) | | `watchCount` | Integer | Number of watchers | | `viewCount` | Integer | Number of views | | `vehicleType` | String | Vehicle category (e.g., "cars-trucks") | | `partType` | String | Part category (for parts listings) | | `recordType` | String | Always `"ebayMotorsListing"` | | `scrapedAt` | String | ISO 8601 timestamp when scraped | ### Example Output ```json { "listingId": "256789012345", "title": "2020 Toyota Camry SE Sedan 4D — Clean Title", "url": "https://www.ebay.com/itm/256789012345", "price": 22500.0, "priceFormatted": "$22,500", "condition": "Used", "mileage": 45000, "year": 2020, "make": "Toyota", "model": "Camry", "trim": "SE", "bodyStyle": "Sedan", "fuelType": "Gasoline", "transmission": "Automatic", "drivetrain": "FWD", "exteriorColor": "Midnight Black", "sellerName": "auto_dealership_la", "sellerFeedbackScore": 2847, "sellerPositivePercent": 99.2, "shippingType": "Free", "shippingCost": 0.0, "location": "Los Angeles, CA", "imageUrl": "https://i.ebayimg.com/images/g/abcdef/s-l1600.jpg", "images": ["https://i.ebayimg.com/images/g/abcdef/s-l1600.jpg"], "listingType": "BuyItNow", "watchCount": 42, "vehicleType": "cars-trucks", "recordType": "ebayMotorsListing", "scrapedAt": "2026-05-15T10:30:00+00:00" } ```` ### FAQ **Q: What vehicle types can I search?** A: The scraper supports Cars & Trucks, Motorcycles, Boats, RVs & Campers, ATVs/UTVs/Snowmobiles, Commercial Trucks, and Other Vehicles. Select the appropriate `vehicleType` in `searchVehicles` mode. **Q: Can I search for parts and accessories?** A: Yes, set `mode` to `searchParts` and pick the `partCategory` (Car & Truck Parts, Motorcycle Parts, Boat Parts, ATV Parts, or Other). **Q: How do I scrape a specific listing I found on eBay Motors?** A: Set `mode` to `byListingUrls` and add the eBay item URLs (like `https://www.ebay.com/itm/123456789`) to the `startUrls` field. **Q: Can I filter by price range and model year?** A: Yes. Use `minPrice`/`maxPrice` for price filtering and `minYear`/`maxYear` to restrict by model year. All filters can be combined. **Q: How many listings can I scrape?** A: Up to 5,000 listings per run by setting `maxItems`. eBay paginates at 25 listings per page, so larger runs require multiple page fetches. **Q: Does this scrape auction listings?** A: Yes. Auction listings include `bids`, `timeRemaining`, and `listingType: "Auction"` in the output. **Q: What data is available for parts listings?** A: Parts listings return the same fields as vehicle listings where applicable (title, price, condition, seller info, images, shipping) plus a `partType` field identifying the parts category. **Q: Why might some fields be missing?** A: Not every listing includes all fields — for example, a private seller may not list mileage, or a parts listing won't have year/make/model. The scraper only outputs fields it can reliably extract; null/empty fields are omitted. # Actor input Schema ## `mode` (type: `string`): Choose what to scrape: search for vehicles, search for parts, or enrich specific listing URLs. ## `searchQuery` (type: `string`): Keyword(s) to search for (optional). When empty, browses trending vehicles in the selected category. Example: 'toyota camry', 'honda civic'. ## `vehicleType` (type: `string`): Category of vehicle to search (used in searchVehicles mode). ## `partCategory` (type: `string`): Category of parts to search (used in searchParts mode). ## `condition` (type: `string`): Filter listings by condition. ## `sortBy` (type: `string`): How to sort the search results. ## `minPrice` (type: `integer`): Minimum listing price in USD. ## `maxPrice` (type: `integer`): Maximum listing price in USD. ## `minYear` (type: `integer`): Minimum model year (e.g., 2015). ## `maxYear` (type: `integer`): Maximum model year (e.g., 2024). ## `startUrls` (type: `array`): Specific eBay Motors listing URLs to scrape (used in byListingUrls mode). Each should be an eBay item URL like https://www.ebay.com/itm/123456789. ## `maxItems` (type: `integer`): Maximum number of listings to scrape. ## Actor input object example ```json { "mode": "searchVehicles", "vehicleType": "cars-trucks", "partCategory": "car-truck-parts", "condition": "all", "sortBy": "best-match", "startUrls": [], "maxItems": 50 } ``` # Actor output Schema ## `listings` (type: `string`): Dataset containing all scraped eBay Motors vehicle and parts listings. # 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 = { "mode": "searchVehicles", "vehicleType": "cars-trucks", "partCategory": "car-truck-parts", "condition": "all", "sortBy": "best-match", "startUrls": [], "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/ebay-motors-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 = { "mode": "searchVehicles", "vehicleType": "cars-trucks", "partCategory": "car-truck-parts", "condition": "all", "sortBy": "best-match", "startUrls": [], "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/ebay-motors-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 '{ "mode": "searchVehicles", "vehicleType": "cars-trucks", "partCategory": "car-truck-parts", "condition": "all", "sortBy": "best-match", "startUrls": [], "maxItems": 50 }' | apify call crawlerbros/ebay-motors-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/ebay-motors-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "eBay Motors Vehicle & Parts Scraper", "description": "Scrape eBay Motors listings for cars, trucks, motorcycles, boats, RVs, ATVs, and parts. Search by keyword, vehicle type, condition, price range, and year. Returns full listing details including price, mileage, specs, seller info, and images.", "version": "1.0", "x-build-id": "OnK5yGyEUclbWQwGZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~ebay-motors-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-ebay-motors-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/crawlerbros~ebay-motors-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-ebay-motors-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/crawlerbros~ebay-motors-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-ebay-motors-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", "properties": { "mode": { "title": "Scraping Mode", "enum": [ "searchVehicles", "searchParts", "byListingUrls" ], "type": "string", "description": "Choose what to scrape: search for vehicles, search for parts, or enrich specific listing URLs.", "default": "searchVehicles" }, "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword(s) to search for (optional). When empty, browses trending vehicles in the selected category. Example: 'toyota camry', 'honda civic'." }, "vehicleType": { "title": "Vehicle Type", "enum": [ "cars-trucks", "motorcycles", "boats", "rvs-campers", "atvs-utvs-snowmobiles", "commercial-trucks", "other-vehicles" ], "type": "string", "description": "Category of vehicle to search (used in searchVehicles mode).", "default": "cars-trucks" }, "partCategory": { "title": "Part Category", "enum": [ "car-truck-parts", "motorcycle-parts", "boat-parts", "atv-parts", "other" ], "type": "string", "description": "Category of parts to search (used in searchParts mode).", "default": "car-truck-parts" }, "condition": { "title": "Condition", "enum": [ "all", "new", "used", "certified-pre-owned", "for-parts-not-working" ], "type": "string", "description": "Filter listings by condition.", "default": "all" }, "sortBy": { "title": "Sort By", "enum": [ "best-match", "price-asc", "price-desc", "distance-nearest", "newly-listed", "ending-soonest" ], "type": "string", "description": "How to sort the search results.", "default": "best-match" }, "minPrice": { "title": "Minimum Price ($)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Minimum listing price in USD." }, "maxPrice": { "title": "Maximum Price ($)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Maximum listing price in USD." }, "minYear": { "title": "Minimum Year", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Minimum model year (e.g., 2015)." }, "maxYear": { "title": "Maximum Year", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Maximum model year (e.g., 2024)." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Specific eBay Motors listing URLs to scrape (used in byListingUrls mode). Each should be an eBay item URL like https://www.ebay.com/itm/123456789.", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of listings to scrape.", "default": 50 } } }, "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 } } } } } } } } } } ```