{ "openapi": "3.0.1", "info": { "title": "AutoTrader Car Listings Scraper", "description": "Pull the newest AutoTrader.com car listings by make, model, ZIP and radius: price, mileage, VIN, dealer, photos and days listed. Export CSV or JSON.", "version": "1.0", "x-build-id": "rECRC6RegwmpubPSa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~autotrader-car-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-autotrader-car-listings-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/sian.agency~autotrader-car-listings-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-autotrader-car-listings-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/sian.agency~autotrader-car-listings-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-autotrader-car-listings-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": { "operation": { "title": "🎯 What do you want to scrape?", "enum": [ "search" ], "type": "string", "description": "Search AutoTrader.com car listings by make, model and location. Results always come back newest first, so a scheduled run picks up fresh listings quickly.", "default": "search" }, "make": { "title": "🏷️ Make", "type": "string", "description": "Car brand as AutoTrader spells it, for example Porsche, Lexus, Toyota, Land Rover or Mercedes-Benz. Leave empty to search every make.", "default": "" }, "model": { "title": "🚘 Model", "type": "string", "description": "Optional model name, for example 911, LS 400, Land Cruiser or 4Runner. Leave empty to get every model of the make. If AutoTrader does not recognise the model, the run stops before any listing is charged and lists the models it does know.", "default": "" }, "condition": { "title": "✨ Condition", "enum": [ "used", "new", "certified" ], "type": "string", "description": "Which listings to include. Used covers certified pre-owned cars too.", "default": "used" }, "zip": { "title": "📍 ZIP code", "pattern": "^[0-9]{5}$", "type": "string", "description": "US ZIP code the search radius is measured from. The example is downtown Los Angeles.", "default": "90012" }, "searchRadius": { "title": "📏 Search radius", "enum": [ "10", "25", "50", "75", "100", "200", "300", "400", "500", "0" ], "type": "string", "description": "How far from the ZIP code to search. Pick Nationwide to search the whole country.", "default": "500" }, "sellerType": { "title": "🤝 Seller type", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Limit results to dealer stock or to cars sold by their owners.", "default": "any" }, "startYear": { "title": "📅 Oldest model year", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Only cars from this model year or newer. Leave empty for no lower limit." }, "endYear": { "title": "📅 Newest model year", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Only cars from this model year or older. Useful for vintage searches, for example 1990 to 2005." }, "minPrice": { "title": "💵 Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Only cars priced at or above this amount." }, "maxPrice": { "title": "💰 Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Only cars priced at or below this amount. Listings with no price shown are left out by AutoTrader when you set a price range." }, "maxMileage": { "title": "🛣️ Maximum mileage", "minimum": 0, "type": "integer", "description": "Only cars with this many miles or fewer, for example 30000 for low-mileage stock." }, "maxDaysListed": { "title": "🆕 Listed within (days)", "minimum": 0, "maximum": 365, "type": "integer", "description": "Only keep listings that have been on AutoTrader for this many days or fewer. 0 means listed today. Leave empty to keep everything. Handy for a scheduled run that only wants fresh stock." }, "maxResults": { "title": "🔢 Maximum listings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many listings. Results arrive 100 at a time, newest first. Free accounts are capped at 25 listings per run.", "default": 100 } } }, "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 } } } } } } } } } }