{ "openapi": "3.0.1", "info": { "title": "Cars24 Cars Scraper: India Used Car Listings", "description": "Extract used-car listings from Cars24.com with real price, year, and mileage filters, make/model, city, and photo galleries. JSON or CSV rows ready for Sheets, Make, and Zapier.", "version": "0.1", "x-build-id": "20W3so6awLWzSjv0h" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~cars24-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-cars24-cars-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/getascraper~cars24-cars-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-cars24-cars-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/getascraper~cars24-cars-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-cars24-cars-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": { "city": { "title": "City", "enum": [ "all-india", "bangalore", "new-delhi", "delhi-ncr", "mumbai", "hyderabad", "pune", "ahmedabad", "chennai", "gurgaon", "noida", "lucknow", "kolkata", "jaipur", "surat", "chandigarh", "kochi", "nashik", "bhopal", "visakhapatnam", "nagpur", "coimbatore", "indore", "patna", "ludhiana", "rajkot", "vadodara", "agra", "faridabad" ], "type": "string", "description": "Indian city to search. Choose \"All India\" to search Cars24's full national listing page instead of one city.", "default": "all-india" }, "make": { "title": "Make (optional)", "type": "string", "description": "Car brand, e.g. \"maruti\", \"hyundai\", \"honda\". Matches Cars24's own make filter. Leave blank to search all makes.", "default": "" }, "model": { "title": "Model (optional)", "type": "string", "description": "Car model, e.g. \"swift\", \"i20\", \"creta\". Only used together with Make. Leave blank to search all models of the chosen make.", "default": "" }, "minPrice": { "title": "Minimum Price (INR)", "minimum": 0, "type": "integer", "description": "Minimum asking price in Indian Rupees. Matches Cars24's own Budget filter.", "default": 0 }, "maxPrice": { "title": "Maximum Price (INR)", "minimum": 0, "type": "integer", "description": "Maximum asking price in Indian Rupees.", "default": 2000000 }, "minYear": { "title": "Minimum Model Year", "minimum": 1990, "maximum": 2100, "type": "integer", "description": "Earliest model year. Matches Cars24's own Model Year filter.", "default": 2010 }, "maxYear": { "title": "Maximum Model Year", "minimum": 1990, "maximum": 2100, "type": "integer", "description": "Latest model year.", "default": 2026 }, "maxOdometerKm": { "title": "Maximum Kilometers Driven", "minimum": 0, "type": "integer", "description": "Maximum odometer reading in kilometers. Matches Cars24's own Kms Driven filter. Leave blank to skip this filter." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Cars24 has not been observed challenging requests during testing, so Apify Proxy is optional. Add one if you scrape at high volume or see empty results.", "default": { "useApifyProxy": false } }, "maxItems": { "title": "Maximum Listings", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of unique car listings to return. Cars24's own search page always returns a fixed set of results per search (no working pagination control), so this Actor automatically splits your price range into Cars24's own real budget bands and runs one search per band until this limit is reached.", "default": 40 } } }, "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 } } } } } } } } } }