# CarsDB Myanmar Used & New Car Listings Scraper (`parseforge/carsdb-scraper`) Actor

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.

- **URL**: https://apify.com/parseforge/carsdb-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $19.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🚗 CarsDB Myanmar Used & New Car Listings Scraper

> 🚀 **Pull every used and brand-new car listed on carsdb.com in seconds.** Filter by make, body type, plate division, steering position, or price. No API key, no registration, no manual CSV wrangling.

> 🕒 **Last updated:** 2026-05-21 · **📊 41 fields** per record · **18,900+ live listings** · **114 manufacturers covered** · **MMK and Lakh pricing with full image gallery**

CarsDB is the largest car marketplace in Myanmar, covering used cars, brand-new imports, dealer inventory, and private listings across all 14 states and divisions. The Myanmar market is one of the few left in Asia where **right-hand-drive Japanese imports** still dominate, so the catalog skews heavily toward Toyota, Honda, Suzuki, and Nissan with model years stretching from 1990s classics to 2026 EVs. Manually copying that catalog into a spreadsheet is hours of work and goes stale within a day. This Actor sits in front of the storefront, paginates through any filter you point it at, and returns clean structured records covering **make, model, year, mileage, plate division, license status, steering position, engine displacement, fuel type, body type, color, owner count, full description, seller contact, and the entire image gallery**.

You feed in optional filters (manufacturer, state, build type, year range, price range in Lakh), pick a sort order, and set a `maxItems` cap. The Actor talks directly to the Algolia search index that powers carsdb.com, so listing pagination is fast and rate-limit-free. Each detail page is optionally fetched in a second pass to enrich the record with description text, view count, owner count, and the full image gallery. Free runs preview **10 items** so you can verify the shape before scaling up. Paid runs go up to **1,000,000** items. Schedule it daily to track Yangon dealer inventory, run it on demand for an ASEAN sourcing snapshot, or wire it into your auto-export, parts-fitment, or cross-border arbitrage tool. Every record reflects the storefront at the moment of execution.

| 🎯 Target audience | 💡 Primary use cases |
|---|---|
| 🚚 Auto export and import companies sourcing right-hand-drive units | Find Japanese-spec used cars for re-export to neighboring RHD markets |
| 🌏 International car dealers monitoring ASEAN inventory | Track price benchmarks for popular trims in Yangon and Mandalay |
| 📊 Market researchers and consultancies covering frontier markets | Build demand and pricing models for Southeast Asian auto trade |
| 🏦 Auto-finance and insurance underwriters in Myanmar | Reference live market prices when valuing collateral or claims |

---

### 📋 What the CarsDB Scraper does

- 🚙 **Full make and model catalog.** 114 manufacturers from Toyota and Honda down to niche Chinese EV brands like Bestune, Hongqi, and JMEV. Every listing brings make, model, trim, year, and the CarsDB internal IDs.
- 💴 **MMK and Lakh pricing.** Prices are returned in both Myanmar Kyat (`priceMmk`) and the local convention of Lakh (`priceLakh`, 100,000 MMK). Listings where the seller asks buyers to call land as zero rather than fabricated values.
- 🇲🇲 **Myanmar-specific fields.** Plate division (YGN, MDY, NPT), plate color (black, red, white), license status (With Licence, No Slip, CIF Only), and steering position are first-class fields. Township and state come from the seller location.
- 🖼️ **Full image gallery.** When detail fetching is enabled, every image URL from the photo gallery is captured, not just the cover thumbnail.
- 📞 **Seller contact and type.** Dealer name, phone number, seller type (Dealer, Private seller, Showroom, Buyer), and verified flag come straight from the listing.

Each record bundles imageUrl, title, url, lotNumber, condition, manufacturer, model, trim, year, priceMmk, priceLakh, priceCurrency, mileageKm, mileageRange, transmission, fuelType, buildType, color, enginePowerCc, steeringPosition, licenceStatus, plateDivision, plateColor, plateNumber, numberOfOwners, exchangeable, township, state, country, sellerName, sellerType, sellerContact, sellerVerified, sellerAvatar, imageCount, imageUrls, description, viewsCount, postedAt, updatedAt, and a scrapedAt timestamp. The dataset is downloadable in CSV, Excel, JSON, JSONL, RSS, HTML, and XML formats.

> 💡 **Why it matters:** Myanmar imposes some of the strictest used-car import rules in the world (year caps, engine-size caps, plate quotas) and pricing reflects the resulting scarcity. A dataset you can refresh on a schedule lets you spot price swings, dealer turnover, and licensing-status shifts within hours, not at the end of the quarter when your spreadsheet is already stale.

---

### 🎬 Full Demo

🚧 Coming soon: a 3-minute walkthrough showing input setup, a live run, and how to wire the dataset into a downstream tool. The Actor is fully operational while the video is in production.

---

### ⚙️ Input

<table>
  <tr>
    <th>Field</th>
    <th>Type</th>
    <th>Required</th>
    <th>Description</th>
  </tr>
  <tr>
    <td><code>startUrls</code></td>
    <td>array of URLs</td>
    <td>no</td>
    <td>Optional CarsDB URLs to scrape directly. Accepts either detail URLs (<code>https://www.carsdb.com/en/car-listings/2008-chevrolet-mw-786676</code>) or filtered search URLs (<code>https://www.carsdb.com/en/car-listings/search/Toyota?models=Wish</code>). When set, the filters below are ignored.</td>
  </tr>
  <tr>
    <td><code>maxItems</code></td>
    <td>integer</td>
    <td>no</td>
    <td>Cap on the number of listings to push. Free plan caps at 10. Paid plans can go up to 1,000,000.</td>
  </tr>
  <tr>
    <td><code>query</code></td>
    <td>string</td>
    <td>no</td>
    <td>Free-text search across title, make, model, trim, and lot number. Example: <code>hilux surf</code>, <code>e-class</code>.</td>
  </tr>
  <tr>
    <td><code>manufacturers</code></td>
    <td>array (enum)</td>
    <td>no</td>
    <td>Pick one or more car makes from the full 114-entry list. Empty matches every brand.</td>
  </tr>
  <tr>
    <td><code>modelQuery</code></td>
    <td>string</td>
    <td>no</td>
    <td>Restrict to a specific model name. Use together with <code>manufacturers</code> for tightest matches.</td>
  </tr>
  <tr>
    <td><code>states</code></td>
    <td>array (enum)</td>
    <td>no</td>
    <td>Filter by Myanmar state or division: Yangon, Mandalay, Nay Pyi Taw, Bago, plus the 11 others.</td>
  </tr>
  <tr>
    <td><code>buildTypes</code></td>
    <td>array (enum)</td>
    <td>no</td>
    <td>Body type filter: Sedan, SUV, Hatchback, Pick up Truck, Stationwagon, MPV (Minivan), plus 12 commercial-vehicle types.</td>
  </tr>
  <tr>
    <td><code>fuelTypes</code></td>
    <td>array (enum)</td>
    <td>no</td>
    <td>Petrol, Diesel, Electric, or CNG.</td>
  </tr>
  <tr>
    <td><code>transmissions</code></td>
    <td>array (enum)</td>
    <td>no</td>
    <td>Auto, Manual, or Semi-Auto.</td>
  </tr>
  <tr>
    <td><code>colors</code></td>
    <td>array (enum)</td>
    <td>no</td>
    <td>25 exterior colors including dual-tone and Myanmar-specific variants like Pearl White and Slate Blue.</td>
  </tr>
  <tr>
    <td><code>condition</code></td>
    <td>string (enum)</td>
    <td>no</td>
    <td>Used Car or Brand New Car. Empty matches both.</td>
  </tr>
  <tr>
    <td><code>steeringPosition</code></td>
    <td>string (enum)</td>
    <td>no</td>
    <td>Right Hand Drive (most stock) or Left Hand Drive (rare imports).</td>
  </tr>
  <tr>
    <td><code>sellerTypes</code></td>
    <td>array (enum)</td>
    <td>no</td>
    <td>Filter by Dealer, Private seller, Showroom, or Buyer-looking.</td>
  </tr>
  <tr>
    <td><code>licenceStatus</code></td>
    <td>array (enum)</td>
    <td>no</td>
    <td>With Licence, No Slip, or CIF Only (freshly imported, not yet plated). Myanmar-specific.</td>
  </tr>
  <tr>
    <td><code>yearFrom</code> / <code>yearTo</code></td>
    <td>integer</td>
    <td>no</td>
    <td>Inclusive model-year range.</td>
  </tr>
  <tr>
    <td><code>priceLakhFrom</code> / <code>priceLakhTo</code></td>
    <td>integer</td>
    <td>no</td>
    <td>Price range in Lakh MMK (1 Lakh = 100,000 MMK). 100 Lakh equals roughly USD 4,800 at the current grey-market rate.</td>
  </tr>
  <tr>
    <td><code>sortBy</code></td>
    <td>string (enum)</td>
    <td>no</td>
    <td>Sort order: date posted, price, year, or mileage. Pick newest-first by default.</td>
  </tr>
  <tr>
    <td><code>includeDetails</code></td>
    <td>boolean</td>
    <td>no</td>
    <td>When true (default), the Actor fetches each listing detail page to enrich the record with description, view count, owner count, and the full image gallery. Disable to skip those 4 fields and run roughly 5x faster.</td>
  </tr>
  <tr>
    <td><code>locale</code></td>
    <td>string (enum)</td>
    <td>no</td>
    <td>Language for detail-page enrichment text (<code>en</code> or <code>my</code> for Burmese). Listing-card data is identical across locales.</td>
  </tr>
  <tr>
    <td><code>proxyConfiguration</code></td>
    <td>object</td>
    <td>no</td>
    <td>Defaults to Apify proxy. CarsDB does not block scrapers and the Algolia backend has no IP rate limit, so the default works in nearly every case.</td>
  </tr>
</table>

Example: scrape the 50 newest Toyota listings in Yangon, with full details.

```json
{
  "manufacturers": ["Toyota"],
  "states": ["Yangon Division"],
  "sortBy": "dateNewest",
  "maxItems": 50,
  "includeDetails": true
}
````

Example: cheapest SUVs under 200 Lakh MMK with a clean license, free preview run.

```json
{
  "buildTypes": ["SUV"],
  "priceLakhTo": 200,
  "licenceStatus": ["With Licence"],
  "sortBy": "priceLowest",
  "maxItems": 10
}
```

> ⚠️ **Good to Know:** CarsDB lists prices in Lakh (1 Lakh = 100,000 MMK). When a seller posts "price on request" the listing carries `priceLakh: 0` rather than a fabricated value, so always check before sorting by price. Detail-page fetching runs in series at the start to be polite to the storefront. If a detail page fails the record is still pushed with the Algolia card data intact.

***

### 📊 Output

Every record is a flat JSON object with 41 fields. Download the dataset as JSON, JSONL, CSV, Excel, HTML, XML, or RSS.

#### 🧾 Schema

| Field | Type | Example |
|---|---|---|
| 🖼️ `imageUrl` | string | `https://www.imhcdb.com/rails/active_storage/representations/redirect/.../n.jpg` |
| 📝 `title` | string | `Toyota Mark II 1998` |
| 🔗 `url` | string | `https://www.carsdb.com/en/car-listings/1998-toyota-mark-ii-786672` |
| 🔢 `lotNumber` | string | `786672` |
| 🆔 `listingId` | string | `786672` |
| 🏷️ `condition` | string | `Used Car` |
| 🏭 `manufacturer` | string | `Toyota` |
| 🔖 `manufacturerId` | integer | `102` |
| 🚙 `model` | string | `Mark II` |
| 🆔 `modelId` | integer | `1066` |
| 🎯 `trim` | string | null | `Autobiography` (often blank for sub-USD 30k listings) |
| 📅 `year` | integer | `1998` |
| 💴 `priceMmk` | integer | `55000000` (0 = price on request) |
| 💰 `priceLakh` | integer | `550` |
| 💱 `priceCurrency` | string | `MMK` |
| 🛣️ `mileageKm` | integer | `172500` |
| 📏 `mileageRange` | string | `170 - 175k Km` |
| ⚙️ `transmission` | string | `Auto` |
| ⛽ `fuelType` | string | `Petrol` |
| 🚗 `buildType` | string | `Sedan` |
| 🎨 `color` | string | `Black` |
| 🔧 `enginePowerCc` | integer | `2500` |
| 🛞 `steeringPosition` | string | `Right Hand Drive` |
| 📜 `licenceStatus` | string | `With Licence` |
| 🪪 `plateDivision` | string | `MDY` |
| 🎨 `plateColor` | string | `Black` |
| 🚦 `plateNumber` | string | `MDY/6E-4*** (Black)` |
| 👤 `numberOfOwners` | integer | null | `1` |
| 🔄 `exchangeable` | boolean | `false` |
| 🏘️ `township` | string | `Insein` |
| 🏞️ `state` | string | `Yangon Division` |
| 🌏 `country` | string | `Myanmar` |
| 🧑 `sellerName` | string | `Hay Mar Lwin` |
| 🏢 `sellerType` | string | `Dealer` |
| 📞 `sellerContact` | string | null | `09457000125` |
| ✅ `sellerVerified` | boolean | `false` |
| 🖼️ `sellerAvatar` | string | null | Seller profile image URL |
| 🧮 `imageCount` | integer | `5` |
| 🖼️ `imageUrls` | string\[] | null | All gallery image URLs (populated when `includeDetails` is on) |
| 📄 `description` | string | null | Free-text body, often in Burmese script |
| 👀 `viewsCount` | integer | null | `157` |
| 📅 `postedAt` | string (ISO 8601) | `2026-05-20T16:28:32.000+06:30` |
| 📅 `updatedAt` | string (ISO 8601) | `2026-05-20T16:29:59.000+06:30` |
| 📅 `scrapedAt` | string (ISO 8601) | `2026-05-20T12:29:13.000Z` |
| 🚨 `error` | string | Only present on failure rows |

#### 📦 Sample records

<details>
<summary><b>Typical record (used Toyota sedan, Mandalay plate, full details)</b></summary>

```json
{
  "imageUrl": "https://www.imhcdb.com/rails/active_storage/representations/redirect/.../702864699_2847108375636289_8685290263255574525_n.jpg",
  "title": "Toyota Mark II 1998",
  "url": "https://www.carsdb.com/en/car-listings/1998-toyota-mark-ii-786672",
  "lotNumber": "786672",
  "listingId": "786672",
  "condition": "Used Car",
  "manufacturer": "Toyota",
  "model": "Mark II",
  "year": 1998,
  "priceMmk": 55000000,
  "priceLakh": 550,
  "priceCurrency": "MMK",
  "mileageKm": 172500,
  "mileageRange": "170 - 175k Km",
  "transmission": "Auto",
  "fuelType": "Petrol",
  "buildType": "Sedan",
  "color": "Black",
  "enginePowerCc": 2500,
  "steeringPosition": "Right Hand Drive",
  "licenceStatus": "With Licence",
  "plateDivision": "MDY",
  "plateColor": "Black",
  "plateNumber": "MDY/6E-4*** (Black)",
  "numberOfOwners": 1,
  "exchangeable": false,
  "township": "Insein",
  "state": "Yangon Division",
  "country": "Myanmar",
  "sellerName": "Hay Mar Lwin",
  "sellerType": "Dealer",
  "sellerContact": "09457000125",
  "imageCount": 5,
  "imageUrls": ["..._n.jpg (5 total)"],
  "description": "Grande grade, 2.5cc Engine, Price 550 Lakh, located in Insein...",
  "viewsCount": 157,
  "postedAt": "2026-05-20T16:28:32.000+06:30",
  "scrapedAt": "2026-05-20T12:29:13.000Z"
}
```

</details>

<details>
<summary><b>Edge case (high-value Land Cruiser, classic SUV, 8-image gallery, verified dealer)</b></summary>

```json
{
  "imageUrl": "https://www.imhcdb.com/rails/.../701841724_122471580506227063_7644527258288201017_n.jpg",
  "title": "Toyota Landcrusier 1998",
  "url": "https://www.carsdb.com/en/car-listings/1998-toyota-landcrusier-786670",
  "lotNumber": "786670",
  "condition": "Used Car",
  "manufacturer": "Toyota",
  "model": "Landcrusier",
  "year": 1998,
  "priceMmk": 170000000,
  "priceLakh": 1700,
  "priceCurrency": "MMK",
  "mileageKm": 152500,
  "mileageRange": "150 - 155k Km",
  "transmission": "Auto",
  "fuelType": "Petrol",
  "buildType": "SUV",
  "color": "White",
  "enginePowerCc": 4700,
  "steeringPosition": "Right Hand Drive",
  "licenceStatus": "With Licence",
  "plateDivision": "YGN",
  "plateColor": "Black",
  "plateNumber": "YGN/3H-4*** (Black)",
  "numberOfOwners": 1,
  "exchangeable": false,
  "township": "Mayangone",
  "state": "Yangon Division",
  "country": "Myanmar",
  "sellerName": "Golden AZ Myanmar",
  "sellerType": "Dealer",
  "sellerContact": "09444599664",
  "imageCount": 8,
  "imageUrls": ["..._n.jpg (8 total)"],
  "description": "Toyota Land Cruiser, 1998 model, 4.7cc engine, white, 3H YGN plate, classic legend, ...",
  "viewsCount": 164,
  "postedAt": "2026-05-20T15:54:11.000+06:30",
  "scrapedAt": "2026-05-20T12:29:13.000Z"
}
```

</details>

<details>
<summary><b>Sparse record (price-on-request stationwagon, no trim, dealer phone only)</b></summary>

```json
{
  "imageUrl": "https://www.imhcdb.com/rails/.../663273982_2173211216865886_1388066023302140727_n.jpg",
  "title": "Toyota Wish 2003",
  "url": "https://www.carsdb.com/en/car-listings/2003-toyota-wish-786675",
  "lotNumber": "786675",
  "condition": "Used Car",
  "manufacturer": "Toyota",
  "model": "Wish",
  "trim": null,
  "year": 2003,
  "priceMmk": 0,
  "priceLakh": 0,
  "priceCurrency": "MMK",
  "mileageKm": 82500,
  "mileageRange": "80 - 85k Km",
  "transmission": "Auto",
  "fuelType": "Petrol",
  "buildType": "Stationwagon",
  "color": "Red",
  "enginePowerCc": 2000,
  "steeringPosition": "Right Hand Drive",
  "licenceStatus": "With Licence",
  "plateDivision": "YGN",
  "plateColor": "Black",
  "plateNumber": "YGN/7H-5*** (Black)",
  "numberOfOwners": 1,
  "township": "Ahlone",
  "state": "Yangon Division",
  "country": "Myanmar",
  "sellerName": "kowana",
  "sellerType": "Dealer",
  "sellerContact": "+959404469266",
  "imageCount": 9,
  "viewsCount": 156,
  "postedAt": "2026-05-20T16:59:02.000+06:30",
  "scrapedAt": "2026-05-20T12:29:13.000Z"
}
```

</details>

***

### ✨ Why choose this Actor

| | Capability |
|---|---|
| ⚡ | **Algolia-fast pagination.** Listing pages come from the same search index the storefront uses, so 1,000 records arrive in under a minute. No browser, no proxy gymnastics. |
| 🇲🇲 | **Myanmar-native fields.** Plate division, plate color, license status, and Lakh pricing match the conventions Yangon and Mandalay dealers actually use. |
| 🌐 | **Right-hand-drive coverage.** Myanmar is one of the few large RHD markets still importing freely. The catalog includes 16,000+ Toyota, Honda, Suzuki, Nissan units priced in MMK. |
| 🖼️ | **Full image gallery.** Cover plus every gallery photo is captured, not just the listing thumbnail. Useful for visual de-dup, AI image classification, and dealer competitor monitoring. |
| 🧮 | **Dual currency surface.** Prices are stored as both `priceMmk` (e.g. 55,000,000) and `priceLakh` (e.g. 550), so spreadsheets, dashboards, and APIs can pick whichever scale matches their existing data. |
| 🔍 | **18 filter dimensions.** Make, model, year, price, mileage, build type, fuel, transmission, color, plate division, license status, condition, steering, and seller type all combine with AND. |
| 🧪 | **Two-mode capture.** Pick listing-card data only (16 fields, runs at API speed) or enable detail enrichment for description, view count, owner count, and full gallery (41 fields). |

> 📊 The Algolia index reports **18,901 live listings as of 2026-05-20**, refreshed continuously by dealers across all 14 Myanmar states and divisions.

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| Official publications | Free | Sparse, slow | Quarterly | None | None |
| Paid live APIs | $$$ | Variable | Real-time | Variable | API key, contracts |
| Hand-scraped community dumps | Free | Stale, partial | Months | None | None |
| In-house scraping team | $$$$ | High but brittle | As good as the team | Anything | Engineers and infra |
| **⭐ CarsDB Scraper** *(this Actor)* | $ | All public listings | On-demand or schedule | 18 filter dimensions | One JSON input |

If you need the Myanmar used-car market with structured fields and a quick refresh, this Actor is the fastest path from idea to dataset.

***

### 🚀 How to use

1. 🪪 **Sign up.** [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp). No credit card required for the free preview.
2. 🚗 **Open the Actor.** Find the CarsDB Scraper on the Apify Store and click Try for free.
3. ⚙️ **Configure input.** Pick your filters (or leave them empty to scrape the newest listings across the catalog), set `maxItems`, and decide whether to fetch detail pages.
4. ▶️ **Run.** Hit Start. Watch the log for the Algolia hit count and saved-record counter.
5. 📥 **Download the dataset.** Grab it as CSV, Excel, JSON, JSONL, RSS, HTML, or XML from the Storage tab, or pull it via the [Apify API](https://docs.apify.com/api/v2) into your own pipeline.

> ⏱️ **Total time:** under 60 seconds for a 50-record preview, roughly 12 minutes for a full 1,000-record run with detail enrichment turned on.

***

### 💼 Business use cases

<table>
<tr>
<td width="50%">

#### 🚚 Auto export and import

- Source right-hand-drive Toyotas, Hondas, and Suzukis for re-export to other RHD markets
- Spot CIF-Only freshly-landed stock before it gets plated and marked up
- Benchmark Yangon vs Mandalay vs Nay Pyi Taw price gaps for arbitrage
- Track new-model Chinese EV imports as they enter the Myanmar market

</td>
<td width="50%">

#### 🏦 Auto finance and insurance

- Reference live market prices when valuing collateral on Myanmar loans
- Build claim-payout reference tables that update with the storefront
- Spot inventory turning over fast (low days-on-market) as a credit signal
- Track average kilometres at sale by make, model, and year band

</td>
</tr>
<tr>
<td width="50%">

#### 📊 Market research and consulting

- Build demand and pricing models for Southeast Asian auto trade
- Quantify Toyota dominance (9,182 listings out of 18,901, roughly 49%) over time
- Track how Chinese EV brands like BYD, Geely, and Jetour expand share
- Map plate-division geography against dealer count and price band

</td>
<td width="50%">

#### 🛒 Marketplace and listing aggregators

- Feed live Myanmar inventory into multi-country car portals
- Power dealer-search and recommendation tools with real-time data
- Build price-alert and watchlist features for end users
- Cross-list Myanmar stock on auction or sourcing platforms

</td>
</tr>
</table>

***

### 🔌 Automating CarsDB Scraper

Run the Actor on a schedule or trigger it from your application. Apify exposes a full REST and SDK surface.

- [Apify Node.js SDK](https://docs.apify.com/sdk/js/) for JavaScript and TypeScript automations
- [Apify Python SDK](https://docs.apify.com/sdk/python/) for data-science and ML pipelines
- [Apify API reference](https://docs.apify.com/api/v2) for direct HTTP integrations

Schedules let you run this Actor hourly, daily, or weekly with the same input. Wire the dataset webhook into your warehouse and you have a live Myanmar car-market feed without a single line of crawler code.

***

### 🌟 Beyond business use cases

Data like this powers more than commercial workflows. The same structured records support research, education, civic projects, and personal initiatives.

<table>
<tr>
<td width="50%">

#### 🎓 Research and academia

- Empirical datasets for papers, thesis work, and coursework
- Longitudinal studies tracking changes across snapshots
- Reproducible research with cited, versioned data pulls
- Classroom exercises on data analysis and ethical scraping

</td>
<td width="50%">

#### 🎨 Personal and creative

- Side projects, portfolio demos, and indie app launches
- Data visualizations, dashboards, and infographics
- Content research for bloggers, YouTubers, and podcasters
- Hobbyist collections and personal trackers

</td>
</tr>
<tr>
<td width="50%">

#### 🤝 Non-profit and civic

- Transparency reporting and accountability projects
- Advocacy campaigns backed by public-interest data
- Community-run databases for local issues
- Investigative journalism on public records

</td>
<td width="50%">

#### 🧪 Experimentation

- Prototype AI and machine-learning pipelines with real data
- Validate product-market hypotheses before engineering spend
- Train small domain-specific models on niche corpora
- Test dashboard concepts with live input

</td>
</tr>
</table>

***

### 🤖 Ask an AI assistant about this scraper

Paste this prompt into any AI assistant to learn what you can do with this Actor:

> "I have access to a CarsDB Myanmar scraper that returns structured car listing data including make, model, year, price in MMK and Lakh, mileage, plate division, steering position, license status, fuel type, transmission, seller contacts, and full image galleries for 18,900+ listings. What are creative ways I can use this dataset for market research, pricing models, or business applications?"

***

### ❓ Frequently Asked Questions

<details>
<summary><b>💼 Can I use the data commercially?</b></summary>

Yes, the data is collected from publicly accessible listings on carsdb.com and can be used for commercial purposes including market research, internal dashboards, and customer-facing products. Always review the source storefront's terms of service for your specific use case and remove any seller personal data before redistribution.

</details>

<details>
<summary><b>💳 Do I need a paid Apify plan to use this Actor?</b></summary>

No. Free Apify accounts can run a 10-item preview to verify field shape and the JSON layout. Paid plans unlock up to 1,000,000 items per run, scheduling, and longer retention. Sign up at [console.apify.com/sign-up?fpr=vmoqkp](https://console.apify.com/sign-up?fpr=vmoqkp).

</details>

<details>
<summary><b>⚠️ What happens if a run fails?</b></summary>

You are not charged for failed runs. If a single detail page fails, the Actor still pushes the listing-card data and continues. If the Algolia backend returns an error mid-run, the run aborts and surfaces the response body in the log so you can adjust filters and retry.

</details>

<details>
<summary><b>⚖️ Is web scraping legal?</b></summary>

Scraping publicly accessible web pages is generally legal in most jurisdictions, particularly for personal use, research, and journalism. The data captured here is public and accessible without login. You are responsible for complying with applicable laws in your jurisdiction and the storefront's own terms of service. Treat seller contact information with the same care you would treat any directory data.

</details>

<details>
<summary><b>🔢 How fresh is the data?</b></summary>

Every run hits the live Algolia index that powers carsdb.com, so records reflect what visitors see at the moment of execution. Most listings are bumped or updated daily by dealers.

</details>

<details>
<summary><b>💱 What currency are prices in?</b></summary>

Both. Every record stores `priceMmk` (full Myanmar Kyat amount, e.g. 55,000,000) and `priceLakh` (the local convention of 1 Lakh = 100,000 MMK, e.g. 550). When a seller posts "price on request" both fields land at 0 rather than fabricated values.

</details>

<details>
<summary><b>🛞 Does the Actor capture right-hand-drive vehicles?</b></summary>

Yes. Myanmar is predominantly a right-hand-drive market and roughly 99% of CarsDB stock is RHD. The `steeringPosition` field is captured for every listing, and the `steeringPosition` input lets you restrict to LHD-only or RHD-only.

</details>

<details>
<summary><b>📜 What is "CIF Only" license status?</b></summary>

CIF Only means the vehicle has been imported with Cost, Insurance, and Freight cleared at customs but has not yet been issued a Myanmar license plate. These are often freshly landed dealer stock waiting for plate allocation. "No Slip" means missing paperwork. "With Licence" is fully plated and road-legal.

</details>

<details>
<summary><b>🇲🇲 Why so many Japanese and Chinese makes?</b></summary>

Myanmar imports almost no European or American cars due to import-restriction policies favoring right-hand-drive vehicles. The market is dominated by Japanese used-car re-exports (Toyota, Honda, Suzuki, Nissan, Mazda, Mitsubishi) and a fast-growing share of Chinese new-car imports (BYD, Geely, Bestune, Hongqi, Jetour).

</details>

<details>
<summary><b>📞 Does the data include seller phone numbers?</b></summary>

Yes, when CarsDB publishes them on the public listing page. About 95% of records carry a `sellerContact` phone number; the rest leave the field null. Phone numbers are formatted as the seller chose to display them (commonly the Myanmar 09 prefix).

</details>

<details>
<summary><b>🖼️ How many images per listing?</b></summary>

Typical listings carry 5 to 13 images. The cover thumbnail is always populated as `imageUrl`. When you enable `includeDetails`, the full gallery is captured into `imageUrls`.

</details>

<details>
<summary><b>📍 Can I restrict to a specific city or township?</b></summary>

The Algolia backend exposes state-level granularity (`Yangon Division`, `Mandalay Division`, etc.). Township is captured in the output record but not as a filter. To get township-level slices, scrape a state then filter the dataset client-side.

</details>

***

### 🔌 Integrate with any app

- [**Zapier**](https://zapier.com/apps/apify/integrations) - send each new listing into Google Sheets, Airtable, or Slack
- [**Make**](https://www.make.com/en/integrations/apify) - automate multi-step workflows with no code
- [**n8n**](https://n8n.io/integrations/apify/) - open-source orchestration for self-hosted pipelines
- [**Apify Webhooks**](https://docs.apify.com/platform/integrations/webhooks) - HTTP callbacks on every successful run
- [**Apify REST API**](https://docs.apify.com/api/v2) - pull dataset items into any backend
- [**Apify Scheduler**](https://docs.apify.com/platform/schedules) - run this Actor hourly, daily, weekly, monthly

***

### 🔗 Recommended Actors

- [**🚗 Gumtree Cars Scraper**](https://apify.com/parseforge/gumtree-cars-scraper) - UK used-car classifieds with the same listing-plus-detail shape
- [**🛒 Carousell Scraper**](https://apify.com/parseforge/carousell-scraper) - Southeast Asian peer-to-peer marketplace covering Singapore, Malaysia, Indonesia, and the Philippines
- [**🚙 CarMax Scraper**](https://apify.com/parseforge/carmax-scraper) - US used-car retailer for cross-market price benchmarking
- [**📘 Kelley Blue Book Scraper**](https://apify.com/parseforge/kelley-blue-book-scraper) - US vehicle valuations to anchor any cross-border arbitrage model
- [**🏁 Bring A Trailer Auctions Scraper**](https://apify.com/parseforge/bringatrailer-auctions-scraper) - collector and enthusiast auctions for classic and rare cars

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more car, auction, and marketplace scrapers.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) and we will get back within one business day.

***

> 📌 **Disclaimer:** This Actor is an independent ParseForge product and is not affiliated with, endorsed by, or sponsored by CarsDB or any other car marketplace. All data is collected from publicly accessible web pages. Users are responsible for complying with applicable laws and the source storefront's terms of service.

# Actor input Schema

## `startUrls` (type: `array`):

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.

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## `query` (type: `string`):

Optional free-text query (e.g. "hilux", "prius", "e-class"). Searched across title, make, model, trim, and lot number.

## `manufacturers` (type: `array`):

Pick one or more car manufacturers. Empty matches all.

## `modelQuery` (type: `string`):

Restrict to a specific model name (case-insensitive substring match). Use together with Make for best precision. Example: "Wish", "Hilux Surf", "CR-V".

## `states` (type: `array`):

Pick one or more Myanmar states or divisions where the car is located.

## `buildTypes` (type: `array`):

Body type filter.

## `fuelTypes` (type: `array`):

Fuel filter.

## `transmissions` (type: `array`):

Gearbox type filter.

## `colors` (type: `array`):

Exterior color filter.

## `condition` (type: `string`):

Filter by listing condition.

## `steeringPosition` (type: `string`):

Cars from Myanmar are predominantly Right Hand Drive, but a portion of imports are Left Hand Drive.

## `sellerTypes` (type: `array`):

Filter by seller account type (Dealer / Private seller / Showroom / Buyer-looking).

## `licenceStatus` (type: `array`):

Vehicle licence status (Myanmar-specific). "CIF Only" = freshly imported / not yet plated.

## `yearFrom` (type: `integer`):

Minimum model year (inclusive).

## `yearTo` (type: `integer`):

Maximum model year (inclusive).

## `priceLakhFrom` (type: `integer`):

Minimum asking price in Lakh (100,000 MMK). E.g. 100 = 10,000,000 MMK ~= US$4,800.

## `priceLakhTo` (type: `integer`):

Maximum asking price in Lakh (100,000 MMK).

## `sortBy` (type: `string`):

Listing order before pagination.

## `includeDetails` (type: `boolean`):

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).

## `locale` (type: `string`):

Language for detail-page enrichment text (description, headings). Listing-card data is identical across locales.

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. Default Apify datacenter proxy is sufficient - CarsDB does not block scrapers and the Algolia search backend has no IP rate limit.

## Actor input object example

```json
{
  "startUrls": [],
  "maxItems": 10,
  "condition": "",
  "steeringPosition": "",
  "sortBy": "dateNewest",
  "includeDetails": true,
  "locale": "en",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [],
    "maxItems": 10,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/carsdb-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [],
    "maxItems": 10,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/carsdb-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [],
  "maxItems": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call parseforge/carsdb-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/carsdb-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```