{ "openapi": "3.0.1", "info": { "title": "Cars.com Scraper (US Used & New Car Listings + Dealer Leads)", "description": "Scrape cars.com vehicle listings by make, model and zip or by listing URL. Get price, year, make, model, trim, mileage, VIN, colors, body style, deal rating, dealer name, phone and location. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "3GWw9ca6M80NW3z3Z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~cars-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-cars-com-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/scrapers_lat~cars-com-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-cars-com-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/scrapers_lat~cars-com-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-cars-com-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": { "make": { "title": "Make", "type": "string", "description": "Vehicle make to search, for example Honda, Toyota, Ford or Tesla. Combined with Model and Zip to build the search. Leave empty to search all makes near the zip." }, "model": { "title": "Model", "type": "string", "description": "Vehicle model to search, for example Accord, Camry or F-150. Requires Make. Leave empty to include all models of the make." }, "zip": { "title": "ZIP Code", "type": "string", "description": "US ZIP code to center the search on, for example 90001. The scraper searches nationwide and reports each dealer's distance from this ZIP." }, "maxPrice": { "title": "Maximum Price (USD)", "minimum": 0, "type": "integer", "description": "Only keep listings priced at or below this amount in US dollars. Leave empty for no maximum." }, "maxMileage": { "title": "Maximum Mileage", "minimum": 0, "type": "integer", "description": "Only keep listings with mileage at or below this number. Leave empty for no maximum." }, "yearMin": { "title": "Minimum Year", "minimum": 1980, "type": "integer", "description": "Only keep listings from this model year or newer. Leave empty for no minimum." }, "listingUrls": { "title": "Listing URLs", "type": "array", "description": "Optional list of individual cars.com vehicle detail URLs (https://www.cars.com/vehicledetail//) to scrape directly with full detail (dealer phone, stock number, transmission, interior color, features and all photos).", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Max Listings To Scrape", "minimum": 1, "type": "integer", "description": "Maximum number of listings to collect across the whole run. Free Apify plans are capped at 10 per run." }, "dealerContact": { "title": "Add dealer contact and full detail enrichment (paid add-on, off by default)", "type": "boolean", "description": "Fetch each vehicle detail page to add the dealer phone number, stock number, transmission, interior color, cylinders, doors, certified status, the full feature list and all photos. Charged only when a real contact or detail is returned. Disabled on free plans.", "default": false }, "aiDealSummary": { "title": "Add AI deal summary (paid add-on, off by default)", "type": "boolean", "description": "Use AI to produce a deal assessment, condition notes, buyer negotiation tips and the ideal target buyer for each listing. Charged only when a usable summary is returned. Disabled on free plans.", "default": 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 } } } } } } } } } }