Vietnam Property Listings Scraper — Batdongsan.com.vn

Scrapes property listings from Batdongsan.com.vn, Vietnam's largest real estate portal. Returns price, location, bedrooms, legal status, agent contact, and photos for sale and rental listings across the whole country — well over 170,000 active listings at last count.

---

Vietnam Property Listings Scraper Features

• Parses Vietnamese price shorthand ("36,5 tỷ", "688 tr/m²") into clean numbers, not raw text you'd have to decode yourself.
• Covers both sale and rental listings, nationwide, by default.
• Returns the fields most bundled scrapers drop: facade width, house-facing direction, and legal status (sổ đỏ / sổ hồng).
• Pulls the full listing description, agent name, and every listed photo.
• Resolves latitude and longitude for listings that carry a map pin.
• Filters by transaction type or city with two input fields — no extra setup.

---

Who Uses Vietnam Property Listing Data?

• Real estate investors — track price-per-square-meter across districts before committing capital.
• Proptech startups — feed listing data into a valuation model or a comparison tool.
• Relocation and expat services — build a rental inventory feed for clients moving to Ho Chi Minh City or Hanoi.
• Market researchers — measure inventory and pricing across Vietnam's property market, not just one city.
• Lead generation teams — collect agent names and listings tied to active inventory.

---

How Vietnam Property Listings Scraper Works

1. Pick a transaction type (sale, rent, or both) and, optionally, a city. Leave both blank and it covers all of Vietnam.
2. The scraper works through the listing pages for each selection, collecting every listing it finds.
3. Each listing gets its own pass to pull the fields the search-results page never carries — bedrooms, direction, legal status, the full description, and photos.
4. Results land in your dataset as they're found, so stopping a run early still keeps everything collected up to that point.

---

Input

{
  "maxItems": 100,
  "transactionTypes": ["sale"],
  "provinces": ["tp-hcm"]
}

Field	Type	Default	Description
maxItems	Integer	10	Maximum number of listings to return.
transactionTypes	Array	["sale", "rent"]	Sale and/or rental listings. Leave empty to crawl both.
provinces	Array	[] (all of Vietnam)	Limit the crawl to specific cities: tp-hcm, ha-noi, da-nang, binh-duong, dong-nai. Leave empty for the whole country.
resumeCursor	String	—	Cursor from a previous run's Output. Leave empty for a fresh crawl.

Renting instead of buying? Set "transactionTypes": ["rent"] and everything else works the same way.

---

Resuming a large crawl

Every run emits a resumeCursor in its Output. If a large crawl stops before it finishes — because it hit maxItems, your spend cap (maxTotalChargeUsd), or was aborted — start a new run with the same input plus that resumeCursor to continue from where it left off. The crawl resumes from the queued work the previous run didn't reach.

• You are not re-charged for records the earlier run already delivered.
• Resume within your account's run-retention window — on the free tier, roughly your 10 most recent runs. Once the source run is pruned, its resumeCursor is no longer valid.
• resumeCursor is opaque — supply it unmodified.

---

Vietnam Property Listings Scraper Output Fields

{
  "listing_id": "46353677",
  "listing_url": "https://batdongsan.com.vn/cho-thue-can-ho-chung-cu-duong-nguyen-huu-canh-phuong-22-vinhomes-central-park/trong-3pn-2-ban-cong-116m2-gia-cuc-tot-27-7tr-view-song-huong-mat-ca-ngay-pr46353677",
  "title": "Trống 3PN 2 ban công, 116.4m2, giá cực tốt 27,7 triệu/tháng view sông, hướng mát cả ngày",
  "price": 27700000,
  "price_text": "27,7 triệu/tháng",
  "currency": "VND",
  "price_per_sqm": null,
  "transaction_type": "rent",
  "property_type": "Căn hộ chung cư (Apartment)",
  "address": "Vinhomes Central Park, Đường Nguyễn Hữu Cảnh, Phường 22, Quận Bình Thạnh, Hồ Chí Minh",
  "district": "Bình Thạnh",
  "city": "Hồ Chí Minh",
  "latitude": 10.79493,
  "longitude": 106.7207,
  "bedrooms": 3,
  "bathrooms": 2,
  "area_sqm": 116.4,
  "facade_width": null,
  "direction": "Tây - Bắc",
  "legal_status": null,
  "description": "3PN - 2WC - 2 ban công view sông cực chill...",
  "agent_name": "Mỹ Chi Vinhomes",
  "agent_phone": "0399 680 ***",
  "image_urls": [
    "https://file4.batdongsan.com.vn/resize/1275x717/2026/09/28/20260928133438-4ee0_wm.jpg",
    "https://file4.batdongsan.com.vn/resize/1275x717/2026/09/28/20260928133438-3d9e_wm.jpg"
  ],
  "listing_date": "2026-09-28T13:45:55.9770000+07:00"
}

Field	Type	Description
listing_id	String	Batdongsan's internal listing ID.
listing_url	String	Canonical link to the listing.
title	String	Listing title as written by the poster.
price	Number	Parsed asking price in VND. null when the listing says "negotiable" instead of naming a price.
price_text	String	The raw price text as shown on the page (e.g. "36,5 tỷ" or "Thỏa thuận").
currency	String	Always VND.
price_per_sqm	Number	Parsed price per square meter in VND, where the listing states one.
transaction_type	String	sale or rent.
property_type	String	Property type — house, apartment, land, shophouse, and similar categories.
address	String	Full street address as listed.
district	String	District or ward.
city	String	City or province.
latitude	Number	Latitude, where the listing carries a map pin.
longitude	Number	Longitude, where the listing carries a map pin.
bedrooms	Number	Number of bedrooms, where listed.
bathrooms	Number	Number of bathrooms, where listed.
area_sqm	Number	Floor area in square meters.
facade_width	Number	Facade width in meters (mặt tiền) — houses and shophouses only.
direction	String	House-facing direction (hướng nhà), where listed.
legal_status	String	Legal status (sổ đỏ / sổ hồng), where the listing states one.
description	String	Full listing description as written by the poster.
agent_name	String	Listing agent's name.
agent_phone	String	Agent phone number as displayed. Batdongsan partially masks the number on the page — that's what you get back.
image_urls	Array	URLs of every listed photo.
listing_date	String	Listing publish date, ISO 8601.

---

FAQ

How do I scrape Batdongsan.com.vn?

Vietnam Property Listings Scraper needs no account and no API key for Batdongsan. Run it with the defaults and it crawls every sale and rental listing in the country; add provinces or transactionTypes to narrow it down.

What data can I get from Batdongsan property listings?

Price, area, bedrooms, bathrooms, address, legal status, agent contact, photos, and more — 25 fields per listing, covering both the search-results summary and the detail-page specifics that summary never carries.

Can I filter by sale or rental listings?

Yes. Set transactionTypes to ["sale"], ["rent"], or leave it as the default ["sale", "rent"] to get both.

Does this cover all of Vietnam, or just Ho Chi Minh City?

All of Vietnam by default. provinces narrows the crawl to specific cities when you don't need the whole country.

Is the agent's phone number included?

Batdongsan displays agent phone numbers partially masked (e.g. "0973 034 ***") until a visitor clicks to reveal them. The scraper returns exactly what's on the page — the full number isn't there to collect.

---

Need More Features?

Need custom fields, filters, or a different target site? File an issue or get in touch.

Why Use Vietnam Property Listings Scraper?

• Nationwide by default — most listing scrapers make you pick a city first. This one covers the whole country unless you narrow it.
• Vietnam-specific fields — facade width, house direction, and legal status are exactly the fields a generic multi-country bundle strips out to keep its schema uniform.
• Parsed, not raw — price and area come back as numbers you can sort and filter on, not strings you have to parse yourself.