{ "openapi": "3.0.1", "info": { "title": "Autotrader USA Scraper", "description": "Scrape Autotrader.com car listings: price, mileage, VIN, specs, photos and dealer contacts. Search by make, model, state or URL. From $1.50 per 1,000.", "version": "0.0", "x-build-id": "eJrCnFDSC70jDxYEc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cocoa_kit~autotrader-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cocoa_kit-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/cocoa_kit~autotrader-scraper/runs": { "post": { "operationId": "runs-sync-cocoa_kit-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/cocoa_kit~autotrader-scraper/run-sync": { "post": { "operationId": "run-sync-cocoa_kit-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": { "searchKeywords": { "title": "Search keywords", "type": "array", "description": "What to search for, one search per line. Makes, models and years are recognized and turned into exact filters (\"Toyota Camry\", \"2021 Ford F-150\"); anything else is used as a free-text search (\"electric SUV\"). Leave empty to search all vehicles.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Autotrader search-result URLs (all filters in the URL are kept) or single vehicle URLs. Use this when you need a filter that has no field below: set it up on autotrader.com and paste the URL.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "locationScope": { "title": "Location", "enum": [ "nationwide", "state" ], "type": "string", "description": "Search the whole United States or only one state. Applies to keyword searches; start URLs keep the location they contain.", "default": "nationwide" }, "state": { "title": "State", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY" ], "type": "string", "description": "Used when Location is \"Specific state\". Only listings whose seller is located in this state are saved." }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of listings to save in total. Set to 0 for no limit.", "default": 25 }, "maxItemsPerSearch": { "title": "Max items per search", "minimum": 0, "type": "integer", "description": "Maximum number of listings to save for each keyword or start URL. Set to 0 for no limit.", "default": 0 }, "condition": { "title": "Condition", "enum": [ "any", "new", "used", "certified" ], "type": "string", "description": "New, used or manufacturer-certified vehicles.", "default": "any" }, "sellerType": { "title": "Seller type", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Listings from dealers, private sellers, or both.", "default": "any" }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "type": "integer", "description": "Lowest price to include. Set to 0 for no minimum." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "type": "integer", "description": "Highest price to include. Set to 0 for no maximum." }, "minYear": { "title": "Min year", "minimum": 0, "type": "integer", "description": "Oldest model year to include. Set to 0 for no minimum." }, "maxYear": { "title": "Max year", "minimum": 0, "type": "integer", "description": "Newest model year to include. Set to 0 for no maximum." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "newest", "priceLowest", "priceHighest", "mileageLowest", "mileageHighest", "yearNewest", "yearOldest" ], "type": "string", "description": "Order in which Autotrader returns listings. State searches sorted by relevance are fetched closest-to-state-center first.", "default": "relevance" }, "maxListingAgeDays": { "title": "Max listing age (days)", "minimum": 0, "type": "integer", "description": "Save only listings that have been on Autotrader for at most this many days. Set to 0 for no age limit." }, "scrapeItemDetails": { "title": "Scrape vehicle pages", "type": "boolean", "description": "Open every vehicle page to add the full seller description and the feature lists. Search results already include price, mileage, VIN, specs, photos and seller, so turn this on only when you need those extras. Vehicle pages are charged separately.", "default": false }, "skipSeenListings": { "title": "Skip listings saved by earlier runs", "type": "boolean", "description": "Remember saved listing IDs in a named key-value store and skip them in later runs. Combine with Sort by \"Newest listings\" on a schedule to get only new listings each run.", "default": false }, "seenListingsStoreName": { "title": "Seen-listings store name", "type": "string", "description": "Name of the key-value store that remembers listing IDs for 30 days. Use different names to track different searches separately.", "default": "autotrader-seen-listings" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "US residential proxies are preselected and required for reliable results. Proxy usage is included in the price.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of requests running in parallel.", "default": 8 }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many times a blocked or failed request is retried with a different IP before giving up.", "default": 8 } } }, "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 } } } } } } } } } }