{ "openapi": "3.0.1", "info": { "title": "iSeeCars Scraper", "description": "Scrape iSeeCars.com with 4M+ used and new car listings with price analysis. Extract title, price, VIN, mileage, condition, colors, engine, MPG, transmission, drivetrain, features, dealer info, price rating (Great/Good/Fair Deal), and savings vs market value.", "version": "1.0", "x-build-id": "XmeZkIEbCa9xqYTpU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~iseecars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-iseecars-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/crawlerbros~iseecars-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-iseecars-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/crawlerbros~iseecars-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-iseecars-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "goodDeals", "byUrl" ], "type": "string", "description": "What to scrape. 'search' finds listings by make/model. 'goodDeals' finds cars priced below market value. 'byUrl' scrapes a specific iSeeCars search URL.", "default": "search" }, "make": { "title": "Make", "enum": [ "", "Acura", "Alfa Romeo", "Aston Martin", "Audi", "BMW", "Bentley", "Buick", "Cadillac", "Chevrolet", "Chrysler", "Dodge", "Ferrari", "Fiat", "Ford", "GMC", "Genesis", "Honda", "Hyundai", "Infiniti", "Jaguar", "Jeep", "Kia", "Lamborghini", "Land Rover", "Lexus", "Lincoln", "Lucid", "MINI", "Maserati", "Mazda", "McLaren", "Mercedes-Benz", "Mitsubishi", "Nissan", "Polestar", "Porsche", "Ram", "Rivian", "Rolls-Royce", "Subaru", "Tesla", "Toyota", "VinFast", "Volkswagen", "Volvo" ], "type": "string", "description": "Car manufacturer (mode=search). Leave blank for all makes.", "default": "Toyota" }, "model": { "title": "Model", "type": "string", "description": "Car model name (mode=search). e.g. Camry, F-150, Civic. Leave blank for all models of the selected make.", "default": "Camry" }, "condition": { "title": "Condition", "enum": [ "", "used", "new", "certified" ], "type": "string", "description": "Filter by listing condition.", "default": "" }, "dealTier": { "title": "Deal tier", "enum": [ "", "GREAT", "GOOD", "FAIR" ], "type": "string", "description": "Filter by iSeeCars price rating. 'goodDeals' mode always sets this to GREAT.", "default": "" }, "yearMin": { "title": "Year (min)", "minimum": 1980, "maximum": 2030, "type": "integer", "description": "Minimum model year." }, "yearMax": { "title": "Year (max)", "minimum": 1980, "maximum": 2030, "type": "integer", "description": "Maximum model year." }, "priceMin": { "title": "Price min ($)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Minimum listing price in USD." }, "priceMax": { "title": "Price max ($)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Maximum listing price in USD." }, "mileageMax": { "title": "Mileage max", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Maximum odometer reading in miles." }, "transmission": { "title": "Transmission", "enum": [ "", "AUTOMATIC", "MANUAL", "CVT" ], "type": "string", "description": "Filter by transmission type.", "default": "" }, "fuelType": { "title": "Fuel type", "enum": [ "", "GASOLONE", "ELECTRIC", "HYBRID", "PLUGIN_HYBRID", "DIESEL", "FLEX" ], "type": "string", "description": "Filter by fuel type.", "default": "" }, "driveType": { "title": "Drive type", "enum": [ "", "AWD", "FWD", "RWD" ], "type": "string", "description": "Filter by drivetrain.", "default": "" }, "zip": { "title": "Starting ZIP code", "type": "string", "description": "US ZIP code to start search from. The scraper will use multiple regional ZIP codes to gather more results." }, "listingUrl": { "title": "iSeeCars URL (mode=byUrl)", "type": "string", "description": "Full iSeeCars search URL to scrape (mode=byUrl). e.g. https://www.iseecars.com/cars-for-sale?Make=Toyota&Model=Camry" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of listings to return.", "default": 50 } } }, "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 } } } } } } } } } }