{ "openapi": "3.0.1", "info": { "title": "Cars.com Vehicle Scraper + Instant Results", "description": "Scrape Cars.com vehicles by make, model, year, price, and mileage. Features exact listing dates, private seller only, and deduplication. Optimized for lowest cost per run using advanced extraction techniques. Advanced filtering and instant notifications of vehicles posted to Cars.com Marketplace.", "version": "0.0", "x-build-id": "SuX2a6CA60NG7IOw3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/raidr-api~cars-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-raidr-api-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/raidr-api~cars-com-scraper/runs": { "post": { "operationId": "runs-sync-raidr-api-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/raidr-api~cars-com-scraper/run-sync": { "post": { "operationId": "run-sync-raidr-api-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", "required": [ "zipCode" ], "properties": { "zipCode": { "title": "πŸ“ ZIP Code", "type": "string", "description": "5-digit US ZIP code used as the centre of the search.", "default": "77002" }, "radius": { "title": "πŸ—ΊοΈ Radius (miles)", "minimum": 10, "type": "integer", "description": "Distance around the ZIP, in miles (snapped to the nearest supported value). Default 50.", "default": 50 }, "maxItems": { "title": "πŸ“¦ Maximum Results", "minimum": 1, "type": "integer", "description": "Maximum number of unique listings to save.", "default": 100 }, "sort": { "title": "↕️ Sort Results By", "enum": [ "best-match", "newest-listed", "price-asc", "price-desc", "mileage-asc", "mileage-desc", "year-desc", "year-asc", "best-deal", "distance" ], "type": "string", "description": "Ordering for results.", "default": "best-match" }, "stockType": { "title": "🏷️ Condition", "enum": [ "all", "new", "used", "cpo", "new_cpo" ], "type": "string", "description": "New, used, or certified pre-owned.", "default": "all" }, "makes": { "title": "🚘 Makes", "type": "array", "description": "Make slugs, e.g. [\"hyundai\", \"toyota\"]. Leave empty for all makes.", "items": { "type": "string" } }, "models": { "title": "πŸš™ Models", "type": "array", "description": "Model slugs, namespaced by make, e.g. [\"hyundai-elantra\", \"toyota-camry\"].", "items": { "type": "string" } }, "minPrice": { "title": "πŸ’΅ Minimum Price ($)", "minimum": 0, "type": "integer", "description": "Minimum price in USD. Leave empty for no minimum." }, "maxPrice": { "title": "πŸ’° Maximum Price ($)", "minimum": 0, "type": "integer", "description": "Maximum price in USD. Leave empty for no maximum." }, "minYear": { "title": "πŸ“… Minimum Year", "minimum": 1900, "type": "integer", "description": "Earliest model year. Leave empty for no minimum." }, "maxYear": { "title": "πŸ“… Maximum Year", "minimum": 1900, "type": "integer", "description": "Latest model year. Leave empty for no maximum." }, "maxMileage": { "title": "🧭 Maximum Mileage", "minimum": 0, "type": "integer", "description": "Maximum odometer reading. Leave empty for no limit." }, "bodyStyles": { "title": "πŸš™ Body Styles", "uniqueItems": true, "type": "array", "description": "Filter by body style. Leave empty to include all.", "items": { "type": "string", "enum": [ "suv", "sedan", "truck", "hatchback", "coupe", "convertible", "wagon", "van", "minivan" ], "enumTitles": [ "SUV", "Sedan", "Truck", "Hatchback", "Coupe", "Convertible", "Wagon", "Van", "Minivan" ] } }, "sizes": { "title": "πŸ“ Sizes", "uniqueItems": true, "type": "array", "description": "Filter by vehicle size. Leave empty to include all.", "items": { "type": "string", "enum": [ "full_size", "mid_size", "compact", "subcompact" ], "enumTitles": [ "Full size", "Mid size", "Compact", "Subcompact" ] } }, "fuelTypes": { "title": "β›½ Fuel Types", "uniqueItems": true, "type": "array", "description": "Filter by fuel type. Leave empty to include all.", "items": { "type": "string", "enum": [ "gasoline", "electric", "hybrid", "diesel", "plug_in_hybrid" ], "enumTitles": [ "Gasoline", "Electric", "Hybrid", "Diesel", "Plug-in Hybrid" ] } }, "transmissions": { "title": "βš™οΈ Transmissions", "uniqueItems": true, "type": "array", "description": "Filter by transmission. Leave empty to include all.", "items": { "type": "string", "enum": [ "automatic", "automanual", "cvt", "manual" ], "enumTitles": [ "Automatic", "Automated Manual", "CVT", "Manual" ] } }, "drivetrains": { "title": "πŸ›ž Drivetrains", "uniqueItems": true, "type": "array", "description": "Filter by drivetrain. Leave empty to include all.", "items": { "type": "string", "enum": [ "all_wheel_drive", "four_wheel_drive", "front_wheel_drive", "rear_wheel_drive" ], "enumTitles": [ "All-Wheel Drive", "Four-Wheel Drive", "Front-Wheel Drive", "Rear-Wheel Drive" ] } }, "exteriorColors": { "title": "🎨 Exterior Colors", "uniqueItems": true, "type": "array", "description": "Filter by exterior color. Leave empty to include all.", "items": { "type": "string", "enum": [ "beige", "black", "blue", "brown", "gold", "gray", "green", "orange", "purple", "red", "silver", "white", "yellow" ] } }, "interiorColors": { "title": "πŸͺ‘ Interior Colors", "uniqueItems": true, "type": "array", "description": "Filter by interior color. Leave empty to include all.", "items": { "type": "string", "enum": [ "beige", "black", "blue", "brown", "gray", "green", "orange", "red", "white", "yellow" ] } }, "sellerTypes": { "title": "πŸ§‘β€πŸ’Ό Seller Types", "uniqueItems": true, "type": "array", "description": "Filter by seller type. Leave empty to include all.", "items": { "type": "string", "enum": [ "dealership", "online_seller", "private_seller" ], "enumTitles": [ "Dealership", "Online Seller", "Private Seller" ] } }, "dealRatings": { "title": "πŸ† Deal Ratings", "uniqueItems": true, "type": "array", "description": "Only include listings with these Cars.com deal ratings. Leave empty to include all.", "items": { "type": "string", "enum": [ "great", "good", "fair" ], "enumTitles": [ "Great Deal", "Good Deal", "Fair Deal" ] } }, "features": { "title": "✨ Features", "type": "array", "description": "Feature slugs from any group, e.g. [\"heated_seats\", \"apple_carplay\", \"backup_camera\", \"sunroof_moonroof\", \"leather_seats\"]. Each is routed to its correct filter group automatically.", "items": { "type": "string" } }, "keywords": { "title": "πŸ”‘ Keywords", "type": "array", "description": "Free-text keywords the listing must contain, e.g. [\"heated seats\"].", "items": { "type": "string" } }, "includeShippable": { "title": "🚚 Include Shippable", "type": "boolean", "description": "Include listings that can be shipped to the search area (not just local ones).", "default": false }, "onlyWithPhotos": { "title": "πŸ–ΌοΈ Only With Photos", "type": "boolean", "description": "Only include listings that have photos.", "default": false }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are strongly recommended (Cars.com is behind Cloudflare; some IPs are challenged).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }