# AutoWeb Car Scraper (`crawlergang/autoweb-scraper`) Actor Scrape Autoweb.com for new car models, pricing, specs, and features. Search by make, model, year, or body style. Extracts MSRP, MPG, body styles, passenger capacity, and images for 50+ car brands. - **URL**: https://apify.com/crawlergang/autoweb-scraper.md - **Developed by:** [Crawler Gang](https://apify.com/crawlergang) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 11 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## AutoWeb Car Scraper Extract new car model data from [Autoweb.com](https://www.autoweb.com) — a comprehensive automotive research platform. Search for vehicles by make, model, year, and body style. Get MSRP pricing, fuel economy (MPG), body styles, passenger capacity, and high-quality images for 40+ car brands. **Data Source**: Autoweb.com (powered by the Autobytel/Dealix vehicle database) ### What Does This Scraper Do? This actor queries the Autoweb vehicle catalog API to retrieve car model data without any login or credentials. Use it to: - **Search** — filter by make, model, year, body style - **Browse by Make** — all models from a specific brand - **Get Make+Model details** — available years and specs for a specific model - **List all makes** — all 40+ supported car brands ### Output Data Each record contains: | Field | Description | |-------|-------------| | `title` | Full title (e.g., "2026 Honda Civic") | | `url` | Autoweb search URL for this model | | `modelId` | Internal model ID | | `make` | Car manufacturer (e.g., "Honda") | | `makeSlug` | URL-safe make name (e.g., "honda") | | `model` | Model name (e.g., "Civic") | | `modelSlug` | URL-safe model name (e.g., "civic") | | `year` | Model year | | `condition` | New / Used / New & Used / Discontinued | | `msrpMin` | Minimum MSRP in USD | | `msrpMax` | Maximum MSRP in USD | | `mpgMin` | Minimum combined MPG | | `mpgMax` | Maximum combined MPG | | `bodyStyles` | Array of body styles (e.g., ["Sedan", "Hatchback"]) | | `passengerCapacityMin` | Minimum passenger count | | `passengerCapacityMax` | Maximum passenger count | | `imageUrl` | High-quality vehicle image URL | | `defaultStyleId` | Internal style ID for detailed trim data | | `scrapedAt` | ISO timestamp of when data was scraped | ### Input Parameters | Parameter | Type | Description | |-----------|------|-------------| | `mode` | select | `search`, `byMake`, `byMakeModel`, `allMakes` | | `make` | select | Car brand slug (e.g., `honda`, `toyota`, `ford`) | | `model` | string | Model name slug (e.g., `civic`, `camry`, `f-150`) | | `year` | integer | Filter by model year (2015–2030) | | `bodyStyle` | select | Filter: `sedan`, `suv`, `truck`, `coupe`, etc. | | `includeUsedOnly` | boolean | Include discontinued/used-only models (default: false) | | `maxItems` | integer | Maximum records to return (1–500, default 20) | ### Supported Car Makes Acura, Alfa Romeo, Aston Martin, Audi, Bentley, BMW, Buick, Cadillac, Chevrolet, Chrysler, Dodge, Ferrari, Ford, Genesis, GMC, Honda, Hyundai, INFINITI, Jaguar, Jeep, Kia, Lamborghini, Land Rover, Lexus, Lincoln, Lucid, Maserati, Mazda, Mercedes-Benz, MINI, Mitsubishi, Nissan, Polestar, Porsche, Ram, Rivian, Rolls-Royce, Subaru, Tesla, Toyota, Volkswagen, Volvo ### Example Use Cases #### Search all Honda SUVs for 2026 ```json { "mode": "search", "make": "honda", "year": 2026, "bodyStyle": "suv", "maxItems": 20 } ```` #### All Toyota models for 2025 ```json { "mode": "byMake", "make": "toyota", "year": 2025, "maxItems": 50 } ``` #### Honda Civic across all years ```json { "mode": "byMakeModel", "make": "honda", "model": "civic", "maxItems": 10 } ``` #### List all car brands ```json { "mode": "allMakes", "maxItems": 50 } ``` ### Frequently Asked Questions **Q: Does this require an API key or login?** A: No. The scraper uses Autoweb's public vehicle database API which does not require authentication. **Q: What data is included?** A: New car model data including pricing (MSRP), MPG, body styles, passenger capacity, and images. Dealer inventory (actual for-sale listings with VINs) requires a ZIP code on Autoweb and is outside the scope of this actor. **Q: How current is the data?** A: The Autobytel vehicle database is updated regularly with new model year data. **Q: Can I get specific trim data?** A: The `defaultStyleId` field in each record can be used to request additional trim details from the Autobytel API. **Q: Why does AutoWeb scraper use the Dealix/Autobytel API?** A: Autoweb.com is a Next.js application that loads its vehicle data client-side from the Autobytel/Dealix API. This actor queries that same public API directly, which is more reliable and efficient than browser automation. **Q: Can I search used car listings?** A: This actor returns car model information (MSRP, specs, images). For actual used car listings with dealer inventory and VINs, check the sister actor for UsedCars.com. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `make` (type: `string`): Car manufacturer slug (e.g. `honda`, `toyota`, `ford`). Used in all modes except `allMakes`. ## `model` (type: `string`): Car model slug (e.g. `civic`, `camry`, `f-150`). Used in `byMakeModel` mode. ## `year` (type: `integer`): Filter by model year (e.g. 2024, 2025, 2026). ## `bodyStyle` (type: `string`): Filter by body style. ## `includeUsedOnly` (type: `boolean`): Include models that are no longer produced as new cars. ## `maxItems` (type: `integer`): Hard cap on emitted records. ## Actor input object example ```json { "mode": "allMakes", "make": "honda", "model": "civic", "bodyStyle": "", "includeUsedOnly": false, "maxItems": 20 } ``` # Actor output Schema ## `cars` (type: `string`): Dataset containing all scraped car model records. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "allMakes", "make": "honda", "model": "civic", "bodyStyle": "", "includeUsedOnly": false, "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlergang/autoweb-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "allMakes", "make": "honda", "model": "civic", "bodyStyle": "", "includeUsedOnly": False, "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlergang/autoweb-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "allMakes", "make": "honda", "model": "civic", "bodyStyle": "", "includeUsedOnly": false, "maxItems": 20 }' | apify call crawlergang/autoweb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlergang/autoweb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AutoWeb Car Scraper", "description": "Scrape Autoweb.com for new car models, pricing, specs, and features. Search by make, model, year, or body style. Extracts MSRP, MPG, body styles, passenger capacity, and images for 50+ car brands.", "version": "1.0", "x-build-id": "1UQtVcwxTkEcdl9U1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlergang~autoweb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlergang-autoweb-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/crawlergang~autoweb-scraper/runs": { "post": { "operationId": "runs-sync-crawlergang-autoweb-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/crawlergang~autoweb-scraper/run-sync": { "post": { "operationId": "run-sync-crawlergang-autoweb-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byMake", "byMakeModel", "allMakes" ], "type": "string", "description": "What to fetch.", "default": "allMakes" }, "make": { "title": "Make", "enum": [ "acura", "alfa-romeo", "aston-martin", "audi", "bentley", "bmw", "buick", "cadillac", "chevrolet", "chrysler", "dodge", "ferrari", "ford", "genesis", "gmc", "honda", "hyundai", "infiniti", "jaguar", "jeep", "kia", "lamborghini", "land-rover", "lexus", "lincoln", "lucid", "maserati", "mazda", "mercedes-benz", "mini", "mitsubishi", "nissan", "polestar", "porsche", "ram", "rivian", "rolls-royce", "subaru", "tesla", "toyota", "volkswagen", "volvo" ], "type": "string", "description": "Car manufacturer slug (e.g. `honda`, `toyota`, `ford`). Used in all modes except `allMakes`.", "default": "honda" }, "model": { "title": "Model", "type": "string", "description": "Car model slug (e.g. `civic`, `camry`, `f-150`). Used in `byMakeModel` mode.", "default": "civic" }, "year": { "title": "Model year", "minimum": 2015, "maximum": 2030, "type": "integer", "description": "Filter by model year (e.g. 2024, 2025, 2026)." }, "bodyStyle": { "title": "Body style", "enum": [ "", "sedan", "suv", "truck", "coupe", "convertible", "wagon", "hatchback", "van", "minivan" ], "type": "string", "description": "Filter by body style.", "default": "" }, "includeUsedOnly": { "title": "Include used-car-only models", "type": "boolean", "description": "Include models that are no longer produced as new cars.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on emitted records.", "default": 20 } } }, "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 } } } } } } } } } } ```