{
  "data": {
    "id": "Bn0UdOQIp6XVgxUMu",
    "actId": "DJR9OayaE47kxYQcl",
    "userId": "zq8lKbpLzTjGDayPC",
    "startedAt": "2026-11-09T06:44:04.575Z",
    "finishedAt": "2026-11-09T06:44:36.178Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 31535,
      "runTimeSecs": 31.535,
      "computeUnits": 0.03503888888888889,
      "imageSizeBytes": 3168972288
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "GK9YjZRyQZVzOdoH5",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"eBay Motors Vehicle & Parts Scraper Input\",\n  \"description\": \"Search eBay Motors vehicles or parts, or enrich specific item URLs. Filters cover vehicle type, condition, price, model year, mileage, transmission, fuel type, buying format, seller and ZIP radius.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Scraping Mode\",\n      \"type\": \"string\",\n      \"description\": \"Search vehicle listings, search parts & accessories, or enrich specific listing IDs/URLs.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"searchVehicles\",\n        \"searchParts\",\n        \"byListingUrls\"\n      ],\n      \"enumTitles\": [\n        \"Search Vehicles\",\n        \"Search Parts & Accessories\",\n        \"By Listing URLs\"\n      ],\n      \"default\": \"searchVehicles\",\n      \"prefill\": \"searchVehicles\"\n    },\n    \"searchQuery\": {\n      \"title\": \"Search Query\",\n      \"type\": \"string\",\n      \"description\": \"Keyword(s) to search for, e.g. 'toyota camry' or 'brake pads'. Leave empty in searchVehicles mode to browse eBay's trending vehicles for the selected category.\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"honda civic\"\n    },\n    \"vehicleType\": {\n      \"title\": \"Vehicle Type\",\n      \"type\": \"string\",\n      \"description\": \"Vehicle category used in searchVehicles mode.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"cars-trucks\",\n        \"motorcycles\",\n        \"boats\",\n        \"rvs-campers\",\n        \"atvs-utvs-snowmobiles\",\n        \"commercial-trucks\",\n        \"other-vehicles\"\n      ],\n      \"enumTitles\": [\n        \"Cars & Trucks\",\n        \"Motorcycles\",\n        \"Boats\",\n        \"RVs & Campers\",\n        \"ATVs, UTVs & Snowmobiles\",\n        \"Commercial Trucks\",\n        \"Other Vehicles\"\n      ],\n      \"prefill\": \"cars-trucks\"\n    },\n    \"partCategory\": {\n      \"title\": \"Part Category\",\n      \"type\": \"string\",\n      \"description\": \"Parts category used in searchParts mode.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"car-truck-parts\",\n        \"motorcycle-parts\",\n        \"boat-parts\",\n        \"atv-parts\",\n        \"other\"\n      ],\n      \"enumTitles\": [\n        \"Car & Truck Parts\",\n        \"Motorcycle Parts\",\n        \"Boat Parts\",\n        \"ATV & UTV Parts\",\n        \"Other Parts\"\n      ],\n      \"prefill\": \"car-truck-parts\"\n    },\n    \"condition\": {\n      \"title\": \"Condition\",\n      \"type\": \"string\",\n      \"description\": \"Filter listings by condition.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"new\",\n        \"used\",\n        \"certified-pre-owned\",\n        \"for-parts-not-working\"\n      ],\n      \"enumTitles\": [\n        \"All Conditions\",\n        \"New\",\n        \"Used\",\n        \"Certified Pre-Owned\",\n        \"For Parts / Not Working\"\n      ],\n      \"prefill\": \"all\"\n    },\n    \"buyingFormat\": {\n      \"title\": \"Buying Format\",\n      \"type\": \"string\",\n      \"description\": \"Restrict results to Buy It Now or auction listings. 'All formats' applies no filter.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"buy-it-now\",\n        \"auction\"\n      ],\n      \"enumTitles\": [\n        \"All Formats\",\n        \"Buy It Now\",\n        \"Auction\"\n      ],\n      \"prefill\": \"all\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort By\",\n      \"type\": \"string\",\n      \"description\": \"How to order the search results.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"best-match\",\n        \"price-asc\",\n        \"price-desc\",\n        \"distance-nearest\",\n        \"newly-listed\",\n        \"ending-soonest\",\n        \"mileage-asc\",\n        \"year-newest\",\n        \"year-oldest\"\n      ],\n      \"enumTitles\": [\n        \"Best Match\",\n        \"Price: Lowest First\",\n        \"Price: Highest First\",\n        \"Distance: Nearest First\",\n        \"Newly Listed\",\n        \"Ending Soonest\",\n        \"Mileage: Lowest First\",\n        \"Year: Newest First\",\n        \"Year: Oldest First\"\n      ],\n      \"prefill\": \"best-match\"\n    },\n    \"minPrice\": {\n      \"title\": \"Minimum Price ($)\",\n      \"type\": \"integer\",\n      \"description\": \"Minimum listing price in USD.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 10000000\n    },\n    \"maxPrice\": {\n      \"title\": \"Maximum Price ($)\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum listing price in USD.\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 10000000\n    },\n    \"minYear\": {\n      \"title\": \"Minimum Model Year\",\n      \"type\": \"integer\",\n      \"description\": \"Oldest model year to include (searchVehicles mode).\",\n      \"editor\": \"number\",\n      \"minimum\": 1900,\n      \"maximum\": 2030\n    },\n    \"maxYear\": {\n      \"title\": \"Maximum Model Year\",\n      \"type\": \"integer\",\n      \"description\": \"Newest model year to include (searchVehicles mode).\",\n      \"editor\": \"number\",\n      \"minimum\": 1900,\n      \"maximum\": 2030\n    },\n    \"maxMileage\": {\n      \"title\": \"Maximum Mileage\",\n      \"type\": \"integer\",\n      \"description\": \"Highest odometer reading to include, in miles (searchVehicles mode).\",\n      \"editor\": \"number\",\n      \"minimum\": 0,\n      \"maximum\": 2000000\n    },\n    \"transmission\": {\n      \"title\": \"Transmission\",\n      \"type\": \"string\",\n      \"description\": \"Filter vehicles by transmission type.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"automatic\",\n        \"manual\"\n      ],\n      \"enumTitles\": [\n        \"All Transmissions\",\n        \"Automatic\",\n        \"Manual\"\n      ],\n      \"prefill\": \"all\"\n    },\n    \"fuelType\": {\n      \"title\": \"Fuel Type\",\n      \"type\": \"string\",\n      \"description\": \"Filter vehicles by fuel type.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"gasoline\",\n        \"diesel\",\n        \"electric\",\n        \"hybrid\"\n      ],\n      \"enumTitles\": [\n        \"All Fuel Types\",\n        \"Gasoline\",\n        \"Diesel\",\n        \"Electric\",\n        \"Hybrid\"\n      ],\n      \"prefill\": \"all\"\n    },\n    \"sellerUsername\": {\n      \"title\": \"Seller Username\",\n      \"type\": \"string\",\n      \"description\": \"Only return listings sold by this eBay seller or dealer (optional).\",\n      \"editor\": \"textfield\"\n    },\n    \"postalCode\": {\n      \"title\": \"ZIP Code\",\n      \"type\": \"string\",\n      \"description\": \"US ZIP code used with 'Distance' for local-inventory searches (optional).\",\n      \"editor\": \"textfield\"\n    },\n    \"distanceMiles\": {\n      \"title\": \"Distance (miles)\",\n      \"type\": \"string\",\n      \"description\": \"Radius around the ZIP code. Requires a ZIP code.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"10\",\n        \"25\",\n        \"50\",\n        \"100\",\n        \"200\",\n        \"500\",\n        \"1000\",\n        \"2000\"\n      ],\n      \"enumTitles\": [\n        \"10 miles\",\n        \"25 miles\",\n        \"50 miles\",\n        \"100 miles\",\n        \"200 miles\",\n        \"500 miles\",\n        \"1,000 miles\",\n        \"2,000 miles\"\n      ]\n    },\n    \"startUrls\": {\n      \"title\": \"Start URLs / Item IDs\",\n      \"type\": \"array\",\n      \"description\": \"eBay item URLs, bare item IDs or eBay search URLs to scrape in byListingUrls mode.\",\n      \"editor\": \"stringList\",\n      \"prefill\": []\n    },\n    \"maxItems\": {\n      \"title\": \"Max Items\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum number of listings to return (1–10,000).\",\n      \"editor\": \"number\",\n      \"minimum\": 1,\n      \"maximum\": 10000,\n      \"prefill\": 3\n    },\n    \"maxPages\": {\n      \"title\": \"Max Pages\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum search result pages to request. eBay caps every query at 200 pages.\",\n      \"editor\": \"number\",\n      \"minimum\": 1,\n      \"maximum\": 200,\n      \"prefill\": 1\n    },\n    \"includeItemSpecifics\": {\n      \"title\": \"Include Full Item Specifics\",\n      \"type\": \"boolean\",\n      \"description\": \"Attach the complete item-specifics table to listing-detail records (byListingUrls mode).\",\n      \"default\": true,\n      \"prefill\": true\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# eBay Motors Search & Listing Detail Extractor\n\neBay Motors lists vehicles and parts from private sellers and dealers across the US. This actor runs a vehicle or parts search, or opens specific item pages you already have, and returns structured records with pricing, vehicle identity, title status, VIN, mileage, seller details, returns and images.\n\n## What this actor does\n\n- Searches eBay Motors vehicle listings by keyword, vehicle category (cars & trucks, motorcycles, boats, RVs, ATVs, commercial trucks), condition, price range, model-year range, maximum mileage, transmission, fuel type, buying format, seller and ZIP-radius search\n- Searches parts & accessories by keyword, parts category, condition, price and buying format\n- Enriches specific item URLs, bare item IDs or saved search URLs with full listing detail instead of running a new search\n- Paginates at eBay's 240-row page size through up to 200 result pages, with cross-page deduplication\n- Omits empty fields from every record — a field appears only when the listing actually shows that data\n\n## Modes\n\n| Mode | What it returns |\n|---|---|\n| `searchVehicles` | Vehicle search-result records |\n| `searchParts` | Parts & accessories search-result records |\n| `byListingUrls` | Full detail records for item IDs/URLs; search URLs are parsed as search-result pages |\n\n## Output per listing\n\nCore fields:\n\n- `listingId` — eBay item ID\n- `title` — full listing title\n- `url` — canonical eBay listing URL\n- `price` — numeric price\n- `priceFormatted` — price as displayed (e.g. `$22,500.00`)\n- `currency` — currency code for `price`\n- `originalPrice`, `discountPercent` — pre-discount price and markdown, when shown\n- `condition` — listing condition (e.g. `Used`, `Pre-Owned`)\n- `titleStatus` — vehicle title status (e.g. `Clean`, `Salvage`), when shown\n- `vin` — Vehicle Identification Number (detail pages, when eBay prints it)\n- `year`, `make`, `model`, `trim`, `submodel` — vehicle identity\n- `bodyStyle`, `fuelType`, `transmission`, `drivetrain`, `exteriorColor`, `interiorColor`\n- `engine`, `cylinders`, `doors`, `seats` — engine and body configuration\n- `mileage` — odometer reading in miles\n- `categoryPath` — eBay breadcrumb for the listing (`eBay > eBay Motors > …`)\n- `itemSpecifics` — complete item-specifics table (detail mode, when `includeItemSpecifics` is on)\n- `warranty`, `countryOfOrigin`, `forSaleBy`, `sellerNotes`\n- `sellerName`, `sellerUrl`, `sellerFeedbackScore`, `sellerPositivePercent`, `sellerFeedbackPercent`, `sellerFeedbackCount`\n- `dealerName`, `dealerFeedbackPercent`, `dealerFeedbackCount` — dealer block on Motors search cards\n- `storeName`, `storeUrl`, `isTopRatedSeller`\n- `shippingCost`, `shippingType`, `shippingEstimatedDelivery`\n- `returnsAccepted`, `returnDays`, `paymentMethods`\n- `location`, `deliveryOrPickupAvailable`\n- `imageUrl`, `images`, `imageCount`\n- `listingType` — `BuyItNow`, `Auction` or `BestOffer`\n- `bestOfferEnabled`, `timeRemaining`, `bids`, `watchCount`, `viewCount`, `soldCount`\n- `quantityAvailable`\n- `isSponsored` — present and `true` only on sponsored search cards\n- `vehicleType` — vehicle category searched (e.g. `cars-trucks`)\n- `partType`, `brand`, `mpn`, `partNumber`, `placementOnVehicle` — parts fields when shown\n- `isTrendingRecommendation` — present and `true` only when `searchVehicles` runs with no keyword and no filters, meaning eBay served its curated \"Trending Vehicles\" module\n- `recordType` — always `ebayMotorsListing`\n- `scrapedAt` — ISO 8601 UTC timestamp\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `searchVehicles` | `searchVehicles`, `searchParts`, or `byListingUrls` |\n| `searchQuery` | string | – | Keyword(s), e.g. `honda civic`. Empty in `searchVehicles` mode browses trending vehicles for the selected category |\n| `vehicleType` | string | – (defaults to `cars-trucks`) | Vehicle category for `searchVehicles` |\n| `partCategory` | string | – (defaults to `car-truck-parts`) | Parts category for `searchParts` |\n| `condition` | string | – (defaults to `all`) | `all`, `new`, `used`, `certified-pre-owned`, `for-parts-not-working` |\n| `buyingFormat` | string | – (defaults to `all`) | `all`, `buy-it-now`, `auction` |\n| `sortBy` | string | – (defaults to `best-match`) | `best-match`, `price-asc`, `price-desc`, `distance-nearest`, `newly-listed`, `ending-soonest`, `mileage-asc`, `year-newest`, `year-oldest` (last three are vehicle-mode sorts) |\n| `minPrice`, `maxPrice` | integer | – | Price range in USD |\n| `minYear`, `maxYear` | integer | – | Model-year range (`searchVehicles`) |\n| `maxMileage` | integer | – | Maximum odometer reading in miles (`searchVehicles`) |\n| `transmission` | string | – (defaults to `all`) | `all`, `automatic`, `manual` |\n| `fuelType` | string | – (defaults to `all`) | `all`, `gasoline`, `diesel`, `electric`, `hybrid` |\n| `sellerUsername` | string | – | Only listings from this seller/dealer |\n| `postalCode` | string | – | US ZIP for local-inventory searches |\n| `distanceMiles` | string | – | Radius around the ZIP: `10` … `2000` |\n| `startUrls` | array | – | Item URLs, bare item IDs or search URLs for `byListingUrls` |\n| `maxItems` | integer | – (defaults to `50`) | Maximum listings to return (1–10,000) |\n| `maxPages` | integer | – (defaults to `200`) | Maximum result pages to request (eBay caps each query at 200) |\n| `includeItemSpecifics` | boolean | `true` | Attach the full item-specifics table to detail records |\n\n### Example: used Honda Civics under $15,000\n\n```json\n{\n  \"mode\": \"searchVehicles\",\n  \"searchQuery\": \"honda civic\",\n  \"condition\": \"used\",\n  \"maxPrice\": 15000,\n  \"maxItems\": 50\n}\n```\n\n### Example: 2015–2020 automatic trucks with under 80,000 miles\n\n```json\n{\n  \"mode\": \"searchVehicles\",\n  \"searchQuery\": \"ford f-150\",\n  \"vehicleType\": \"cars-trucks\",\n  \"minYear\": 2015,\n  \"maxYear\": 2020,\n  \"maxMileage\": 80000,\n  \"transmission\": \"automatic\",\n  \"sortBy\": \"mileage-asc\",\n  \"maxItems\": 100\n}\n```\n\n### Example: motorcycle parts search\n\n```json\n{\n  \"mode\": \"searchParts\",\n  \"partCategory\": \"motorcycle-parts\",\n  \"searchQuery\": \"exhaust system\",\n  \"maxItems\": 100\n}\n```\n\n### Example: enrich specific listings\n\n```json\n{\n  \"mode\": \"byListingUrls\",\n  \"startUrls\": [\n    \"https://www.ebay.com/itm/256789012345\",\n    \"256789012346\"\n  ],\n  \"includeItemSpecifics\": true\n}\n```\n\n## Use cases\n\n- **Vehicle shopping research** — compare price, mileage, title status and VIN across every matching listing\n- **Dealer inventory tracking** — re-run a seller search or ZIP-radius search to see what changed\n- **Parts sourcing** — search a parts category and keyword to compare available stock and pricing\n- **Auction monitoring** — track bids, time remaining and watchers on listings you are bidding on\n- **Listing enrichment** — feed a list of item IDs or URLs into `byListingUrls` for full structured detail\n\n## FAQ\n\n**What is the difference between the three modes?** `searchVehicles` and `searchParts` run an eBay Motors search with your filters. `byListingUrls` skips search and opens exactly the item URLs or IDs you supply; search URLs passed there are parsed as search-result pages.\n\n**Which filters actually work on eBay Motors?** Price, condition, model year, transmission, fuel type, buying format, seller, ZIP radius and sort order are eBay's own server-side parameters. There is no reliable server-side maximum-mileage parameter, so `maxMileage` is applied by the actor after parsing — a tight cap may need more pages to fill `maxItems`. Listings with no printed mileage are kept rather than dropped blindly.\n\n**Why is VIN or title status missing on some records?** eBay prints VIN on most dealer detail pages but omits it for some private/classified listings. Title status appears on Motors cards and detail pages when the seller provides it. Both fields are omitted rather than guessed.\n\n**What is in `itemSpecifics`?** The detail page's full `dt`/`dd` specification table (VIN, engine, colours, warranty, country of origin, and any other rows eBay prints). Turn `includeItemSpecifics` off to keep records smaller.\n\n**Why do I get `isTrendingRecommendation: true` records?** That only happens in `searchVehicles` mode when you leave `searchQuery` empty and apply no vehicle filter — eBay shows a curated \"Trending Vehicles\" module instead of a real search page. Add a keyword or any filter for genuine matches.\n\n**How many listings can one run return?** Up to `maxItems`, capped at 10,000. Pages hold up to 240 cards and eBay caps every query at 200 pages; split by category, price or mileage for larger sweeps.\n\n**Does this include sold or ended listings?** No. Sold/completed results require an eBay sign-in, and this actor never asks for cookies or logins.\n\n**Do I need a proxy or API key?** No. The actor tries a direct request, then a public cookieless mirror, then an Apify proxy if needed, and chooses automatically. There are no credentials to configure.\n\n**Is this affiliated with eBay?** No. This is an independent, third-party actor that reads eBay Motors' public listing pages; it is not operated by or affiliated with eBay Inc.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "ebay-motors-search-and-listing-detail-extractor",
      "title": "eBay Motors Search & Listing Detail Extractor",
      "description": "Search eBay Motors vehicles or parts by keyword, type, condition, price, year, mileage, transmission, fuel and buying format, or enrich item URLs — returns price, VIN, mileage, specs, seller/dealer info, returns, payment methods and images per listing.",
      "version": "1.0",
      "minMemoryMbytes": 1024,
      "buildTag": "latest",
      "defaultRunOptions": {
        "build": "latest",
        "timeoutSecs": 3600,
        "memoryMbytes": 1024
      },
      "dockerfile": "./Dockerfile",
      "readme": "# eBay Motors Search & Listing Detail Extractor\n\neBay Motors lists vehicles and parts from private sellers and dealers across the US. This actor runs a vehicle or parts search, or opens specific item pages you already have, and returns structured records with pricing, vehicle identity, title status, VIN, mileage, seller details, returns and images.\n\n## What this actor does\n\n- Searches eBay Motors vehicle listings by keyword, vehicle category (cars & trucks, motorcycles, boats, RVs, ATVs, commercial trucks), condition, price range, model-year range, maximum mileage, transmission, fuel type, buying format, seller and ZIP-radius search\n- Searches parts & accessories by keyword, parts category, condition, price and buying format\n- Enriches specific item URLs, bare item IDs or saved search URLs with full listing detail instead of running a new search\n- Paginates at eBay's 240-row page size through up to 200 result pages, with cross-page deduplication\n- Omits empty fields from every record — a field appears only when the listing actually shows that data\n\n## Modes\n\n| Mode | What it returns |\n|---|---|\n| `searchVehicles` | Vehicle search-result records |\n| `searchParts` | Parts & accessories search-result records |\n| `byListingUrls` | Full detail records for item IDs/URLs; search URLs are parsed as search-result pages |\n\n## Output per listing\n\nCore fields:\n\n- `listingId` — eBay item ID\n- `title` — full listing title\n- `url` — canonical eBay listing URL\n- `price` — numeric price\n- `priceFormatted` — price as displayed (e.g. `$22,500.00`)\n- `currency` — currency code for `price`\n- `originalPrice`, `discountPercent` — pre-discount price and markdown, when shown\n- `condition` — listing condition (e.g. `Used`, `Pre-Owned`)\n- `titleStatus` — vehicle title status (e.g. `Clean`, `Salvage`), when shown\n- `vin` — Vehicle Identification Number (detail pages, when eBay prints it)\n- `year`, `make`, `model`, `trim`, `submodel` — vehicle identity\n- `bodyStyle`, `fuelType`, `transmission`, `drivetrain`, `exteriorColor`, `interiorColor`\n- `engine`, `cylinders`, `doors`, `seats` — engine and body configuration\n- `mileage` — odometer reading in miles\n- `categoryPath` — eBay breadcrumb for the listing (`eBay > eBay Motors > …`)\n- `itemSpecifics` — complete item-specifics table (detail mode, when `includeItemSpecifics` is on)\n- `warranty`, `countryOfOrigin`, `forSaleBy`, `sellerNotes`\n- `sellerName`, `sellerUrl`, `sellerFeedbackScore`, `sellerPositivePercent`, `sellerFeedbackPercent`, `sellerFeedbackCount`\n- `dealerName`, `dealerFeedbackPercent`, `dealerFeedbackCount` — dealer block on Motors search cards\n- `storeName`, `storeUrl`, `isTopRatedSeller`\n- `shippingCost`, `shippingType`, `shippingEstimatedDelivery`\n- `returnsAccepted`, `returnDays`, `paymentMethods`\n- `location`, `deliveryOrPickupAvailable`\n- `imageUrl`, `images`, `imageCount`\n- `listingType` — `BuyItNow`, `Auction` or `BestOffer`\n- `bestOfferEnabled`, `timeRemaining`, `bids`, `watchCount`, `viewCount`, `soldCount`\n- `quantityAvailable`\n- `isSponsored` — present and `true` only on sponsored search cards\n- `vehicleType` — vehicle category searched (e.g. `cars-trucks`)\n- `partType`, `brand`, `mpn`, `partNumber`, `placementOnVehicle` — parts fields when shown\n- `isTrendingRecommendation` — present and `true` only when `searchVehicles` runs with no keyword and no filters, meaning eBay served its curated \"Trending Vehicles\" module\n- `recordType` — always `ebayMotorsListing`\n- `scrapedAt` — ISO 8601 UTC timestamp\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `searchVehicles` | `searchVehicles`, `searchParts`, or `byListingUrls` |\n| `searchQuery` | string | – | Keyword(s), e.g. `honda civic`. Empty in `searchVehicles` mode browses trending vehicles for the selected category |\n| `vehicleType` | string | – (defaults to `cars-trucks`) | Vehicle category for `searchVehicles` |\n| `partCategory` | string | – (defaults to `car-truck-parts`) | Parts category for `searchParts` |\n| `condition` | string | – (defaults to `all`) | `all`, `new`, `used`, `certified-pre-owned`, `for-parts-not-working` |\n| `buyingFormat` | string | – (defaults to `all`) | `all`, `buy-it-now`, `auction` |\n| `sortBy` | string | – (defaults to `best-match`) | `best-match`, `price-asc`, `price-desc`, `distance-nearest`, `newly-listed`, `ending-soonest`, `mileage-asc`, `year-newest`, `year-oldest` (last three are vehicle-mode sorts) |\n| `minPrice`, `maxPrice` | integer | – | Price range in USD |\n| `minYear`, `maxYear` | integer | – | Model-year range (`searchVehicles`) |\n| `maxMileage` | integer | – | Maximum odometer reading in miles (`searchVehicles`) |\n| `transmission` | string | – (defaults to `all`) | `all`, `automatic`, `manual` |\n| `fuelType` | string | – (defaults to `all`) | `all`, `gasoline`, `diesel`, `electric`, `hybrid` |\n| `sellerUsername` | string | – | Only listings from this seller/dealer |\n| `postalCode` | string | – | US ZIP for local-inventory searches |\n| `distanceMiles` | string | – | Radius around the ZIP: `10` … `2000` |\n| `startUrls` | array | – | Item URLs, bare item IDs or search URLs for `byListingUrls` |\n| `maxItems` | integer | – (defaults to `50`) | Maximum listings to return (1–10,000) |\n| `maxPages` | integer | – (defaults to `200`) | Maximum result pages to request (eBay caps each query at 200) |\n| `includeItemSpecifics` | boolean | `true` | Attach the full item-specifics table to detail records |\n\n### Example: used Honda Civics under $15,000\n\n```json\n{\n  \"mode\": \"searchVehicles\",\n  \"searchQuery\": \"honda civic\",\n  \"condition\": \"used\",\n  \"maxPrice\": 15000,\n  \"maxItems\": 50\n}\n```\n\n### Example: 2015–2020 automatic trucks with under 80,000 miles\n\n```json\n{\n  \"mode\": \"searchVehicles\",\n  \"searchQuery\": \"ford f-150\",\n  \"vehicleType\": \"cars-trucks\",\n  \"minYear\": 2015,\n  \"maxYear\": 2020,\n  \"maxMileage\": 80000,\n  \"transmission\": \"automatic\",\n  \"sortBy\": \"mileage-asc\",\n  \"maxItems\": 100\n}\n```\n\n### Example: motorcycle parts search\n\n```json\n{\n  \"mode\": \"searchParts\",\n  \"partCategory\": \"motorcycle-parts\",\n  \"searchQuery\": \"exhaust system\",\n  \"maxItems\": 100\n}\n```\n\n### Example: enrich specific listings\n\n```json\n{\n  \"mode\": \"byListingUrls\",\n  \"startUrls\": [\n    \"https://www.ebay.com/itm/256789012345\",\n    \"256789012346\"\n  ],\n  \"includeItemSpecifics\": true\n}\n```\n\n## Use cases\n\n- **Vehicle shopping research** — compare price, mileage, title status and VIN across every matching listing\n- **Dealer inventory tracking** — re-run a seller search or ZIP-radius search to see what changed\n- **Parts sourcing** — search a parts category and keyword to compare available stock and pricing\n- **Auction monitoring** — track bids, time remaining and watchers on listings you are bidding on\n- **Listing enrichment** — feed a list of item IDs or URLs into `byListingUrls` for full structured detail\n\n## FAQ\n\n**What is the difference between the three modes?** `searchVehicles` and `searchParts` run an eBay Motors search with your filters. `byListingUrls` skips search and opens exactly the item URLs or IDs you supply; search URLs passed there are parsed as search-result pages.\n\n**Which filters actually work on eBay Motors?** Price, condition, model year, transmission, fuel type, buying format, seller, ZIP radius and sort order are eBay's own server-side parameters. There is no reliable server-side maximum-mileage parameter, so `maxMileage` is applied by the actor after parsing — a tight cap may need more pages to fill `maxItems`. Listings with no printed mileage are kept rather than dropped blindly.\n\n**Why is VIN or title status missing on some records?** eBay prints VIN on most dealer detail pages but omits it for some private/classified listings. Title status appears on Motors cards and detail pages when the seller provides it. Both fields are omitted rather than guessed.\n\n**What is in `itemSpecifics`?** The detail page's full `dt`/`dd` specification table (VIN, engine, colours, warranty, country of origin, and any other rows eBay prints). Turn `includeItemSpecifics` off to keep records smaller.\n\n**Why do I get `isTrendingRecommendation: true` records?** That only happens in `searchVehicles` mode when you leave `searchQuery` empty and apply no vehicle filter — eBay shows a curated \"Trending Vehicles\" module instead of a real search page. Add a keyword or any filter for genuine matches.\n\n**How many listings can one run return?** Up to `maxItems`, capped at 10,000. Pages hold up to 240 cards and eBay caps every query at 200 pages; split by category, price or mileage for larger sweeps.\n\n**Does this include sold or ended listings?** No. Sold/completed results require an eBay sign-in, and this actor never asks for cookies or logins.\n\n**Do I need a proxy or API key?** No. The actor tries a direct request, then a public cookieless mirror, then an Apify proxy if needed, and chooses automatically. There are no credentials to configure.\n\n**Is this affiliated with eBay?** No. This is an independent, third-party actor that reads eBay Motors' public listing pages; it is not operated by or affiliated with eBay Inc.\n",
      "input": {
        "title": "eBay Motors Vehicle & Parts Scraper Input",
        "description": "Search eBay Motors vehicles or parts, or enrich specific item URLs. Filters cover vehicle type, condition, price, model year, mileage, transmission, fuel type, buying format, seller and ZIP radius.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Scraping Mode",
            "type": "string",
            "description": "Search vehicle listings, search parts & accessories, or enrich specific listing IDs/URLs.",
            "editor": "select",
            "enum": [
              "searchVehicles",
              "searchParts",
              "byListingUrls"
            ],
            "enumTitles": [
              "Search Vehicles",
              "Search Parts & Accessories",
              "By Listing URLs"
            ],
            "default": "searchVehicles",
            "prefill": "searchVehicles"
          },
          "searchQuery": {
            "title": "Search Query",
            "type": "string",
            "description": "Keyword(s) to search for, e.g. 'toyota camry' or 'brake pads'. Leave empty in searchVehicles mode to browse eBay's trending vehicles for the selected category.",
            "editor": "textfield",
            "prefill": "honda civic"
          },
          "vehicleType": {
            "title": "Vehicle Type",
            "type": "string",
            "description": "Vehicle category used in searchVehicles mode.",
            "editor": "select",
            "enum": [
              "cars-trucks",
              "motorcycles",
              "boats",
              "rvs-campers",
              "atvs-utvs-snowmobiles",
              "commercial-trucks",
              "other-vehicles"
            ],
            "enumTitles": [
              "Cars & Trucks",
              "Motorcycles",
              "Boats",
              "RVs & Campers",
              "ATVs, UTVs & Snowmobiles",
              "Commercial Trucks",
              "Other Vehicles"
            ],
            "prefill": "cars-trucks"
          },
          "partCategory": {
            "title": "Part Category",
            "type": "string",
            "description": "Parts category used in searchParts mode.",
            "editor": "select",
            "enum": [
              "car-truck-parts",
              "motorcycle-parts",
              "boat-parts",
              "atv-parts",
              "other"
            ],
            "enumTitles": [
              "Car & Truck Parts",
              "Motorcycle Parts",
              "Boat Parts",
              "ATV & UTV Parts",
              "Other Parts"
            ],
            "prefill": "car-truck-parts"
          },
          "condition": {
            "title": "Condition",
            "type": "string",
            "description": "Filter listings by condition.",
            "editor": "select",
            "enum": [
              "all",
              "new",
              "used",
              "certified-pre-owned",
              "for-parts-not-working"
            ],
            "enumTitles": [
              "All Conditions",
              "New",
              "Used",
              "Certified Pre-Owned",
              "For Parts / Not Working"
            ],
            "prefill": "all"
          },
          "buyingFormat": {
            "title": "Buying Format",
            "type": "string",
            "description": "Restrict results to Buy It Now or auction listings. 'All formats' applies no filter.",
            "editor": "select",
            "enum": [
              "all",
              "buy-it-now",
              "auction"
            ],
            "enumTitles": [
              "All Formats",
              "Buy It Now",
              "Auction"
            ],
            "prefill": "all"
          },
          "sortBy": {
            "title": "Sort By",
            "type": "string",
            "description": "How to order the search results.",
            "editor": "select",
            "enum": [
              "best-match",
              "price-asc",
              "price-desc",
              "distance-nearest",
              "newly-listed",
              "ending-soonest",
              "mileage-asc",
              "year-newest",
              "year-oldest"
            ],
            "enumTitles": [
              "Best Match",
              "Price: Lowest First",
              "Price: Highest First",
              "Distance: Nearest First",
              "Newly Listed",
              "Ending Soonest",
              "Mileage: Lowest First",
              "Year: Newest First",
              "Year: Oldest First"
            ],
            "prefill": "best-match"
          },
          "minPrice": {
            "title": "Minimum Price ($)",
            "type": "integer",
            "description": "Minimum listing price in USD.",
            "editor": "number",
            "minimum": 0,
            "maximum": 10000000
          },
          "maxPrice": {
            "title": "Maximum Price ($)",
            "type": "integer",
            "description": "Maximum listing price in USD.",
            "editor": "number",
            "minimum": 0,
            "maximum": 10000000
          },
          "minYear": {
            "title": "Minimum Model Year",
            "type": "integer",
            "description": "Oldest model year to include (searchVehicles mode).",
            "editor": "number",
            "minimum": 1900,
            "maximum": 2030
          },
          "maxYear": {
            "title": "Maximum Model Year",
            "type": "integer",
            "description": "Newest model year to include (searchVehicles mode).",
            "editor": "number",
            "minimum": 1900,
            "maximum": 2030
          },
          "maxMileage": {
            "title": "Maximum Mileage",
            "type": "integer",
            "description": "Highest odometer reading to include, in miles (searchVehicles mode).",
            "editor": "number",
            "minimum": 0,
            "maximum": 2000000
          },
          "transmission": {
            "title": "Transmission",
            "type": "string",
            "description": "Filter vehicles by transmission type.",
            "editor": "select",
            "enum": [
              "all",
              "automatic",
              "manual"
            ],
            "enumTitles": [
              "All Transmissions",
              "Automatic",
              "Manual"
            ],
            "prefill": "all"
          },
          "fuelType": {
            "title": "Fuel Type",
            "type": "string",
            "description": "Filter vehicles by fuel type.",
            "editor": "select",
            "enum": [
              "all",
              "gasoline",
              "diesel",
              "electric",
              "hybrid"
            ],
            "enumTitles": [
              "All Fuel Types",
              "Gasoline",
              "Diesel",
              "Electric",
              "Hybrid"
            ],
            "prefill": "all"
          },
          "sellerUsername": {
            "title": "Seller Username",
            "type": "string",
            "description": "Only return listings sold by this eBay seller or dealer (optional).",
            "editor": "textfield"
          },
          "postalCode": {
            "title": "ZIP Code",
            "type": "string",
            "description": "US ZIP code used with 'Distance' for local-inventory searches (optional).",
            "editor": "textfield"
          },
          "distanceMiles": {
            "title": "Distance (miles)",
            "type": "string",
            "description": "Radius around the ZIP code. Requires a ZIP code.",
            "editor": "select",
            "enum": [
              "10",
              "25",
              "50",
              "100",
              "200",
              "500",
              "1000",
              "2000"
            ],
            "enumTitles": [
              "10 miles",
              "25 miles",
              "50 miles",
              "100 miles",
              "200 miles",
              "500 miles",
              "1,000 miles",
              "2,000 miles"
            ]
          },
          "startUrls": {
            "title": "Start URLs / Item IDs",
            "type": "array",
            "description": "eBay item URLs, bare item IDs or eBay search URLs to scrape in byListingUrls mode.",
            "editor": "stringList",
            "prefill": []
          },
          "maxItems": {
            "title": "Max Items",
            "type": "integer",
            "description": "Maximum number of listings to return (1–10,000).",
            "editor": "number",
            "minimum": 1,
            "maximum": 10000,
            "prefill": 3
          },
          "maxPages": {
            "title": "Max Pages",
            "type": "integer",
            "description": "Maximum search result pages to request. eBay caps every query at 200 pages.",
            "editor": "number",
            "minimum": 1,
            "maximum": 200,
            "prefill": 1
          },
          "includeItemSpecifics": {
            "title": "Include Full Item Specifics",
            "type": "boolean",
            "description": "Attach the complete item-specifics table to listing-detail records (byListingUrls mode).",
            "default": true,
            "prefill": true
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "eBay Motors Search & Listing Detail Extractor Output",
        "description": "Vehicle and parts listing records from eBay Motors with price, VIN, year/make/model, mileage, title status, condition, transmission, drivetrain, seller/dealer info, returns, payment methods, item specifics and images.",
        "properties": {
          "listings": {
            "type": "string",
            "title": "eBay Motors Listings",
            "description": "Dataset containing all scraped eBay Motors vehicle and parts listings.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "eBay Motors Listings",
              "transformation": {
                "fields": [
                  "title",
                  "price",
                  "priceFormatted",
                  "condition",
                  "titleStatus",
                  "year",
                  "make",
                  "model",
                  "trim",
                  "vin",
                  "mileage",
                  "transmission",
                  "drivetrain",
                  "fuelType",
                  "location",
                  "sellerName",
                  "dealerName",
                  "listingType",
                  "url"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "ae14cdda272178ceb3dd24a9ba0c0049536993a4f84cbea27c6a5f27e56efce0",
    "actVersion": {
      "sourceType": "TARBALL",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.03503888888888889
    }
  }
}