{ "openapi": "3.0.1", "info": { "title": "CarMax Used Car Listings & Price Drop Alerts", "description": "Search CarMax.com used-car inventory by make and model near a ZIP code and get one flat row per car: price, price drop, mileage, store, shipping fee, trim, colours, engine, MPG, features, VIN, URL. Newest listings first. For new-inventory and price-drop alerts.", "version": "0.1", "x-build-id": "ZTD9sqePdAOQvlj6R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/superslowsloth~carmax-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-superslowsloth-carmax-listings", "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/superslowsloth~carmax-listings/runs": { "post": { "operationId": "runs-sync-superslowsloth-carmax-listings", "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/superslowsloth~carmax-listings/run-sync": { "post": { "operationId": "run-sync-superslowsloth-carmax-listings", "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": [ "make", "zipCode" ], "properties": { "make": { "title": "Make", "type": "string", "description": "The make to search, as it appears in a carmax.com address (for example toyota, ford, land-rover or mercedes-benz). Case and spaces do not matter. CarMax answers a make it does not know with its whole inventory, so the actor checks the make against CarMax's own list and stops with the list of valid makes instead." }, "model": { "title": "Model", "type": "string", "description": "Optional. Only this model of the make, as it appears in a carmax.com address (for example camry, cr-v, f150 or mustang-mach-e; F-150 and Mustang Mach-E are mapped onto CarMax's spelling). Leave empty for every model of the make." }, "zipCode": { "title": "ZIP code", "type": "string", "description": "A five-digit US ZIP code, for example 60601. CarMax measures each car's distance, shipping fee and arrival dates from the store assigned to this ZIP. A ZIP CarMax does not recognise stops the run before anything is charged." }, "radius": { "title": "Search radius", "enum": [ "nationwide", "25", "50", "75", "100", "250", "500" ], "type": "string", "description": "Only cars at stores within this many miles of the ZIP code, or nationwide (every CarMax store, with the shipping fee to bring the car to you). Only the distances CarMax honours are offered; it ignores 5 miles and answers nationwide.", "default": "nationwide" }, "sort": { "title": "Sort order", "enum": [ "new-arrival", "price-asc", "price-desc", "mileage-asc", "mileage-desc", "year-desc", "year-asc", "distance-asc", "best-match" ], "type": "string", "description": "The order CarMax lists the cars in. 'Newest listings first' orders by when CarMax made each car available and is the one to schedule for new-inventory alerts; cars that are coming soon (not yet for sale) have no such date. 'Distance' is measured from the ZIP code.", "default": "new-arrival" }, "maxItems": { "title": "Max cars", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Read at most this many cars. CarMax serves 100 per request. Up to 10,000 are accepted; a single make can hold several thousand (Ford: about 3,450 on 2026-10-12).", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy (automatic datacenter exits) is the default. CarMax's edge now and then answers a request with an Access Denied page (HTTP 403); the request is retried from a fresh address, which is what the proxy is for.", "default": { "useApifyProxy": true } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }