{ "openapi": "3.0.1", "info": { "title": "CarsDB Myanmar Used & New Car Listings Scraper", "description": "Scrape used and brand-new car listings from CarsDB.com — Myanmar's largest car marketplace. Get price, mileage, make/model, plate division, steering position, dealer contacts, images, and full descriptions across 18,000+ listings.", "version": "0.1", "x-build-id": "fwMSpuZLjBg4u7kYi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~carsdb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-carsdb-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/parseforge~carsdb-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-carsdb-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/parseforge~carsdb-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-carsdb-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional list of CarsDB URLs to scrape directly. Accepts either listing-detail URLs (https://www.carsdb.com/en/car-listings/2008-chevrolet-mw-786676) or filtered search URLs (https://www.carsdb.com/en/car-listings/search/Toyota?models=Wish). When set, the filters below are ignored.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "query": { "title": "Free-text Search", "type": "string", "description": "Optional free-text query (e.g. \"hilux\", \"prius\", \"e-class\"). Searched across title, make, model, trim, and lot number." }, "manufacturers": { "title": "Make / Manufacturer", "uniqueItems": true, "type": "array", "description": "Pick one or more car manufacturers. Empty matches all.", "items": { "type": "string", "enum": [ "AIQAR", "AIQAR EQ7", "AVATR", "Abarth", "Acura", "Aptera", "Audi", "BAIC", "BMW", "BYD", "Beijing", "Bentley", "Bestune", "Borgward", "Brilliance", "Bugatti", "C&C", "Cadillac", "Chana", "Changan", "Changhe", "Chery", "Chevrolet", "Chrysler", "Citroën", "DFSK", "Daewoo", "Daihatsu", "Dayun", "Dongfeng", "Dsfk Fengon", "FAW", "FAW BESTUNE", "FIAT", "Ferrari", "Ford", "Forland", "Foton", "GAC", "GMC", "Geely", "General Motors", "HUMMER", "Haima", "Haval", "Higer", "Hino", "Holden", "Honda", "Hongqi", "Hyundai", "Infiniti", "International", "Isuzu", "JAC", "JM", "JMC", "JMEV", "Jaguar", "Jeep", "Jetour", "Jinbei", "KEYTON", "KUBOTA", "KYC", "Kaiyi", "Karry", "Kia", "King Long", "Lamborghini", "Land Rover", "Leapmotor", "Lexus", "Lifan", "Lincoln", "MG", "MINI", "Maserati", "Maxus", "Mazda", "Mercedes-Benz", "Mitsubishi", "Morris", "Naza", "Neta", "Nissan", "Nissan Diesel (UD Trucks)", "Other", "Peugeot", "Porsche", "Ram", "Rammar", "Renault", "Rolls-Royce", "SINOTRUK", "SWM", "Sang Da", "Shineray", "Skyworth", "Smart", "Sokon", "Soueast", "Spyker", "Ssangyong", "Subaru", "Suzuki", "TATA", "Toyota", "VGV", "Vauxhall", "Volkswagen", "Volvo", "Wuling", "Zeeker" ] } }, "modelQuery": { "title": "Model name", "type": "string", "description": "Restrict to a specific model name (case-insensitive substring match). Use together with Make for best precision. Example: \"Wish\", \"Hilux Surf\", \"CR-V\"." }, "states": { "title": "State / Division", "uniqueItems": true, "type": "array", "description": "Pick one or more Myanmar states or divisions where the car is located.", "items": { "type": "string", "enum": [ "Ayeyarwady Division", "Bago Division", "Chin State", "Kachin State", "Kayin State", "Magway Division", "Mandalay Division", "Mon State", "Nay Pyi Taw", "Rakhine State", "Sagaing Division", "Shan State", "Tanintharyi Division", "Yangon Division" ] } }, "buildTypes": { "title": "Build Type", "uniqueItems": true, "type": "array", "description": "Body type filter.", "items": { "type": "string", "enum": [ "City Bus", "Express Bus", "Hatchback", "Heavy Truck", "Industrial Vehicle", "Light Truck", "MPV (Minivan)", "Medium Truck", "Mini Bus", "Mini Truck", "Others", "Pick up Truck", "SUV", "Sedan", "Sports", "Stationwagon", "Tractor Unit", "Truck" ] } }, "fuelTypes": { "title": "Fuel Type", "uniqueItems": true, "type": "array", "description": "Fuel filter.", "items": { "type": "string", "enum": [ "CNG", "Diesel", "Electric", "Petrol" ] } }, "transmissions": { "title": "Transmission", "uniqueItems": true, "type": "array", "description": "Gearbox type filter.", "items": { "type": "string", "enum": [ "Auto", "Manual", "Semi-Auto" ] } }, "colors": { "title": "Color", "uniqueItems": true, "type": "array", "description": "Exterior color filter.", "items": { "type": "string", "enum": [ "Aqua", "Beige", "Black", "Blue", "Brown", "Dark Blue", "Dual Tone (Grey & Black)", "Gray", "Green", "Light Blue", "Light Brown", "Orange", "Other", "Pearl Gold", "Pearl White", "Pink", "Purple", "Red", "Silver", "Slate Blue", "White", "Wine", "Yellow", "Yellow Gold", "Yellow/gold" ] } }, "condition": { "title": "Condition", "enum": [ "", "Used Car", "Brand New Car" ], "type": "string", "description": "Filter by listing condition.", "default": "" }, "steeringPosition": { "title": "Steering Position", "enum": [ "", "Right Hand Drive", "Left Hand Drive" ], "type": "string", "description": "Cars from Myanmar are predominantly Right Hand Drive, but a portion of imports are Left Hand Drive.", "default": "" }, "sellerTypes": { "title": "Seller Type", "uniqueItems": true, "type": "array", "description": "Filter by seller account type (Dealer / Private seller / Showroom / Buyer-looking).", "items": { "type": "string", "enum": [ "Buyer", "Dealer", "Private seller", "Showroom" ] } }, "licenceStatus": { "title": "Licence Status", "uniqueItems": true, "type": "array", "description": "Vehicle licence status (Myanmar-specific). \"CIF Only\" = freshly imported / not yet plated.", "items": { "type": "string", "enum": [ "CIF Only", "No Slip", "With Licence" ] } }, "yearFrom": { "title": "Year From", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Minimum model year (inclusive)." }, "yearTo": { "title": "Year To", "minimum": 1900, "maximum": 2030, "type": "integer", "description": "Maximum model year (inclusive)." }, "priceLakhFrom": { "title": "Price From (Lakh MMK)", "minimum": 0, "type": "integer", "description": "Minimum asking price in Lakh (100,000 MMK). E.g. 100 = 10,000,000 MMK ~= US$4,800." }, "priceLakhTo": { "title": "Price To (Lakh MMK)", "minimum": 0, "type": "integer", "description": "Maximum asking price in Lakh (100,000 MMK)." }, "sortBy": { "title": "Sort By", "enum": [ "dateNewest", "dateOldest", "priceLowest", "priceHighest", "yearNewest", "yearOldest", "mileageLowest", "mileageHighest" ], "type": "string", "description": "Listing order before pagination.", "default": "dateNewest" }, "includeDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "When enabled, the actor fetches each listing's detail page to enrich the record with full description, view count, owner count, and the entire image gallery. Slower but richer. When disabled, only the Algolia listing-card data is returned (16+ fields, no description / no image gallery).", "default": true }, "locale": { "title": "Language", "enum": [ "en", "my" ], "type": "string", "description": "Language for detail-page enrichment text (description, headings). Listing-card data is identical across locales.", "default": "en" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy settings. Default Apify datacenter proxy is sufficient - CarsDB does not block scrapers and the Algolia search backend has no IP rate limit." } } }, "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 } } } } } } } } } }