{ "openapi": "3.0.1", "info": { "title": "Carvana Scraper", "description": "Scrape vehicle listings from Carvana.com. Extracts price, mileage, VIN, year, make, model, trim, color, photos, and availability status. Supports full inventory scrape, filtered search by make/model, or direct URL input. Uses Playwright with residential proxies to bypass bot detection.", "version": "1.0", "x-build-id": "462XaUbCU1ZY7Z1hE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nickgardner829~carvana-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nickgardner829-carvana-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/nickgardner829~carvana-scraper/runs": { "post": { "operationId": "runs-sync-nickgardner829-carvana-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/nickgardner829~carvana-scraper/run-sync": { "post": { "operationId": "run-sync-nickgardner829-carvana-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": { "mode": { "title": "Scrape Mode", "enum": [ "full", "filter", "url" ], "type": "string", "description": "Select how to scrape Carvana inventory. Use 'full' to scrape all available vehicles across the entire site. Use 'filter' to narrow results by make and model (e.g., only Toyota Camry). Use 'url' to scrape specific Carvana search or vehicle detail page URLs that you provide.", "default": "full" }, "make": { "title": "Make", "type": "string", "description": "The car manufacturer to filter by when using 'filter' mode. Enter the brand name exactly as shown on Carvana (e.g., 'Toyota', 'Honda', 'BMW', 'Tesla'). This field is ignored in 'full' and 'url' modes." }, "model": { "title": "Model", "type": "string", "description": "The car model to filter by when using 'filter' mode. Enter the model name exactly as shown on Carvana (e.g., 'Camry', 'Civic', 'Model 3'). Leave empty to get all models from the selected make. This field is ignored in 'full' and 'url' modes." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "A list of Carvana URLs to scrape when using 'url' mode. You can provide search result page URLs (e.g., https://www.carvana.com/cars/filters) or individual vehicle detail page URLs (e.g., https://www.carvana.com/vehicle/1234567). This field is ignored in 'full' and 'filter' modes.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "enrichDetails": { "title": "Enrich from Detail Pages", "type": "boolean", "description": "When enabled, the scraper visits each vehicle's individual detail page to extract additional fields like body style, fuel type, and interior color. This produces more complete data but runs significantly slower because it loads a separate page for every vehicle. Keep disabled for faster runs when basic listing data (price, mileage, VIN, color, photos) is sufficient.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "The maximum number of vehicles to scrape before stopping. Useful for controlling run time and cost. For example, set to 50 to get 50 vehicles. Set to 0 for unlimited (scrapes all matching vehicles). Higher values require more compute time and proxy usage.", "default": 20 }, "proxyConfig": { "title": "Proxy Configuration", "type": "object", "description": "Proxy server settings for accessing Carvana. Residential proxies are strongly recommended because Carvana uses bot detection (PerimeterX) that blocks datacenter IPs. The default Apify residential proxy group works well. You can also provide your own proxy URLs if you have a preferred provider." } } }, "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 } } } } } } } } } }