{
  "data": {
    "id": "qABQVwWb0mhDOag9w",
    "actId": "sqGioneiW24skxYGj",
    "userId": "NL4ThgItAwaoBlffQ",
    "startedAt": "2026-11-19T08:46:47.814Z",
    "finishedAt": "2026-11-19T08:46:57.824Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 9882,
      "runTimeSecs": 9.882,
      "computeUnits": 0.01098,
      "imageSizeBytes": 3198754304
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "6GwdnIcc2aWR7LzCS",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"CarGurus Deal Rating & Dealer Inventory Scraper Input\",\n  \"description\": \"Search CarGurus by make, model, ZIP and filters, fetch one listing by ID, or scrape a pasted search URL. Cookieless: no account, cookies or proxy setup needed.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"How to find listings.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"byListingId\",\n        \"byUrl\"\n      ],\n      \"enumTitles\": [\n        \"Search by make/model/ZIP/filters\",\n        \"Single listing by CarGurus listing ID\",\n        \"Scrape a pasted CarGurus search URL\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"byListingId\"\n    },\n    \"make\": {\n      \"title\": \"Make (search mode)\",\n      \"type\": \"string\",\n      \"description\": \"Vehicle manufacturer to search. Leave empty to search every make near the ZIP code.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"Acura\",\n        \"Alfa Romeo\",\n        \"Audi\",\n        \"Bentley\",\n        \"BMW\",\n        \"Buick\",\n        \"Cadillac\",\n        \"Chevrolet\",\n        \"Chrysler\",\n        \"Dodge\",\n        \"Ferrari\",\n        \"Ford\",\n        \"Genesis\",\n        \"GMC\",\n        \"Honda\",\n        \"Hyundai\",\n        \"INFINITI\",\n        \"Jaguar\",\n        \"Jeep\",\n        \"Kia\",\n        \"Land Rover\",\n        \"Lexus\",\n        \"Lincoln\",\n        \"Maserati\",\n        \"Mazda\",\n        \"Mercedes-Benz\",\n        \"MINI\",\n        \"Mitsubishi\",\n        \"Nissan\",\n        \"Porsche\",\n        \"RAM\",\n        \"Subaru\",\n        \"Tesla\",\n        \"Toyota\",\n        \"Volkswagen\",\n        \"Volvo\",\n        \"AM General\",\n        \"AMC\",\n        \"Armstrong-Siddeley\",\n        \"Aston Martin\",\n        \"Auburn\",\n        \"Austin\",\n        \"Austin-Healey\",\n        \"Bertone\",\n        \"Bricklin\",\n        \"Bugatti\",\n        \"Citroen\",\n        \"Continental\",\n        \"Cord\",\n        \"Daewoo\",\n        \"Daihatsu\",\n        \"Datsun\",\n        \"De Tomaso\",\n        \"DeLorean\",\n        \"DeSoto\",\n        \"Durant\",\n        \"Eagle\",\n        \"Edsel\",\n        \"Excalibur\",\n        \"FIAT\",\n        \"Fisker\",\n        \"Freightliner\",\n        \"Geo\",\n        \"Graham\",\n        \"Hudson\",\n        \"Hummer\",\n        \"Ineos\",\n        \"Intermeccanica\",\n        \"International Harvester\",\n        \"Isuzu\",\n        \"Jensen\",\n        \"Kaiser\",\n        \"Karma\",\n        \"Lada\",\n        \"Lamborghini\",\n        \"Lancia\",\n        \"LaSalle\",\n        \"Lotus\",\n        \"Lucid\",\n        \"Maybach\",\n        \"McLaren\",\n        \"Mercury\",\n        \"MG\",\n        \"Mobility Ventures\",\n        \"Morgan\",\n        \"Morris\",\n        \"Nash\",\n        \"Oldsmobile\",\n        \"Opel\",\n        \"Overland\",\n        \"Packard\",\n        \"Paige\",\n        \"Panoz\",\n        \"Peerless\",\n        \"Peugeot\",\n        \"Pininfarina\",\n        \"Plymouth\",\n        \"Polestar\",\n        \"Pontiac\",\n        \"Renault\",\n        \"REO\",\n        \"Rivian\",\n        \"Rolls-Royce\",\n        \"Rover\",\n        \"Saab\",\n        \"Saturn\",\n        \"Scion\",\n        \"Shelby\",\n        \"smart\",\n        \"SSC\",\n        \"Studebaker\",\n        \"Sunbeam\",\n        \"Suzuki\",\n        \"Triumph\",\n        \"VinFast\",\n        \"VPG\",\n        \"Willys\"\n      ],\n      \"enumTitles\": [\n        \"Acura\",\n        \"Alfa Romeo\",\n        \"Audi\",\n        \"Bentley\",\n        \"BMW\",\n        \"Buick\",\n        \"Cadillac\",\n        \"Chevrolet\",\n        \"Chrysler\",\n        \"Dodge\",\n        \"Ferrari\",\n        \"Ford\",\n        \"Genesis\",\n        \"GMC\",\n        \"Honda\",\n        \"Hyundai\",\n        \"INFINITI\",\n        \"Jaguar\",\n        \"Jeep\",\n        \"Kia\",\n        \"Land Rover\",\n        \"Lexus\",\n        \"Lincoln\",\n        \"Maserati\",\n        \"Mazda\",\n        \"Mercedes-Benz\",\n        \"MINI\",\n        \"Mitsubishi\",\n        \"Nissan\",\n        \"Porsche\",\n        \"RAM\",\n        \"Subaru\",\n        \"Tesla\",\n        \"Toyota\",\n        \"Volkswagen\",\n        \"Volvo\",\n        \"AM General\",\n        \"AMC\",\n        \"Armstrong-Siddeley\",\n        \"Aston Martin\",\n        \"Auburn\",\n        \"Austin\",\n        \"Austin-Healey\",\n        \"Bertone\",\n        \"Bricklin\",\n        \"Bugatti\",\n        \"Citroen\",\n        \"Continental\",\n        \"Cord\",\n        \"Daewoo\",\n        \"Daihatsu\",\n        \"Datsun\",\n        \"De Tomaso\",\n        \"DeLorean\",\n        \"DeSoto\",\n        \"Durant\",\n        \"Eagle\",\n        \"Edsel\",\n        \"Excalibur\",\n        \"FIAT\",\n        \"Fisker\",\n        \"Freightliner\",\n        \"Geo\",\n        \"Graham\",\n        \"Hudson\",\n        \"Hummer\",\n        \"Ineos\",\n        \"Intermeccanica\",\n        \"International Harvester\",\n        \"Isuzu\",\n        \"Jensen\",\n        \"Kaiser\",\n        \"Karma\",\n        \"Lada\",\n        \"Lamborghini\",\n        \"Lancia\",\n        \"LaSalle\",\n        \"Lotus\",\n        \"Lucid\",\n        \"Maybach\",\n        \"McLaren\",\n        \"Mercury\",\n        \"MG\",\n        \"Mobility Ventures\",\n        \"Morgan\",\n        \"Morris\",\n        \"Nash\",\n        \"Oldsmobile\",\n        \"Opel\",\n        \"Overland\",\n        \"Packard\",\n        \"Paige\",\n        \"Panoz\",\n        \"Peerless\",\n        \"Peugeot\",\n        \"Pininfarina\",\n        \"Plymouth\",\n        \"Polestar\",\n        \"Pontiac\",\n        \"Renault\",\n        \"REO\",\n        \"Rivian\",\n        \"Rolls-Royce\",\n        \"Rover\",\n        \"Saab\",\n        \"Saturn\",\n        \"Scion\",\n        \"Shelby\",\n        \"smart\",\n        \"SSC\",\n        \"Studebaker\",\n        \"Sunbeam\",\n        \"Suzuki\",\n        \"Triumph\",\n        \"VinFast\",\n        \"VPG\",\n        \"Willys\"\n      ],\n      \"prefill\": \"Toyota\"\n    },\n    \"model\": {\n      \"title\": \"Model (search mode)\",\n      \"type\": \"string\",\n      \"description\": \"Model name, e.g. Camry or F-150. Leave empty for every model of the chosen make.\",\n      \"editor\": \"textfield\"\n    },\n    \"condition\": {\n      \"title\": \"Condition\",\n      \"type\": \"string\",\n      \"description\": \"New, used or certified pre-owned inventory. Certified searches require a make.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"New\",\n        \"Used\",\n        \"Certified Pre-Owned\"\n      ],\n      \"enumTitles\": [\n        \"Any (CarGurus used default)\",\n        \"New\",\n        \"Used\",\n        \"Certified Pre-Owned\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort by\",\n      \"type\": \"string\",\n      \"description\": \"Result ordering.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"best_deal\",\n        \"best_match\",\n        \"lowest_price\",\n        \"highest_price\",\n        \"lowest_mileage\",\n        \"highest_mileage\",\n        \"newest_year\",\n        \"oldest_year\",\n        \"closest\"\n      ],\n      \"enumTitles\": [\n        \"Best deal\",\n        \"Best match\",\n        \"Lowest price\",\n        \"Highest price\",\n        \"Lowest mileage\",\n        \"Highest mileage\",\n        \"Newest model year\",\n        \"Oldest model year\",\n        \"Closest to ZIP\"\n      ],\n      \"default\": \"best_deal\",\n      \"prefill\": \"best_deal\"\n    },\n    \"zipCode\": {\n      \"title\": \"ZIP code (search mode)\",\n      \"type\": \"string\",\n      \"description\": \"5-digit US ZIP code used to center the search, e.g. 10001.\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"10001\"\n    },\n    \"distanceMiles\": {\n      \"title\": \"Search radius (miles)\",\n      \"type\": \"string\",\n      \"description\": \"How far from the ZIP code to search.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"10\",\n        \"25\",\n        \"50\",\n        \"75\",\n        \"100\",\n        \"150\",\n        \"200\",\n        \"500\"\n      ],\n      \"enumTitles\": [\n        \"10 miles\",\n        \"25 miles\",\n        \"50 miles\",\n        \"75 miles\",\n        \"100 miles\",\n        \"150 miles\",\n        \"200 miles\",\n        \"500 miles\"\n      ],\n      \"default\": \"50\",\n      \"prefill\": \"50\"\n    },\n    \"minPrice\": {\n      \"title\": \"Min price (USD)\",\n      \"type\": \"integer\",\n      \"description\": \"Minimum listing price in US dollars.\",\n      \"minimum\": 0,\n      \"maximum\": 9999999\n    },\n    \"maxPrice\": {\n      \"title\": \"Max price (USD)\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum listing price in US dollars.\",\n      \"minimum\": 0,\n      \"maximum\": 9999999\n    },\n    \"maxMileage\": {\n      \"title\": \"Max mileage\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum odometer reading in miles.\",\n      \"minimum\": 0,\n      \"maximum\": 999999\n    },\n    \"dealRating\": {\n      \"title\": \"Deal rating filter\",\n      \"type\": \"string\",\n      \"description\": \"Only return listings CarGurus rates at this level. Leave empty for every rating.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"GREAT_PRICE\",\n        \"GOOD_PRICE\",\n        \"FAIR_PRICE\",\n        \"POOR_PRICE\",\n        \"OVERPRICED\",\n        \"NA\",\n        \"OUTLIER\"\n      ],\n      \"enumTitles\": [\n        \"Any rating\",\n        \"Great Deal\",\n        \"Good Deal\",\n        \"Fair Deal\",\n        \"High Price\",\n        \"Overpriced\",\n        \"No Price Analysis\",\n        \"Uncertain\"\n      ],\n      \"default\": \"\"\n    },\n    \"bodyType\": {\n      \"title\": \"Body style\",\n      \"type\": \"string\",\n      \"description\": \"Limit results to one body style.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"Coupe\",\n        \"Convertible\",\n        \"Hatchback\",\n        \"Minivan\",\n        \"Pickup Truck\",\n        \"Sedan\",\n        \"SUV / Crossover\",\n        \"Van\",\n        \"Wagon\"\n      ],\n      \"enumTitles\": [\n        \"Any body style\",\n        \"Coupe\",\n        \"Convertible\",\n        \"Hatchback\",\n        \"Minivan\",\n        \"Pickup Truck\",\n        \"Sedan\",\n        \"SUV / Crossover\",\n        \"Van\",\n        \"Wagon\"\n      ],\n      \"default\": \"\"\n    },\n    \"fuelType\": {\n      \"title\": \"Fuel type\",\n      \"type\": \"string\",\n      \"description\": \"Limit results to one fuel type.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"Gasoline\",\n        \"Hybrid\",\n        \"Electric\",\n        \"Diesel\",\n        \"Biodiesel\",\n        \"Flex Fuel Vehicle\"\n      ],\n      \"enumTitles\": [\n        \"Any fuel type\",\n        \"Gasoline\",\n        \"Hybrid\",\n        \"Electric\",\n        \"Diesel\",\n        \"Biodiesel\",\n        \"Flex Fuel Vehicle\"\n      ],\n      \"default\": \"\"\n    },\n    \"transmission\": {\n      \"title\": \"Transmission\",\n      \"type\": \"string\",\n      \"description\": \"Limit results by transmission.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"Automatic\",\n        \"Manual\"\n      ],\n      \"enumTitles\": [\n        \"Any transmission\",\n        \"Automatic\",\n        \"Manual\"\n      ],\n      \"default\": \"\"\n    },\n    \"drivetrain\": {\n      \"title\": \"Drivetrain\",\n      \"type\": \"string\",\n      \"description\": \"Limit results by driven wheels.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"All-Wheel Drive\",\n        \"Front-Wheel Drive\",\n        \"Rear-Wheel Drive\",\n        \"Four-Wheel Drive\",\n        \"4X2\"\n      ],\n      \"enumTitles\": [\n        \"Any drivetrain\",\n        \"All-Wheel Drive\",\n        \"Front-Wheel Drive\",\n        \"Rear-Wheel Drive\",\n        \"Four-Wheel Drive\",\n        \"4X2\"\n      ],\n      \"default\": \"\"\n    },\n    \"onlyWithPhotos\": {\n      \"title\": \"Only listings with photos\",\n      \"type\": \"boolean\",\n      \"description\": \"Skip listings that have no photos.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"onlyPriceDrops\": {\n      \"title\": \"Only recent price drops\",\n      \"type\": \"boolean\",\n      \"description\": \"Only return listings whose price dropped recently.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"listingId\": {\n      \"title\": \"Listing ID (byListingId mode)\",\n      \"type\": \"string\",\n      \"description\": \"CarGurus listing ID from a listing URL or the /details/<id> page.\",\n      \"editor\": \"textfield\",\n      \"prefill\": \"464410035\"\n    },\n    \"url\": {\n      \"title\": \"CarGurus URL (byUrl mode)\",\n      \"type\": \"string\",\n      \"description\": \"A CarGurus search results URL or listing URL. Old action-style search URLs are accepted too.\",\n      \"editor\": \"textfield\"\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum number of listings to emit.\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 5,\n      \"prefill\": 1\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# CarGurus Deal Rating & Dealer Inventory Scraper\n\nCarGurus rates every listing against its Instant Market Value (IMV) and labels it from Great Deal down to Overpriced. This actor collects that rating, the IMV, the numeric deal score, the asking price, mileage, specs, dealer contact details and photos — by make/model/ZIP search, by a single listing ID, or from a CarGurus search URL you paste in.\n\n## Modes\n\n- **Search** — build a query from make, model, ZIP, radius, condition, deal rating, body style, fuel, transmission, drivetrain, price, mileage, photo and price-drop filters, and walk every result page.\n- **Single listing** — fetch one listing by its CarGurus ID (for example `464410035` from `/details/464410035`).\n- **Paste a URL** — paste a CarGurus search-results URL (old `searchResults.action` links are accepted) or a listing URL.\n\n## What you get per listing\n\n| Field | Description |\n| --- | --- |\n| `listingId` | CarGurus listing ID. |\n| `url` | Direct `cargurus.com/details/<id>` link. |\n| `title` | Year, make, model and trim as shown by CarGurus. |\n| `vin`, `stockNumber` | VIN and dealer stock number when published. |\n| `year`, `make`, `model`, `trim`, `bodyType` | Vehicle identity. |\n| `price`, `pricePlusFees` | Asking price and the advertised price including disclosed fees. |\n| `expectedPrice` | CarGurus Instant Market Value (IMV) for this car. |\n| `priceDifference` | Price minus IMV (positive means above market). |\n| `dealRating`, `dealRatingCode`, `dealScore` | Human label, raw CarGurus code and numeric deal score. |\n| `mileage`, `condition` | Odometer reading and New / Used / Certified Pre-Owned. |\n| `exteriorColor`, `interiorColor` | Published colors. |\n| `transmission`, `driveType`, `engine`, `fuelType` | Powertrain and engine details. |\n| `mpgCity`, `mpgHighway`, `mpgCombined` | EPA-style fuel economy when published. |\n| `doors`, `options`, `tags`, `safetyRating` | Body details, installed options, badges and NHTSA rating. |\n| `dealerName`, `dealerId`, `dealerType` | Selling dealer identity. |\n| `dealerCity`, `dealerState`, `dealerPostalCode`, `dealerPhone` | Dealer location and phone. |\n| `dealerWebsite`, `dealerRating`, `dealerReviewCount` | Dealer site and review summary (single-listing mode). |\n| `dealerStreet`, `dealerLatitude`, `dealerLongitude`, `dealerLogoUrl` | More dealer detail (single-listing mode). |\n| `distanceMiles`, `daysOnMarket` | Distance from the search ZIP and days listed. |\n| `photoCount`, `primaryPhotoUrl`, `images` | Photo count, main photo and every photo (single-listing mode). |\n| `accidentCount`, `ownerCount`, `vehicleHistoryReport` | Vehicle-history summary (single-listing mode). |\n| `siteName`, `scrapedAt`, `recordType` | Source and capture metadata. |\n\nFields the source does not publish for a listing are omitted from that record — never filled with `null` or a placeholder.\n\n## Input\n\n| Field | Type | Default | Description |\n| --- | --- | --- | --- |\n| `mode` | Select | `search` | `search`, `byListingId` or `byUrl`. |\n| `make` | Select | – | Manufacturer (all makes CarGurus lists). |\n| `model` | Text | – | Model name, e.g. `Camry`. Empty means every model. |\n| `condition` | Select | Any | New, Used or Certified Pre-Owned. Certified searches need a make. |\n| `sortBy` | Select | `best_deal` | Best deal/match, price, mileage, year or distance. |\n| `zipCode` | Text | – | 5-digit US ZIP code. |\n| `distanceMiles` | Select | 50 | Search radius: 10–500 miles. |\n| `minPrice`, `maxPrice` | Integer | – | Price range in USD. |\n| `maxMileage` | Integer | – | Odometer ceiling. |\n| `dealRating` | Select | Any | Great Deal, Good Deal, Fair Deal, High Price, Overpriced, No Price Analysis or Uncertain. |\n| `bodyType` | Select | Any | Coupe, Convertible, Hatchback, Minivan, Pickup, Sedan, SUV/Crossover, Van, Wagon. |\n| `fuelType` | Select | Any | Gasoline, Hybrid, Electric, Diesel, Biodiesel or Flex Fuel. |\n| `transmission` | Select | Any | Automatic or Manual. |\n| `drivetrain` | Select | Any | AWD, FWD, RWD, 4WD or 4X2. |\n| `onlyWithPhotos` | Boolean | false | Skip listings with no photos. |\n| `onlyPriceDrops` | Boolean | false | Only recent price drops. |\n| `listingId` | Text | – | Listing ID for `byListingId`. |\n| `url` | Text | – | Search or listing URL for `byUrl`. |\n| `maxItems` | Integer | 5 | Maximum records to emit (1–1000). |\n\n### Examples\n\nUsed Toyota Camry near New York:\n\n```json\n{\n  \"mode\": \"search\",\n  \"make\": \"Toyota\",\n  \"model\": \"Camry\",\n  \"condition\": \"Used\",\n  \"zipCode\": \"10001\",\n  \"distanceMiles\": 50,\n  \"maxPrice\": 30000,\n  \"maxItems\": 50\n}\n```\n\nGreat-deal hybrid SUVs with all-wheel drive and photos:\n\n```json\n{\n  \"mode\": \"search\",\n  \"make\": \"Toyota\",\n  \"zipCode\": \"10001\",\n  \"dealRating\": \"GREAT_PRICE\",\n  \"bodyType\": \"SUV / Crossover\",\n  \"fuelType\": \"Hybrid\",\n  \"drivetrain\": \"All-Wheel Drive\",\n  \"onlyWithPhotos\": true,\n  \"maxItems\": 25\n}\n```\n\nOne listing by ID:\n\n```json\n{\"mode\": \"byListingId\", \"listingId\": \"464410035\", \"maxItems\": 1}\n```\n\nA pasted search URL:\n\n```json\n{\"mode\": \"byUrl\", \"url\": \"https://www.cargurus.com/Cars/l-Used-Toyota-Camry-Raleigh-d292_L25152\", \"maxItems\": 100}\n```\n\n## Data source and reliability\n\nCarGurus renders its search results from a public Remix loader payload. The actor reads that payload through Google's live translate mirror (no account or cookies) and rotates exits/languages, with an Apify unblocker fallback for DataDome-protected detail pages. You do not need to supply cookies, API keys or proxy settings; the actor selects its route automatically.\n\n## Use cases\n\n- **Car shoppers** compare deal ratings and IMV on a shortlist near a ZIP code.\n- **Dealers** monitor competitors' inventory, pricing and days on market.\n- **Pricing analysts** track how deal scores and price differences move by model and region.\n- **Lead generation** collects dealer name, phone and location alongside active listings.\n- **Fleet buyers** screen by mileage, body style, fuel and drivetrain.\n\n## FAQ\n\n**Does this need a CarGurus login?**\nNo. It reads publicly visible listing data and never asks for an account.\n\n**What does `dealRating` mean?**\nCarGurus compares a car's price with its Instant Market Value. Great Deal and Good Deal are below IMV, Fair Deal is close, High Price and Overpriced are above it. `dealRatingCode` keeps CarGurus's raw value.\n\n**Why is a field missing on some records?**\nNot every listing publishes a VIN, MPG, dealer rating or full photo set. Missing fields are omitted, not filled with a placeholder.\n\n**Can I filter by model year?**\nNot yet: CarGurus's current search loader ignores year-range parameters. Use `minPrice`/`maxPrice` and sort by model year, or paste a URL with the site's own year filter.\n\n**Can I scrape certified pre-owned cars?**\nYes, with a make selected. CarGurus exposes certified inventory through its make pages; a make-less certified search is not available.\n\n**How many results can I get?**\nUp to 1,000 per run via `maxItems`. Large runs walk result pages until `maxItems` or the source ends. CarGurus shows an approximate national total that is not filter-specific, so result counts in the dataset are authoritative.\n\n**Is this affiliated with CarGurus?**\nNo. This is an independent tool and is not affiliated with, endorsed by, or sponsored by CarGurus.\n\n## Legacy inputs\n\nSaved tasks that still send `zip`, `searchUrl`, `startUrl`, `startUrls`, `maxResults`, `carCondition`, `makeName`, `modelName`, `listingID` or `sort` keep working: the actor maps them in code to the current fields.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "cargurus-deal-rating-and-dealer-inventory-scraper",
      "title": "CarGurus Deal Rating & Dealer Inventory Scraper",
      "description": "Search CarGurus by make, model, ZIP, deal rating, body style, fuel type and more, or fetch one listing by ID or URL. Every record carries CarGurus' deal rating, IMV estimate, mileage, dealer contact details and photo.",
      "version": "1.0",
      "buildTag": "latest",
      "defaultMemoryMbytes": 1024,
      "dockerfile": "../Dockerfile",
      "readme": "# CarGurus Deal Rating & Dealer Inventory Scraper\n\nCarGurus rates every listing against its Instant Market Value (IMV) and labels it from Great Deal down to Overpriced. This actor collects that rating, the IMV, the numeric deal score, the asking price, mileage, specs, dealer contact details and photos — by make/model/ZIP search, by a single listing ID, or from a CarGurus search URL you paste in.\n\n## Modes\n\n- **Search** — build a query from make, model, ZIP, radius, condition, deal rating, body style, fuel, transmission, drivetrain, price, mileage, photo and price-drop filters, and walk every result page.\n- **Single listing** — fetch one listing by its CarGurus ID (for example `464410035` from `/details/464410035`).\n- **Paste a URL** — paste a CarGurus search-results URL (old `searchResults.action` links are accepted) or a listing URL.\n\n## What you get per listing\n\n| Field | Description |\n| --- | --- |\n| `listingId` | CarGurus listing ID. |\n| `url` | Direct `cargurus.com/details/<id>` link. |\n| `title` | Year, make, model and trim as shown by CarGurus. |\n| `vin`, `stockNumber` | VIN and dealer stock number when published. |\n| `year`, `make`, `model`, `trim`, `bodyType` | Vehicle identity. |\n| `price`, `pricePlusFees` | Asking price and the advertised price including disclosed fees. |\n| `expectedPrice` | CarGurus Instant Market Value (IMV) for this car. |\n| `priceDifference` | Price minus IMV (positive means above market). |\n| `dealRating`, `dealRatingCode`, `dealScore` | Human label, raw CarGurus code and numeric deal score. |\n| `mileage`, `condition` | Odometer reading and New / Used / Certified Pre-Owned. |\n| `exteriorColor`, `interiorColor` | Published colors. |\n| `transmission`, `driveType`, `engine`, `fuelType` | Powertrain and engine details. |\n| `mpgCity`, `mpgHighway`, `mpgCombined` | EPA-style fuel economy when published. |\n| `doors`, `options`, `tags`, `safetyRating` | Body details, installed options, badges and NHTSA rating. |\n| `dealerName`, `dealerId`, `dealerType` | Selling dealer identity. |\n| `dealerCity`, `dealerState`, `dealerPostalCode`, `dealerPhone` | Dealer location and phone. |\n| `dealerWebsite`, `dealerRating`, `dealerReviewCount` | Dealer site and review summary (single-listing mode). |\n| `dealerStreet`, `dealerLatitude`, `dealerLongitude`, `dealerLogoUrl` | More dealer detail (single-listing mode). |\n| `distanceMiles`, `daysOnMarket` | Distance from the search ZIP and days listed. |\n| `photoCount`, `primaryPhotoUrl`, `images` | Photo count, main photo and every photo (single-listing mode). |\n| `accidentCount`, `ownerCount`, `vehicleHistoryReport` | Vehicle-history summary (single-listing mode). |\n| `siteName`, `scrapedAt`, `recordType` | Source and capture metadata. |\n\nFields the source does not publish for a listing are omitted from that record — never filled with `null` or a placeholder.\n\n## Input\n\n| Field | Type | Default | Description |\n| --- | --- | --- | --- |\n| `mode` | Select | `search` | `search`, `byListingId` or `byUrl`. |\n| `make` | Select | – | Manufacturer (all makes CarGurus lists). |\n| `model` | Text | – | Model name, e.g. `Camry`. Empty means every model. |\n| `condition` | Select | Any | New, Used or Certified Pre-Owned. Certified searches need a make. |\n| `sortBy` | Select | `best_deal` | Best deal/match, price, mileage, year or distance. |\n| `zipCode` | Text | – | 5-digit US ZIP code. |\n| `distanceMiles` | Select | 50 | Search radius: 10–500 miles. |\n| `minPrice`, `maxPrice` | Integer | – | Price range in USD. |\n| `maxMileage` | Integer | – | Odometer ceiling. |\n| `dealRating` | Select | Any | Great Deal, Good Deal, Fair Deal, High Price, Overpriced, No Price Analysis or Uncertain. |\n| `bodyType` | Select | Any | Coupe, Convertible, Hatchback, Minivan, Pickup, Sedan, SUV/Crossover, Van, Wagon. |\n| `fuelType` | Select | Any | Gasoline, Hybrid, Electric, Diesel, Biodiesel or Flex Fuel. |\n| `transmission` | Select | Any | Automatic or Manual. |\n| `drivetrain` | Select | Any | AWD, FWD, RWD, 4WD or 4X2. |\n| `onlyWithPhotos` | Boolean | false | Skip listings with no photos. |\n| `onlyPriceDrops` | Boolean | false | Only recent price drops. |\n| `listingId` | Text | – | Listing ID for `byListingId`. |\n| `url` | Text | – | Search or listing URL for `byUrl`. |\n| `maxItems` | Integer | 5 | Maximum records to emit (1–1000). |\n\n### Examples\n\nUsed Toyota Camry near New York:\n\n```json\n{\n  \"mode\": \"search\",\n  \"make\": \"Toyota\",\n  \"model\": \"Camry\",\n  \"condition\": \"Used\",\n  \"zipCode\": \"10001\",\n  \"distanceMiles\": 50,\n  \"maxPrice\": 30000,\n  \"maxItems\": 50\n}\n```\n\nGreat-deal hybrid SUVs with all-wheel drive and photos:\n\n```json\n{\n  \"mode\": \"search\",\n  \"make\": \"Toyota\",\n  \"zipCode\": \"10001\",\n  \"dealRating\": \"GREAT_PRICE\",\n  \"bodyType\": \"SUV / Crossover\",\n  \"fuelType\": \"Hybrid\",\n  \"drivetrain\": \"All-Wheel Drive\",\n  \"onlyWithPhotos\": true,\n  \"maxItems\": 25\n}\n```\n\nOne listing by ID:\n\n```json\n{\"mode\": \"byListingId\", \"listingId\": \"464410035\", \"maxItems\": 1}\n```\n\nA pasted search URL:\n\n```json\n{\"mode\": \"byUrl\", \"url\": \"https://www.cargurus.com/Cars/l-Used-Toyota-Camry-Raleigh-d292_L25152\", \"maxItems\": 100}\n```\n\n## Data source and reliability\n\nCarGurus renders its search results from a public Remix loader payload. The actor reads that payload through Google's live translate mirror (no account or cookies) and rotates exits/languages, with an Apify unblocker fallback for DataDome-protected detail pages. You do not need to supply cookies, API keys or proxy settings; the actor selects its route automatically.\n\n## Use cases\n\n- **Car shoppers** compare deal ratings and IMV on a shortlist near a ZIP code.\n- **Dealers** monitor competitors' inventory, pricing and days on market.\n- **Pricing analysts** track how deal scores and price differences move by model and region.\n- **Lead generation** collects dealer name, phone and location alongside active listings.\n- **Fleet buyers** screen by mileage, body style, fuel and drivetrain.\n\n## FAQ\n\n**Does this need a CarGurus login?**\nNo. It reads publicly visible listing data and never asks for an account.\n\n**What does `dealRating` mean?**\nCarGurus compares a car's price with its Instant Market Value. Great Deal and Good Deal are below IMV, Fair Deal is close, High Price and Overpriced are above it. `dealRatingCode` keeps CarGurus's raw value.\n\n**Why is a field missing on some records?**\nNot every listing publishes a VIN, MPG, dealer rating or full photo set. Missing fields are omitted, not filled with a placeholder.\n\n**Can I filter by model year?**\nNot yet: CarGurus's current search loader ignores year-range parameters. Use `minPrice`/`maxPrice` and sort by model year, or paste a URL with the site's own year filter.\n\n**Can I scrape certified pre-owned cars?**\nYes, with a make selected. CarGurus exposes certified inventory through its make pages; a make-less certified search is not available.\n\n**How many results can I get?**\nUp to 1,000 per run via `maxItems`. Large runs walk result pages until `maxItems` or the source ends. CarGurus shows an approximate national total that is not filter-specific, so result counts in the dataset are authoritative.\n\n**Is this affiliated with CarGurus?**\nNo. This is an independent tool and is not affiliated with, endorsed by, or sponsored by CarGurus.\n\n## Legacy inputs\n\nSaved tasks that still send `zip`, `searchUrl`, `startUrl`, `startUrls`, `maxResults`, `carCondition`, `makeName`, `modelName`, `listingID` or `sort` keep working: the actor maps them in code to the current fields.\n",
      "input": {
        "title": "CarGurus Deal Rating & Dealer Inventory Scraper Input",
        "description": "Search CarGurus by make, model, ZIP and filters, fetch one listing by ID, or scrape a pasted search URL. Cookieless: no account, cookies or proxy setup needed.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "How to find listings.",
            "editor": "select",
            "enum": [
              "search",
              "byListingId",
              "byUrl"
            ],
            "enumTitles": [
              "Search by make/model/ZIP/filters",
              "Single listing by CarGurus listing ID",
              "Scrape a pasted CarGurus search URL"
            ],
            "default": "search",
            "prefill": "byListingId"
          },
          "make": {
            "title": "Make (search mode)",
            "type": "string",
            "description": "Vehicle manufacturer to search. Leave empty to search every make near the ZIP code.",
            "editor": "select",
            "enum": [
              "Acura",
              "Alfa Romeo",
              "Audi",
              "Bentley",
              "BMW",
              "Buick",
              "Cadillac",
              "Chevrolet",
              "Chrysler",
              "Dodge",
              "Ferrari",
              "Ford",
              "Genesis",
              "GMC",
              "Honda",
              "Hyundai",
              "INFINITI",
              "Jaguar",
              "Jeep",
              "Kia",
              "Land Rover",
              "Lexus",
              "Lincoln",
              "Maserati",
              "Mazda",
              "Mercedes-Benz",
              "MINI",
              "Mitsubishi",
              "Nissan",
              "Porsche",
              "RAM",
              "Subaru",
              "Tesla",
              "Toyota",
              "Volkswagen",
              "Volvo",
              "AM General",
              "AMC",
              "Armstrong-Siddeley",
              "Aston Martin",
              "Auburn",
              "Austin",
              "Austin-Healey",
              "Bertone",
              "Bricklin",
              "Bugatti",
              "Citroen",
              "Continental",
              "Cord",
              "Daewoo",
              "Daihatsu",
              "Datsun",
              "De Tomaso",
              "DeLorean",
              "DeSoto",
              "Durant",
              "Eagle",
              "Edsel",
              "Excalibur",
              "FIAT",
              "Fisker",
              "Freightliner",
              "Geo",
              "Graham",
              "Hudson",
              "Hummer",
              "Ineos",
              "Intermeccanica",
              "International Harvester",
              "Isuzu",
              "Jensen",
              "Kaiser",
              "Karma",
              "Lada",
              "Lamborghini",
              "Lancia",
              "LaSalle",
              "Lotus",
              "Lucid",
              "Maybach",
              "McLaren",
              "Mercury",
              "MG",
              "Mobility Ventures",
              "Morgan",
              "Morris",
              "Nash",
              "Oldsmobile",
              "Opel",
              "Overland",
              "Packard",
              "Paige",
              "Panoz",
              "Peerless",
              "Peugeot",
              "Pininfarina",
              "Plymouth",
              "Polestar",
              "Pontiac",
              "Renault",
              "REO",
              "Rivian",
              "Rolls-Royce",
              "Rover",
              "Saab",
              "Saturn",
              "Scion",
              "Shelby",
              "smart",
              "SSC",
              "Studebaker",
              "Sunbeam",
              "Suzuki",
              "Triumph",
              "VinFast",
              "VPG",
              "Willys"
            ],
            "enumTitles": [
              "Acura",
              "Alfa Romeo",
              "Audi",
              "Bentley",
              "BMW",
              "Buick",
              "Cadillac",
              "Chevrolet",
              "Chrysler",
              "Dodge",
              "Ferrari",
              "Ford",
              "Genesis",
              "GMC",
              "Honda",
              "Hyundai",
              "INFINITI",
              "Jaguar",
              "Jeep",
              "Kia",
              "Land Rover",
              "Lexus",
              "Lincoln",
              "Maserati",
              "Mazda",
              "Mercedes-Benz",
              "MINI",
              "Mitsubishi",
              "Nissan",
              "Porsche",
              "RAM",
              "Subaru",
              "Tesla",
              "Toyota",
              "Volkswagen",
              "Volvo",
              "AM General",
              "AMC",
              "Armstrong-Siddeley",
              "Aston Martin",
              "Auburn",
              "Austin",
              "Austin-Healey",
              "Bertone",
              "Bricklin",
              "Bugatti",
              "Citroen",
              "Continental",
              "Cord",
              "Daewoo",
              "Daihatsu",
              "Datsun",
              "De Tomaso",
              "DeLorean",
              "DeSoto",
              "Durant",
              "Eagle",
              "Edsel",
              "Excalibur",
              "FIAT",
              "Fisker",
              "Freightliner",
              "Geo",
              "Graham",
              "Hudson",
              "Hummer",
              "Ineos",
              "Intermeccanica",
              "International Harvester",
              "Isuzu",
              "Jensen",
              "Kaiser",
              "Karma",
              "Lada",
              "Lamborghini",
              "Lancia",
              "LaSalle",
              "Lotus",
              "Lucid",
              "Maybach",
              "McLaren",
              "Mercury",
              "MG",
              "Mobility Ventures",
              "Morgan",
              "Morris",
              "Nash",
              "Oldsmobile",
              "Opel",
              "Overland",
              "Packard",
              "Paige",
              "Panoz",
              "Peerless",
              "Peugeot",
              "Pininfarina",
              "Plymouth",
              "Polestar",
              "Pontiac",
              "Renault",
              "REO",
              "Rivian",
              "Rolls-Royce",
              "Rover",
              "Saab",
              "Saturn",
              "Scion",
              "Shelby",
              "smart",
              "SSC",
              "Studebaker",
              "Sunbeam",
              "Suzuki",
              "Triumph",
              "VinFast",
              "VPG",
              "Willys"
            ],
            "prefill": "Toyota"
          },
          "model": {
            "title": "Model (search mode)",
            "type": "string",
            "description": "Model name, e.g. Camry or F-150. Leave empty for every model of the chosen make.",
            "editor": "textfield"
          },
          "condition": {
            "title": "Condition",
            "type": "string",
            "description": "New, used or certified pre-owned inventory. Certified searches require a make.",
            "editor": "select",
            "enum": [
              "",
              "New",
              "Used",
              "Certified Pre-Owned"
            ],
            "enumTitles": [
              "Any (CarGurus used default)",
              "New",
              "Used",
              "Certified Pre-Owned"
            ],
            "default": "",
            "prefill": ""
          },
          "sortBy": {
            "title": "Sort by",
            "type": "string",
            "description": "Result ordering.",
            "editor": "select",
            "enum": [
              "best_deal",
              "best_match",
              "lowest_price",
              "highest_price",
              "lowest_mileage",
              "highest_mileage",
              "newest_year",
              "oldest_year",
              "closest"
            ],
            "enumTitles": [
              "Best deal",
              "Best match",
              "Lowest price",
              "Highest price",
              "Lowest mileage",
              "Highest mileage",
              "Newest model year",
              "Oldest model year",
              "Closest to ZIP"
            ],
            "default": "best_deal",
            "prefill": "best_deal"
          },
          "zipCode": {
            "title": "ZIP code (search mode)",
            "type": "string",
            "description": "5-digit US ZIP code used to center the search, e.g. 10001.",
            "editor": "textfield",
            "prefill": "10001"
          },
          "distanceMiles": {
            "title": "Search radius (miles)",
            "type": "string",
            "description": "How far from the ZIP code to search.",
            "editor": "select",
            "enum": [
              "10",
              "25",
              "50",
              "75",
              "100",
              "150",
              "200",
              "500"
            ],
            "enumTitles": [
              "10 miles",
              "25 miles",
              "50 miles",
              "75 miles",
              "100 miles",
              "150 miles",
              "200 miles",
              "500 miles"
            ],
            "default": "50",
            "prefill": "50"
          },
          "minPrice": {
            "title": "Min price (USD)",
            "type": "integer",
            "description": "Minimum listing price in US dollars.",
            "minimum": 0,
            "maximum": 9999999
          },
          "maxPrice": {
            "title": "Max price (USD)",
            "type": "integer",
            "description": "Maximum listing price in US dollars.",
            "minimum": 0,
            "maximum": 9999999
          },
          "maxMileage": {
            "title": "Max mileage",
            "type": "integer",
            "description": "Maximum odometer reading in miles.",
            "minimum": 0,
            "maximum": 999999
          },
          "dealRating": {
            "title": "Deal rating filter",
            "type": "string",
            "description": "Only return listings CarGurus rates at this level. Leave empty for every rating.",
            "editor": "select",
            "enum": [
              "",
              "GREAT_PRICE",
              "GOOD_PRICE",
              "FAIR_PRICE",
              "POOR_PRICE",
              "OVERPRICED",
              "NA",
              "OUTLIER"
            ],
            "enumTitles": [
              "Any rating",
              "Great Deal",
              "Good Deal",
              "Fair Deal",
              "High Price",
              "Overpriced",
              "No Price Analysis",
              "Uncertain"
            ],
            "default": ""
          },
          "bodyType": {
            "title": "Body style",
            "type": "string",
            "description": "Limit results to one body style.",
            "editor": "select",
            "enum": [
              "",
              "Coupe",
              "Convertible",
              "Hatchback",
              "Minivan",
              "Pickup Truck",
              "Sedan",
              "SUV / Crossover",
              "Van",
              "Wagon"
            ],
            "enumTitles": [
              "Any body style",
              "Coupe",
              "Convertible",
              "Hatchback",
              "Minivan",
              "Pickup Truck",
              "Sedan",
              "SUV / Crossover",
              "Van",
              "Wagon"
            ],
            "default": ""
          },
          "fuelType": {
            "title": "Fuel type",
            "type": "string",
            "description": "Limit results to one fuel type.",
            "editor": "select",
            "enum": [
              "",
              "Gasoline",
              "Hybrid",
              "Electric",
              "Diesel",
              "Biodiesel",
              "Flex Fuel Vehicle"
            ],
            "enumTitles": [
              "Any fuel type",
              "Gasoline",
              "Hybrid",
              "Electric",
              "Diesel",
              "Biodiesel",
              "Flex Fuel Vehicle"
            ],
            "default": ""
          },
          "transmission": {
            "title": "Transmission",
            "type": "string",
            "description": "Limit results by transmission.",
            "editor": "select",
            "enum": [
              "",
              "Automatic",
              "Manual"
            ],
            "enumTitles": [
              "Any transmission",
              "Automatic",
              "Manual"
            ],
            "default": ""
          },
          "drivetrain": {
            "title": "Drivetrain",
            "type": "string",
            "description": "Limit results by driven wheels.",
            "editor": "select",
            "enum": [
              "",
              "All-Wheel Drive",
              "Front-Wheel Drive",
              "Rear-Wheel Drive",
              "Four-Wheel Drive",
              "4X2"
            ],
            "enumTitles": [
              "Any drivetrain",
              "All-Wheel Drive",
              "Front-Wheel Drive",
              "Rear-Wheel Drive",
              "Four-Wheel Drive",
              "4X2"
            ],
            "default": ""
          },
          "onlyWithPhotos": {
            "title": "Only listings with photos",
            "type": "boolean",
            "description": "Skip listings that have no photos.",
            "default": false,
            "prefill": false
          },
          "onlyPriceDrops": {
            "title": "Only recent price drops",
            "type": "boolean",
            "description": "Only return listings whose price dropped recently.",
            "default": false,
            "prefill": false
          },
          "listingId": {
            "title": "Listing ID (byListingId mode)",
            "type": "string",
            "description": "CarGurus listing ID from a listing URL or the /details/<id> page.",
            "editor": "textfield",
            "prefill": "464410035"
          },
          "url": {
            "title": "CarGurus URL (byUrl mode)",
            "type": "string",
            "description": "A CarGurus search results URL or listing URL. Old action-style search URLs are accepted too.",
            "editor": "textfield"
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Maximum number of listings to emit.",
            "minimum": 1,
            "maximum": 1000,
            "default": 5,
            "prefill": 1
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "CarGurus Deal Rating & Dealer Inventory Scraper Output",
        "description": "One row per CarGurus listing with price, IMV/expected price, deal rating and score, mileage, specs, dealer contact details and photos.",
        "properties": {
          "records": {
            "type": "string",
            "title": "Car listings",
            "description": "Dataset containing all scraped CarGurus car listings.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Car Listings",
              "transformation": {
                "fields": [
                  "year",
                  "make",
                  "model",
                  "trim",
                  "price",
                  "expectedPrice",
                  "dealRating",
                  "dealScore",
                  "mileage",
                  "condition",
                  "bodyType",
                  "dealerName",
                  "dealerCity",
                  "dealerState",
                  "dealerPhone",
                  "url"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "1e85b3b563b3776125e554d00bb65f120ac70c6e1d7880f86a8f68ebd13e9ed5",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.01098
    }
  }
}