# 🚗 Carfax.com Scraper (`api-empire/carfax-scraper`) Actor - **URL**: https://apify.com/api-empire/carfax-scraper.md - **Developed by:** [API Empire](https://apify.com/api-empire) (community) - **Categories:** Automation, Developer tools, Other - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.99 / 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. 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 ## 🚗 Carfax.com Scraper **Pull rich, structured vehicle data directly from [Carfax.com](https://www.carfax.com/) — by URL, VIN, or location-based search filters.** Returns dealer info, pricing, options, accident & service history, owner timeline, MPG, photos, and dozens of other fields per listing. ### 🌟 Why Choose This Actor? * 🛡️ **Anti-block by design** — auto-falls-back from direct → datacenter proxy → residential proxy. Once residential kicks in, it stays sticky for the rest of the run. * ⚡ **Real-time output** — every vehicle is pushed to the dataset the moment it lands. Crash mid-run? You still keep everything you scraped. * 🧩 **Bulk URL & VIN input** — paste 1 or 10,000 URLs/VINs. Concurrent fetches under the hood. * 🔎 **Full search filter set** — ZIP + radius, make/model, year range, price range, mileage, accidents, owners, certified-only, body styles, colors, drivetrain, fuel, transmission, popular options. * 📊 **Four pre-built dataset views** — *Overview*, *Dealer*, *History*, *Price* — so the output table renders cleanly with the columns that matter. * 🤖 **Pay-Per-Event pricing** — pay only for actor starts and successful results. --- ### ✨ Key Features * 🌐 Bulk input: vehicle URLs **and/or** raw VINs * 📍 Search by ZIP code with radius up to 3,000 mi * 🏷️ Filter by make, model, year, price, mileage, condition * 🛡️ One-owner / no-accident / personal-use / certified toggles * 🎨 Filter by body style, exterior/interior colour, drivetrain, fuel, transmission, engine * 💰 Dealer ratings, reviews, group, franchise partnerships * 📜 Owner history, accident summary, service records timeline * 🖼️ All listing photos (multiple resolutions) * 🛞 Trim, sub-trim, cab type, bed length, drive type, MPG --- ### 📥 Input | Field | Type | Description | |---|---|---| | `urls` | array | 🔗 Carfax vehicle URLs (bulk). Skips search when set. | | `VINs` | array | 🆔 Raw 17-char VINs (alternative to URLs). | | `zipcode` | string | 📍 US ZIP for search center. | | `type` | enum | `used` or `new`. | | `sort` | enum | `BEST`, `PRICE_ASC`, `PRICE_DESC`, `MILEAGE_ASC`, … | | `radius` | enum | Search radius in miles. | | `maker`, `model` | string | Make / model filter. | | `minYear`, `maxYear` | integer | Year range. | | `priceOver`, `priceUnder` | integer | Price range. | | `mileageMin`, `mileageMax` | integer | Mileage range. | | `certified`, `noAccidents`, `oneOwner`, `personalUse`, `serviceRecords` | boolean | Quality filters. | | `bodyStyles`, `valueBadges`, `exteriorColors`, `interiorColors`, `driveTypes`, `engines`, `fuelTypes`, `popularOptions` | array | List filters. | | `transmission` | enum | `Automatic`, `Manual`, `Unspecified`. | | `maxItems` | integer | Cap on returned listings. | | `requestDelay` | number | Optional soft delay between requests. | | `proxyConfiguration` | object | 🛡️ Default = no proxy. Actor auto-falls-back. | #### Example input ```json { "zipcode": "10001", "type": "used", "sort": "BEST", "radius": "50", "maker": "Honda", "model": "Civic", "minYear": 2018, "maxYear": 2024, "priceUnder": 25000, "oneOwner": true, "noAccidents": true, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false } } ```` Or with explicit URLs: ```json { "urls": [ { "url": "https://www.carfax.com/vehicle/1GTW7AFP5R1189896" }, { "url": "https://www.carfax.com/vehicle/5N1AT3CB1RC734551" } ], "maxItems": 50 } ``` *** ### 📤 Output Every record is pushed to the dataset **the moment it is scraped** (live saving). Sample item: ```json { "url": "https://www.carfax.com/vehicle/1GTW7AFP5R1189896", "vin": "1GTW7AFP5R1189896", "title": "Used 2024 GMC Savana 2500", "mileage": "10,263 miles", "color": "White", "bodyType": "Van", "engine": "6 Cyl 4.3 L", "transmission": "Automatic", "currentPrice": 30800, "listPrice": 30800, "onePrice": 32860, "badge": "GREAT", "dealerName": "Atlantic Chevrolet", "dealerCity": "Bay Shore", "dealerState": "NY", "dealerPhone": "6317720769", "dealerAverageRating": 4.5, "oneOwner": true, "noAccidents": false, "serviceRecords": true, "ownerHistory": [{ "ownerNumber": 1, "purchaseDate": "05/24/24", "city": "Phoenix", "state": "AZ" }], "accidentHistory": ["Other damage reported"], "images": ["https://carfax-img.vast.com/.../1/344x258", "…"] } ``` The dataset ships with **four views** so the Apify Console renders the output in clean tables: - **Overview** — title, year, make/model, price, mileage, colors, dealer, image, link - **Dealer** — address, phone, rating, reviews, group, franchise - **History** — VIN, owner history, accidents, service records, use history - **Price** — list/current/one price, monthly payment estimate, badges *** ### 🚀 How to Use (Apify Console) 1. Sign in at . 2. Open this actor and click **Start**. 3. Fill in either: - 🔗 a list of vehicle URLs/VINs, **or** - 📍 a ZIP + filters. 4. Leave proxy on default (no proxy) — the actor auto-escalates if Carfax pushes back. 5. Watch the live log — every vehicle is announced as it lands. 6. Open the **Output** tab and pick a view (Overview / Dealer / History / Price). 7. Export to JSON, CSV, or XLSX. ### 🤖 Use via API ```bash curl -X POST "https://api.apify.com/v2/acts/~carfax-scraper/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "zipcode": "10001", "maker": "Honda", "model": "Civic", "maxItems": 100 }' ``` *** ### 💎 Best Use Cases - 🏷️ Price-monitoring across dealers in a region - 🚙 Inventory analytics for car-buying tools and aggregators - 📊 Market analysis (price/mileage/age curves by make-model-trim) - 🛡️ Pre-purchase due-diligence — accident & owner history pull-through - 📞 Sales enablement — dealer contact + review surface *** ### 💰 Pricing — Pay Per Event This actor uses **Pay-Per-Event** billing. You pay only for two events: | Event | When | Charge | |---|---|---| | `actor-start` | Once per run | Small flat fee | | `result-item` | Per vehicle saved | Per-item fee | Failed runs (no items) cost only the start fee. If you hit your spend cap the actor stops cleanly — it never errors out. *** ### ❓ Frequently Asked Questions **Why does the run start with no proxy?** Because Carfax often serves clean responses without one. The actor only escalates to a proxy when it sees a real block, saving you both time and proxy credits. **What happens if my proxy choice keeps getting blocked?** After 3 failed retries on residential, the actor logs the failure and stops cleanly. The dataset still contains everything it already saved. **Can I scrape Carfax-Canada / Carfax-UK?** Today, US Carfax only. Open an issue if you need another region. **Why is the output table empty in the Console?** Switch to the **Overview**, **Dealer**, **History**, or **Price** view — those are pre-built. The default empty view will fill in as soon as the first item is pushed. **How do I extract VINs from URLs?** Done automatically — paste full vehicle URLs and the actor pulls the VIN out of the path. *** ### ⚖️ Cautions / Legal - Data is collected only from publicly accessible Carfax pages. - The end user is responsible for compliance with Carfax's terms of service and applicable laws (GDPR, CCPA, anti-spam, etc.). - The actor honours reasonable rate limits and uses random jitter between requests. *** ### 📨 Support & Feedback Found a bug or want a new field? Open an issue on this actor's page — feedback is read and answered. # Actor input Schema ## `urls` (type: `array`): Paste one or more Carfax vehicle detail page URLs (e.g. `https://www.carfax.com/vehicle/1GTW7AFP5R1189896`). When set, the actor scrapes these directly and skips search filters. ## `VIN` (type: `string`): Look up exactly one vehicle by 17-character VIN. Quickest path for a single record. ## `VINs` (type: `array`): Look up multiple vehicles by VIN — each is fetched concurrently. ## `zipcode` (type: `string`): US ZIP code for the search center. Required when not using URLs/VINs. ## `type` (type: `string`): Used or New inventory. ## `sort` (type: `string`): How the search results are ordered. ## `radius` (type: `string`): Distance from the ZIP code to include. ## `maker` (type: `string`): Vehicle manufacturer. Pick *All Makes* to include every brand. ## `model` (type: `string`): Model name (e.g. Civic, F-150). Leave blank for any. ## `minYear` (type: `string`): Earliest model year to include. Leave blank for no lower bound. ## `maxYear` (type: `string`): Latest model year to include. Leave blank for no upper bound. ## `priceOver` (type: `integer`): Minimum listing price. ## `priceUnder` (type: `integer`): Maximum listing price. ## `mileageMin` (type: `integer`): Minimum odometer reading. ## `mileageMax` (type: `integer`): Maximum odometer reading. ## `certified` (type: `boolean`): Only return CPO vehicles. ## `noAccidents` (type: `boolean`): Only return vehicles with no accident history. ## `oneOwner` (type: `boolean`): Only return one-owner vehicles. ## `personalUse` (type: `boolean`): Only return vehicles used for personal (non-fleet/rental) use. ## `serviceRecords` (type: `boolean`): Only return vehicles with service records on file. ## `bodyStyles` (type: `array`): Pick one or more body styles. Empty = include all. ## `valueBadges` (type: `array`): Carfax price-badge filter. Pick GREAT for top deals, GOOD for fair deals. ## `exteriorColors` (type: `array`): Pick one or more exterior colors. Empty = include all. ## `interiorColors` (type: `array`): Pick one or more interior colors. Empty = include all. ## `transmission` (type: `string`): Gearbox type. ## `driveTypes` (type: `array`): Pick one or more drivetrains. Empty = include all. ## `engines` (type: `array`): Engine configuration filter. ## `fuelTypes` (type: `array`): Pick one or more fuel types. ## `popularOptions` (type: `array`): Filter by must-have options/features. ## `maxItems` (type: `integer`): Maximum number of listings to return. ## `proxyConfiguration` (type: `object`): Apify proxy settings for this run. ## Actor input object example ```json { "urls": [], "VINs": [], "zipcode": "10001", "type": "used", "sort": "BEST", "radius": "50", "maker": "All Makes", "certified": false, "noAccidents": false, "oneOwner": false, "personalUse": false, "serviceRecords": false, "bodyStyles": [], "valueBadges": [], "exteriorColors": [], "interiorColors": [], "transmission": "", "driveTypes": [], "engines": [], "fuelTypes": [], "popularOptions": [], "maxItems": 10, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 = { "urls": [], "VINs": [], "zipcode": "10001", "bodyStyles": [], "valueBadges": [], "exteriorColors": [], "interiorColors": [], "driveTypes": [], "engines": [], "fuelTypes": [], "popularOptions": [], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("api-empire/carfax-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 = { "urls": [], "VINs": [], "zipcode": "10001", "bodyStyles": [], "valueBadges": [], "exteriorColors": [], "interiorColors": [], "driveTypes": [], "engines": [], "fuelTypes": [], "popularOptions": [], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("api-empire/carfax-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 '{ "urls": [], "VINs": [], "zipcode": "10001", "bodyStyles": [], "valueBadges": [], "exteriorColors": [], "interiorColors": [], "driveTypes": [], "engines": [], "fuelTypes": [], "popularOptions": [], "proxyConfiguration": { "useApifyProxy": false } }' | apify call api-empire/carfax-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=api-empire/carfax-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "🚗 Carfax.com Scraper", "description": null, "version": "0.1", "x-build-id": "n9TIEYd6dS79PIEPG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~carfax-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-carfax-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/api-empire~carfax-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-carfax-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/api-empire~carfax-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-carfax-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": { "urls": { "title": "🔗 Vehicle URLs (bulk)", "type": "array", "description": "Paste one or more Carfax vehicle detail page URLs (e.g. `https://www.carfax.com/vehicle/1GTW7AFP5R1189896`). When set, the actor scrapes these directly and skips search filters.", "items": { "type": "string" } }, "VIN": { "title": "🆔 Single VIN", "type": "string", "description": "Look up exactly one vehicle by 17-character VIN. Quickest path for a single record." }, "VINs": { "title": "🆔 VINs (bulk)", "type": "array", "description": "Look up multiple vehicles by VIN — each is fetched concurrently.", "items": { "type": "string" } }, "zipcode": { "title": "📍 ZIP code", "type": "string", "description": "US ZIP code for the search center. Required when not using URLs/VINs." }, "type": { "title": "🏷️ Listing type", "enum": [ "used", "new" ], "type": "string", "description": "Used or New inventory.", "default": "used" }, "sort": { "title": "🔀 Sort order", "enum": [ "BEST", "PRICE_ASC", "PRICE_DESC", "MILEAGE_ASC", "MILEAGE_DESC", "YEAR_ASC", "YEAR_DESC", "LOCATION_NEAREST", "LISTING_DATE_ASC", "LISTING_DATE_DESC" ], "type": "string", "description": "How the search results are ordered.", "default": "BEST" }, "radius": { "title": "📏 Search radius (miles)", "enum": [ "10", "25", "50", "75", "100", "150", "200", "250", "500", "3000" ], "type": "string", "description": "Distance from the ZIP code to include.", "default": "50" }, "maker": { "title": "🏭 Make", "enum": [ "All Makes", "Acura", "Alfa Romeo", "Audi", "BMW", "Buick", "Cadillac", "Chevrolet", "Chrysler", "Dodge", "Fiat", "Ford", "GMC", "Genesis", "Honda", "Hyundai", "Infiniti", "Jaguar", "Jeep", "Kia", "Land Rover", "Lexus", "Lincoln", "Mazda", "Mercedes-Benz", "Mini", "Mitsubishi", "Nissan", "Porsche", "Ram", "Subaru", "Tesla", "Toyota", "Volkswagen", "Volvo", "AM General", "American Motors", "Aston Martin", "Avanti", "Bentley", "BrightDrop", "Bugatti", "Daewoo", "Daihatsu", "Datsun", "Delorean", "Eagle", "Ferrari", "Fisker", "Freightliner", "Geo", "Hummer", "INEOS", "Isuzu", "Karma", "Laforza", "Lamborghini", "Lotus", "Lucid", "Maserati", "Maybach", "Mclaren", "Mercury", "Merkur", "Mobility Ventures", "Oldsmobile", "Opel", "Pagani", "Panoz", "Plymouth", "Polestar", "Pontiac", "Rimac", "Rivian", "Rolls-Royce", "Saab", "Saturn", "Scion", "Shelby", "Smart", "Spyker", "Sterling", "Suzuki", "Th!nk", "VPG", "VinFast" ], "type": "string", "description": "Vehicle manufacturer. Pick *All Makes* to include every brand.", "default": "All Makes" }, "model": { "title": "🚙 Model", "type": "string", "description": "Model name (e.g. Civic, F-150). Leave blank for any." }, "minYear": { "title": "📅 Min Year", "enum": [ "1981", "1982", "1983", "1984", "1985", "1986", "1987", "1988", "1989", "1990", "1991", "1992", "1993", "1994", "1995", "1996", "1997", "1998", "1999", "2000", "2001", "2002", "2003", "2004", "2005", "2006", "2007", "2008", "2009", "2010", "2011", "2012", "2013", "2014", "2015", "2016", "2017", "2018", "2019", "2020", "2021", "2022", "2023", "2024", "2025", "2026" ], "type": "string", "description": "Earliest model year to include. Leave blank for no lower bound." }, "maxYear": { "title": "📅 Max Year", "enum": [ "1981", "1982", "1983", "1984", "1985", "1986", "1987", "1988", "1989", "1990", "1991", "1992", "1993", "1994", "1995", "1996", "1997", "1998", "1999", "2000", "2001", "2002", "2003", "2004", "2005", "2006", "2007", "2008", "2009", "2010", "2011", "2012", "2013", "2014", "2015", "2016", "2017", "2018", "2019", "2020", "2021", "2022", "2023", "2024", "2025", "2026" ], "type": "string", "description": "Latest model year to include. Leave blank for no upper bound." }, "priceOver": { "title": "💵 Min price (USD)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Minimum listing price." }, "priceUnder": { "title": "💸 Max price (USD)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Maximum listing price." }, "mileageMin": { "title": "🛣️ Min mileage", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Minimum odometer reading." }, "mileageMax": { "title": "🛣️ Max mileage", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Maximum odometer reading." }, "certified": { "title": "✅ Certified Pre-Owned only", "type": "boolean", "description": "Only return CPO vehicles.", "default": false }, "noAccidents": { "title": "🛡️ No reported accidents", "type": "boolean", "description": "Only return vehicles with no accident history.", "default": false }, "oneOwner": { "title": "👤 One-owner only", "type": "boolean", "description": "Only return one-owner vehicles.", "default": false }, "personalUse": { "title": "🏠 Personal-use only", "type": "boolean", "description": "Only return vehicles used for personal (non-fleet/rental) use.", "default": false }, "serviceRecords": { "title": "🔧 Has service records", "type": "boolean", "description": "Only return vehicles with service records on file.", "default": false }, "bodyStyles": { "title": "🚘 Body styles", "uniqueItems": true, "type": "array", "description": "Pick one or more body styles. Empty = include all.", "items": { "type": "string", "enum": [ "SUV", "Sedan", "Pickup", "Coupe", "Hatchback", "Minivan", "Van", "Wagon", "Convertible", "Chassis", "Unspecified" ] } }, "valueBadges": { "title": "🏷️ Value badges", "uniqueItems": true, "type": "array", "description": "Carfax price-badge filter. Pick GREAT for top deals, GOOD for fair deals.", "items": { "type": "string", "enum": [ "GREAT", "GOOD" ] } }, "exteriorColors": { "title": "🎨 Exterior colors", "uniqueItems": true, "type": "array", "description": "Pick one or more exterior colors. Empty = include all.", "items": { "type": "string", "enum": [ "White", "Black", "Gray", "Blue", "Silver", "Red", "Green", "Brown", "Beige", "Orange", "Burgundy", "Yellow", "Gold", "Bronze", "Purple", "Turquoise", "Pink", "Unspecified" ] } }, "interiorColors": { "title": "🪑 Interior colors", "uniqueItems": true, "type": "array", "description": "Pick one or more interior colors. Empty = include all.", "items": { "type": "string", "enum": [ "Black", "Gray", "Tan", "Brown", "Red", "White", "Blue", "Orange", "Yellow", "Green", "Unspecified" ] } }, "transmission": { "title": "⚙️ Transmission", "enum": [ "", "Automatic", "Manual", "Unspecified" ], "type": "string", "description": "Gearbox type.", "default": "" }, "driveTypes": { "title": "🛞 Drive types", "uniqueItems": true, "type": "array", "description": "Pick one or more drivetrains. Empty = include all.", "items": { "type": "string", "enum": [ "AWD", "4WD", "FWD", "RWD", "Unspecified" ] } }, "engines": { "title": "🔩 Engines", "uniqueItems": true, "type": "array", "description": "Engine configuration filter.", "items": { "type": "string", "enum": [ "3 Cyl", "4 Cyl", "5 Cyl", "6 Cyl", "8 Cyl", "10 Cyl", "12 Cyl", "Electric", "Unspecified" ] } }, "fuelTypes": { "title": "⛽ Fuel types", "uniqueItems": true, "type": "array", "description": "Pick one or more fuel types.", "items": { "type": "string", "enum": [ "Gasoline", "Hybrid", "Flexible-Fuel", "Electric", "Diesel", "Alternative", "Unspecified" ] } }, "popularOptions": { "title": "🌟 Popular options", "uniqueItems": true, "type": "array", "description": "Filter by must-have options/features.", "items": { "type": "string", "enum": [ "Adaptive Cruise Control", "Alloy Wheels", "Android Auto", "Anti-Theft System", "Apple Carplay", "Automatic Headlights", "Blind Spot Monitor", "Braking Assist", "Bucket Seats", "Cross Traffic Alert", "Digital Instrument Cluster", "Dual Exhaust", "Dual-Zone Climate Control", "Fog Lights", "Folding Mirrors", "Front bench seat", "HD Radio", "Handsfree/Bluetooth Integration", "Heated Mirrors", "Heated Seats", "Heated Steering Wheel", "High-Beam Assist", "Keyless Entry", "Keyless Ignition", "LED Lights", "Lane Departure Warning", "Leather Seats", "Limited Slip Differential", "Navigation System", "Power Folding Mirrors", "Power Liftgate", "Premium Sound System", "Privacy Glass", "Rain-Sensing Wipers", "Rear Air Conditioning", "Rear Heated Seats", "Rear-View Camera", "Remote Start", "Roof Rails", "Satellite Radio", "Seat Memory", "Smart Key", "Spoiler", "Stability Control", "Steering Wheel Controls", "Third Row Seating", "Tinted Windows", "Tire Pressure Monitoring System", "Traction Control", "Ventilated Seats" ] } }, "maxItems": { "title": "🔢 Max items", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of listings to return.", "default": 10 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify proxy settings for this run.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```