batdongsan.com.vn APIbatdongsan.com.vn ↗
Access Vietnam real estate listings, project data, and news from batdongsan.com.vn via 5 structured API endpoints covering sale, rent, and property details.
curl -X GET 'https://api.parse.bot/scraper/17f5b902-ea62-41aa-bc40-7b6e52965d8b/search_listings_for_sale?page=1&keyword=Vinhomes&location=tp-hcm' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for real estate listings for sale on batdongsan.com.vn. Returns paginated results with listing summaries including price, area, and location.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| keyword | string | Search keyword to filter listings (e.g. 'Vinhomes'). Omitting returns all listings. |
| location | string | Location slug for filtering by city/province (e.g. 'tp-hcm', 'ha-noi'). Omitting returns listings nationwide. |
{
"type": "object",
"fields": {
"url": "string, the URL that was fetched",
"page": "integer, current page number",
"listings": "array of listing objects with id, title, url, price, area, price_per_m2, location, published_at",
"total_count_on_page": "integer, number of listings returned on this page"
},
"sample": {
"data": {
"url": "https://batdongsan.com.vn/nha-dat-ban-tp-hcm",
"page": 1,
"listings": [
{
"id": "44056529",
"url": "https://batdongsan.com.vn/ban-can-ho-chung-cu-.../sample-pr44056529",
"area": "135 m2",
"price": "25,5 ty",
"title": "Sample listing title",
"location": "Quan 2",
"price_per_m2": "188,89 tr/m2",
"published_at": "Dang hom nay"
}
],
"total_count_on_page": 30
},
"status": "success"
}
}About the batdongsan.com.vn API
The batdongsan.com.vn API exposes 5 endpoints covering Vietnam's largest real estate portal, returning structured data on property listings for sale and rent, full listing details, development projects, and market news. The get_listing_detail endpoint delivers per-property specs, masked agent contact info, image URLs, and location breadcrumbs down to ward level — data that typically requires navigating individual listing pages manually.
Listing Search and Filtering
The search_listings_for_sale and search_listings_for_rent endpoints accept three optional parameters: page for pagination, keyword for text-based filtering (e.g. 'Vinhomes'), and location for province or city slugs such as 'tp-hcm' or 'ha-noi'. Each page response includes an array of listing objects with id, title, url, price, area, price_per_m2, location, and published_at, plus a total_count_on_page integer. Omitting both keyword and location returns nationwide results across all property types.
Property Detail Data
get_listing_detail takes a full listing URL — typically sourced from search results — and returns an expanded record. The specs field is a key-value object mapping Vietnamese-language specification labels (bedrooms, legal status, floor area, etc.) to their values, so the available keys vary by property type. The agent object includes name and phone_masked, reflecting the contact display as it appears on the listing. The location object provides breadcrumbs, city, district, and ward for precise geographic placement.
Projects and News
list_projects returns paginated development project entries with title, url, and address. This endpoint does not require any filters — pagination via page is the only available parameter. get_news returns the latest real estate news articles from the portal with title, url, and an optional summary field that may be null depending on the article format. Both endpoints are useful for monitoring market activity and new supply without querying individual listings.
- Aggregate nationwide property-for-sale inventory filtered by city slug for a Vietnam real estate comparison tool.
- Track rental listing price trends in Ho Chi Minh City using
price_per_m2from paginatedsearch_listings_for_rentresults. - Build a property detail enrichment pipeline that resolves listing URLs from search results through
get_listing_detailto extract bedroom counts and legal status from thespecsobject. - Monitor new development projects entering the market by polling
list_projectsfor newtitleandaddressrecords. - Power a Vietnam real estate news feed using
get_newsarticle titles and summaries. - Map property locations at ward level using the
breadcrumbsandwardfields fromget_listing_detail. - Build a lead-generation tool that surfaces masked agent contact details alongside listing specs for investor outreach.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does batdongsan.com.vn offer an official developer API?+
What does `get_listing_detail` return that the search endpoints don't?+
id, title, price, area, price_per_m2, location, and published_at. get_listing_detail adds the full description text, an images array, a specs object with property-specific attributes (bedrooms, legal status, etc.), an agent object with name and phone_masked, and a structured location object with breadcrumbs, city, district, and ward.Can I filter listings by property type, price range, or area size?+
keyword and location slug only. Price range, area size, and property type filters are not currently exposed. You can fork this API on Parse and revise it to add those filter parameters.Is project detail data available, or only the project list?+
list_projects returns title, url, and address per project. Detailed project pages — unit counts, developer info, pricing, or completion status — are not currently covered by a dedicated endpoint. You can fork this API on Parse and revise it to add a get_project_detail endpoint using the project URLs from the list.How current are the listings returned by the search endpoints?+
published_at field so you can assess recency yourself. The API reflects the live state of batdongsan.com.vn at the time of the request; it does not cache historical snapshots, so repeated calls to the same page may return different listings as the portal's inventory changes.