{ "openapi": "3.0.1", "info": { "title": "Autotrader Scraper", "description": "Collect car listings from Autotrader.com with 42 data fields per vehicle including price, mileage, VIN, specs, seller contact info, deal ratings, and photo galleries. Search by make, model, year range, ZIP code, and radius. Export as JSON, CSV, or Excel for market research and inventory sourcing.", "version": "0.0", "x-build-id": "1qADIHFsrRr7TFgoY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~autotrader-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-autotrader-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/parseforge~autotrader-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-autotrader-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/parseforge~autotrader-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-autotrader-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": { "startUrl": { "title": "Start URL", "type": "string", "description": "AutoTrader search URL to scrape (copy it from your browser after applying filters on autotrader.com). When provided, the search filters below are ignored." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "zip": { "title": "ZIP Code", "type": "string", "description": "US ZIP code the search is centered on (e.g. 90210).", "default": "90210" }, "searchRadius": { "title": "Search Radius (miles)", "minimum": 0, "maximum": 500, "type": "integer", "description": "Distance from the ZIP code (10, 25, 50, 75, 100, 200, 300, 400 or 500). Use 0 for a nationwide search.", "default": 50 }, "listingType": { "title": "Listing Type", "enum": [ "ALL", "USED", "NEW", "CERTIFIED" ], "type": "string", "description": "New, used or certified pre-owned inventory.", "default": "USED" }, "make": { "title": "Make", "enum": [ "ACURA", "ALFA", "AMC", "ASTON", "AUDI", "BENTL", "BMW", "BUGATTI", "BUICK", "CAD", "CHEV", "CHRY", "DAEW", "DATSUN", "DELOREAN", "DODGE", "EAGLE", "FER", "FIAT", "FISK", "FORD", "FREIGHT", "GENESIS", "GEO", "GMC", "HONDA", "AMGEN", "HYUND", "INEOS", "INFIN", "ISU", "JAG", "JEEP", "KARMA", "KIA", "LAM", "ROV", "LEXUS", "LINC", "LOTUS", "LUCID", "MAS", "MAYBACH", "MAZDA", "MCLAREN", "MB", "MERC", "MINI", "MIT", "NISSAN", "OLDS", "PAGANI", "PLYM", "POLESTAR", "PONT", "POR", "RAM", "RIVIAN", "RR", "SAAB", "SATURN", "SCION", "SMART", "SRT", "SUB", "SUZUKI", "TESLA", "TOYOTA", "VINFAST", "VOLKS", "VOLVO", "YUGO" ], "type": "string", "description": "Vehicle manufacturer. Leave empty for all makes." }, "model": { "title": "Model code", "type": "string", "description": "AutoTrader model code, e.g. CIVIC, CAMRY, JAGFPACE. Models depend on the selected make - copy the modelCodeList value from an autotrader.com search URL." }, "trim": { "title": "Trim code", "type": "string", "description": "AutoTrader trim code, e.g. \"CIVIC|EX\". Copy the trimCodeList value from an autotrader.com search URL." }, "minPrice": { "title": "Min Price ($)", "minimum": 0, "type": "integer", "description": "Minimum listing price in USD." }, "maxPrice": { "title": "Max Price ($)", "minimum": 0, "type": "integer", "description": "Maximum listing price in USD." }, "minYear": { "title": "Min Year", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Earliest model year." }, "maxYear": { "title": "Max Year", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Latest model year." }, "maxMileage": { "title": "Max Mileage", "minimum": 0, "type": "integer", "description": "Maximum odometer reading in miles." }, "bodyStyle": { "title": "Body Style", "enum": [ "CONVERT", "COUPE", "HATCH", "SEDAN", "SUVCROSS", "TRUCKS", "VANMV", "WAGON" ], "type": "string", "description": "Vehicle body style." }, "driveGroup": { "title": "Drivetrain", "enum": [ "AWD4WD", "FWD", "RWD" ], "type": "string", "description": "Drivetrain configuration." }, "fuelTypeGroup": { "title": "Fuel Type", "enum": [ "ELE", "GSL", "HYB", "PIH", "DSL", "HYD" ], "type": "string", "description": "Engine fuel type." }, "transmissionCode": { "title": "Transmission", "enum": [ "AUT", "MAN" ], "type": "string", "description": "Transmission type." }, "exteriorColor": { "title": "Exterior Color", "enum": [ "BEIGE", "BLACK", "BLUE", "BROWN", "BURGUNDY", "CHARCOAL", "GOLD", "GRAY", "GREEN", "OFFWHITE", "ORANGE", "PINK", "PURPLE", "RED", "SILVER", "TAN", "TURQUOISE", "WHITE", "YELLOW" ], "type": "string", "description": "Simplified exterior color." }, "sellerType": { "title": "Seller Type", "enum": [ "d", "p" ], "type": "string", "description": "Dealer or private seller listings." }, "dealType": { "title": "Deal Rating", "enum": [ "goodprice", "greatprice" ], "type": "string", "description": "Only return listings AutoTrader rates as a good or great price." }, "vehicleHistoryType": { "title": "Vehicle History", "enum": [ "NO_ACCIDENTS", "ONE_OWNER", "CLEAN_TITLE", "NO_FRAME_DAMAGE", "FREE_REPORT" ], "type": "string", "description": "Filter by vehicle history report highlights." }, "keywords": { "title": "Keywords", "type": "string", "description": "Free-text keyword search applied on top of the filters (e.g. \"sunroof\")." }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "price_low", "price_high", "mileage_low", "year_new", "year_old", "distance", "newest_listing" ], "type": "string", "description": "Result ordering.", "default": "relevance" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. US residential proxies are required for AutoTrader.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }