Batdongsan.com.vn Data Parser & API
Batdongsan.com.vn is Vietnam’s #1 property portal — 7M+ monthly users with 5-year price history and maps (East & SE Asia research report) — and PropAPIS extracts its resale, rental, new-launch, commercial and land listings through a single REST API. One integration also spans the wider PropertyGuru network (Singapore, Malaysia, Thailand’s DDproperty and Indonesia’s Rumah123).
| Country | Vietnam |
|---|---|
| Type | Portal |
| Owner | PropertyGuru Group |
| Listing types | resale, rental, new-build, commercial, land |
| Monthly visits | 7M+ monthly users |
| Active listings | Millions |
| API access | No public API (parse-only) |
| Parse priority | ★★★★★ |
| Official site | batdongsan.com.vn |
Platform Overview
Market Position
- #1 property portal in Vietnam — 7M+ monthly users (per the East & SE Asia research report)
- PropertyGuru Group holds a controlling stake, sharing the same data model as PropertyGuru SG/MY, DDproperty TH and Rumah123 ID
- Distinctive 5-year price history plus map-based search — among the richest resale price datasets in Southeast Asia
- High-growth, under-served frontier market for data resellers
Market Coverage
Geographic Coverage:
- Ho Chi Minh City
- Hanoi
- Da Nang and nationwide
Property Types:
- Apartments and condominiums (căn hộ)
- Houses and townhouses (nhà phố)
- New launches / developer projects
- Commercial properties
- Land and plots (đất)
Data Availability
Batdongsan’s standout asset is its 5-year price history and map data, layered on the PropertyGuru group schema — area, Vietnamese land-certificate type (sổ đỏ / sổ hồng), price-per-square-meter and project data — making it one of the richest resale datasets in the region.
Listing Categories:
- Buy: resale apartments, houses and land
- Rent: long-term rentals
- New Launches: developer projects
- Commercial: offices and retail
- Price History: 5-year priced records
Data Fields Available
PropAPIS extracts structured data from each Batdongsan listing:
Property Information
- Address: district, building and project
- Price: sale price or rent (VND)
- Bedrooms and Bathrooms
- Property Type: apartment, house, land, commercial
- Area: land and floor size (sq m)
- Certificate: land-title type (sổ đỏ / sổ hồng)
Price & History Data
- PSF: price per square meter
- Price History: up to 5 years of priced records
- Added Date
Listing Details
- Description: full listing text
- Photos: image URLs
- Project: development / project name
Agent Information
- Agency: agency name
- Agent: listing agent name
- Agent Contact: phone where published
Location Data
- District and Ward
- City / Province
- Coordinates: latitude and longitude
API Endpoints
Get Property Details
from propapis import PropAPIS
api = PropAPIS(api_key='your_api_key')
# Get a listing by URL or ID
property_data = api.platforms.batdongsan.get_property(
listing_id='12345678'
)
print(f"Title: {property_data.title}")
print(f"Price: ₫{property_data.price:,}")
print(f"Type: {property_data.property_type}")
print(f"District: {property_data.district}")
print(f"Certificate: {property_data.certificate}")Search Listings
# Search Batdongsan listings
listings = api.platforms.batdongsan.search(
location='Ho Chi Minh City',
purpose='for-sale',
property_type='Apartment'
)
for listing in listings[:10]:
print(f"{listing.title} - ₫{listing.price:,}")
print(f" {listing.bedrooms} bed | {listing.district}")Get Price History
# Get up to 5 years of price history for an area
history = api.platforms.batdongsan.get_price_history(
district='District 2',
city='Ho Chi Minh City',
property_type='Apartment'
)
for point in history[:5]:
print(f"{point.period}: ₫{point.median_psm:,}/m²")Quick Start
from propapis import PropAPIS
api = PropAPIS(api_key='your_api_key')
# Search Batdongsan listings in Ho Chi Minh City
listings = api.platforms.batdongsan.search(
location='Ho Chi Minh City', purpose='for-sale'
)
for listing in listings[:5]:
print(f"{listing.title} - ₫{listing.price:,}")import { PropAPIS } from 'propapis';
const api = new PropAPIS({ apiKey: 'your_api_key' });
// Search Batdongsan listings in Ho Chi Minh City
const listings = await api.platforms.batdongsan.search({
location: 'Ho Chi Minh City',
purpose: 'for-sale',
});
listings.slice(0, 5).forEach((l) => {
console.log(`${l.title} - ₫${l.price.toLocaleString()}`);
});curl "https://api.propapis.com/v1/platforms/batdongsan/search?location=Ho+Chi+Minh+City&purpose=for-sale" \
-H "Authorization: Bearer your_api_key"