{ "openapi": "3.0.1", "info": { "title": "CarDekho Used Cars Scraper: Prices, KMs, Fuel and Dealer Data", "description": "Scrape used car listings from CarDekho.com, India's biggest car marketplace. Filter by city, brand, budget, fuel type, and body type. Extract exact prices in INR, kilometers driven, transmission, owner count, dealer details, and certification badges in 30+ flat columns. No login required.", "version": "0.1", "x-build-id": "ffNejWXi4fa58v42T" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~cardekho-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-cardekho-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~cardekho-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-cardekho-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~cardekho-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-cardekho-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct CarDekho URLs to scrape. Can be search pages (e.g., /usedCars, /used-cars+in+mumbai, /used-maruti+cars+in+india) or detail pages. Leave empty to use the filter fields below.", "default": [ { "url": "https://www.cardekho.com/usedCars" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "city": { "title": "City", "enum": [ "all", "mumbai", "delhi-ncr", "bangalore", "chennai", "pune", "hyderabad", "ahmedabad", "kolkata", "jaipur", "gurgaon", "noida", "new-delhi" ], "type": "string", "description": "Filter listings by Indian city. Combined with brand/body filters when supplied.", "default": "all" }, "brand": { "title": "Brand Slug", "type": "string", "description": "Brand slug as it appears in the CarDekho URL (e.g., 'maruti', 'honda', 'tata', 'hyundai'). Leave empty for all brands.", "default": "" }, "bodyType": { "title": "Body Type", "enum": [ "", "suv", "hatchback", "sedan", "muv", "minivan", "pickup-truck", "coupe", "convertible", "wagon", "hybrid" ], "type": "string", "description": "Filter by body style. URL slug form (e.g., 'suv', 'hatchback', 'sedan').", "default": "" }, "fuelType": { "title": "Fuel Type", "enum": [ "", "petrol", "diesel", "cng", "electric", "lpg", "hybrid" ], "type": "string", "description": "Filter by fuel type.", "default": "" }, "transmission": { "title": "Transmission", "enum": [ "", "automatic", "manual" ], "type": "string", "description": "Filter by transmission.", "default": "" }, "minBudgetLakh": { "title": "Min Budget (Lakh INR)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Minimum price in lakh INR (1 Lakh = 100,000 INR = ₹1L). 0 = no minimum.", "default": 0 }, "maxBudgetLakh": { "title": "Max Budget (Lakh INR)", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum price in lakh INR. 0 = no maximum.", "default": 0 }, "minYear": { "title": "Min Year", "minimum": 0, "maximum": 2030, "type": "integer", "description": "Minimum manufacturing year.", "default": 0 }, "maxYear": { "title": "Max Year", "minimum": 0, "maximum": 2030, "type": "integer", "description": "Maximum manufacturing year.", "default": 0 }, "maxKm": { "title": "Max Kilometers Driven", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Maximum kilometers on the odometer. 0 = no limit.", "default": 0 }, "includeDetails": { "title": "Include Detail Pages", "type": "boolean", "description": "Fetch full detail pages for each listing to get full specs, features, EMI, gallery images, and dealer info. Slower but richer output (10x more requests).", "default": false }, "maxItems": { "title": "Max Items", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of listings to scrape. 0 = unlimited.", "default": 100 }, "maxPages": { "title": "Max Pages", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum number of search result pages to fetch per start URL. 0 = unlimited.", "default": 10 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum number of pages processed simultaneously.", "default": 5 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for enhanced reliability. Datacenter proxies are usually sufficient for CarDekho (no anti-bot observed).", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }