# 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:** 3 total users, 0 monthly users, 100.0% runs succeeded, 0 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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
## 🚗 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.
Pull structured records from CarsDB Myanmar Used and New Car Listings — clean fields ready as CSV, JSON, JSONL, Excel, or XML for downstream pipelines.
##### Copy to your AI assistant
Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.
```
parseforge/carsdb-scraper on Apify. Call: ApifyClient("TOKEN").actor("parseforge/carsdb-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: startUrls (array), maxItems (integer, default 10), query (string), manufacturers (array), modelQuery (string), states (array). Full actor spec: fetch build via GET https://api.apify.com/v2/acts/parseforge~carsdb-scraper (Bearer TOKEN). Get token: https://console.apify.com/account/integrations
```
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.
### 📊 Data fields
Each record includes: `buildType`, `color`, `condition`, `country`, `description`, `enginePowerCc`, `exchangeable`, `fuelType`, `imageCount`, `imageUrl`, `imageUrls`, `licenceStatus`, `listingId`, `lotNumber`, `manufacturer`, `manufacturerId`, `mileageKm`, `mileageRange`, `model`, `modelId`, `numberOfOwners`, `plateColor`, `plateDivision`, `plateNumber`, `postedAt`, `priceCurrency`, `priceLakh`, `priceMmk`, `results`, `scrapedAt`, `sellerAvatar`, `sellerContact`, `sellerName`, `sellerType`, `sellerVerified`, `state`, `steeringPosition`, `title`, `township`, `transmission`, `trim`. These field names come straight from the actor's dataset schema, so what you see here is what lands in your 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.
### 🔗 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.
> 📌 **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.
### 🆘 Need Help?
If you hit a bug, have questions about setup, or need a scraper we haven't built yet, open our [contact form](https://tally.so/r/BzdKgA) or write to parseforge@protonmail.com. We also take on paid custom data projects.
For faster answers, join our [Discord](https://parseforge.co/discord). It's the best place to get support and suggest new actors.
# 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`):
How many cars to collect per run.
## `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.
## Actor input object example
```json
{
"startUrls": [],
"maxItems": 10,
"condition": "",
"steeringPosition": "",
"sortBy": "dateNewest",
"includeDetails": true,
"locale": "en"
}
```
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"startUrls": [],
"maxItems": 10
};
// 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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"startUrls": [],
"maxItems": 10,
}
# 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
}' |
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 "
]
}
}
}
```
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/acts/RzBvwEyuZNke1IPGc/builds/pWUGb4gzG0AQOndxO/openapi.json