{ "openapi": "3.0.1", "info": { "title": "Car Dealer Website Inventory Scraper: VIN, Price & Stock", "description": "Scrape live vehicle inventory from any car dealership's own website, not a marketplace. Paste a dealer homepage and get every car at VIN level with price, mileage and trim. Auto-detects DealerOn, Dealer.com, Dealer Inspire and more. Tracks price drops and sold units.", "version": "0.1", "x-build-id": "xDdxLLjcaiVQXVym3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fayoussef~dealer-inventory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fayoussef-dealer-inventory-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/fayoussef~dealer-inventory-scraper/runs": { "post": { "operationId": "runs-sync-fayoussef-dealer-inventory-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/fayoussef~dealer-inventory-scraper/run-sync": { "post": { "operationId": "run-sync-fayoussef-dealer-inventory-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", "required": [ "dealerUrls" ], "properties": { "dealerUrls": { "title": "Dealer websites", "type": "array", "description": "The dealership websites to read, one per line. Paste the homepage (https://www.examplemotors.com) and the inventory page is found automatically, or paste an inventory URL directly to scrape exactly that search. Works with DealerOn, Dealer.com, Dealer Inspire, DealerFire, Sincro, Dealer eProcess, Fox Dealer and most other dealer website platforms.", "items": { "type": "string" } }, "condition": { "title": "Which vehicles", "enum": [ "all", "used", "new", "certified" ], "type": "string", "description": "Limit the scrape to one part of the lot. \"Everything\" tries the all-inventory page first and falls back to used, new and certified in turn.", "default": "all" }, "maxVehiclesPerDealer": { "title": "Maximum vehicles per dealer", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many vehicles from each dealer. A typical franchise dealer lists 100 to 400 vehicles.", "default": 200 }, "fetchDetails": { "title": "Fetch full detail pages", "type": "boolean", "description": "Open each vehicle's own page to fill in anything the listing page left out, such as mileage, engine, transmission and the full description. Only vehicles that are actually missing something are fetched, so dealers whose listing pages already carry full data cost nothing extra.", "default": false }, "trackChanges": { "title": "Track changes between runs", "type": "boolean", "description": "Compare this run against the previous one and label every vehicle new, price_drop, price_increase, unchanged or removed. Turn this on and schedule the Actor to watch a competitor's lot. The first run is the baseline, so everything reads as new and no change is charged for.", "default": false }, "monitorKey": { "title": "Watchlist name", "type": "string", "description": "Names the history that change tracking compares against. Keep it the same across runs to keep watching the same dealers, or use a different name to track a second, separate watchlist on the same account.", "default": "dealer-inventory" }, "maxPagesPerDealer": { "title": "Maximum listing pages per dealer", "minimum": 1, "maximum": 60, "type": "integer", "description": "Safety cap on how deep to page through each dealer's search results. Paging stops early on its own as soon as a page returns no new vehicles.", "default": 20 }, "concurrency": { "title": "Dealers in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many dealer websites to read at the same time. Raise it for long lists; lower it if sites start refusing requests.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Defaults to Apify Proxy residential with a US exit, which is what these US sites require: a non-US address is refused with HTTP 403. Change it only if you know you need a different proxy or country.", "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 } } } } } } } } } }