Sign in Get API key
Batdongsan API

Batdongsan API for Vietnamese Property Search, Listing Details, Price History and Agents

Scrappa's Batdongsan API returns structured JSON from Batdongsan, a Vietnamese property marketplace. Search homes for sale and for rent in all 63 provinces with price, area, bedroom, bathroom, category, legal status, interior, direction and location filters, open any listing with coordinates, photos and publisher, read price history and similar listings, autocomplete districts, wards, streets and projects, look up agent profiles and top agents, and list map markers for a map box.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
Start for free View documentation
Browse endpoints Try first endpoint
8
Endpoints
63
Provinces
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Get free API key Try in Playground Open docs
Request preview
Request 
curl -X GET "https://scrappa.co/api/batdongsan/search?city=HN&listing_type=sale&bedrooms=2&min_area=50&max_area=60" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response 
{
  "success": true,
  "data": {
    "pagination": { "page": 1, "per_page": 20, "total": 44794, "total_pages": 2240, "returned": 20, "has_next_page": true },
    "items": [
      {
        "id": 46364654,
        "listing_type": "sale",
        "title": "Vinhomes The Gallery",
        "price": { "value_vnd": 40000000000, "display": "40 tỷ", "unit_display": "333,33 tr/m²" },
        "area": 120,
        "bedrooms": null,
        "location": { "city_code": "HN", "project_name": "Vinhomes The Gallery" }
      }
    ]
  },
  "meta": { "filtered_out": 0, "endpoint_family": "search", "billable": true }
}

What you can build

Structured data for real applications. Here are some ideas.

Property Price Analysis

Track asking prices and rents in Vietnamese dong by province, district, project and category.

Listing Monitoring

Page through filtered searches and open each listing for facts, photos and publisher details.

Project Research

Read the quarterly price chart of a project and compare a listing with the usual price.

Agent Discovery

Find the top professional agents of a province and read their certificates and listing counts.

Map Views

Draw listings and project clusters for any map box.

Batdongsan scraper API

Batdongsan API for Vietnamese listings, prices, price history and agents

The Batdongsan API is built for real-estate analytics, listing tools and market research in Vietnam. Each search item carries the price in Vietnamese dong, the area, rooms, the address in the old and the new ward system, photos and the publisher. Listing detail adds coordinates, legal status, direction, road width and tags.

One search route for sale and rent in all 63 provinces.

Filters are always honoured: items that break a filter are dropped and counted, never returned.

Pagination returns the real page; a page past the end returns an empty list with the real totals.

Prices are in dong, with the display text and the price per square meter.

Failed requests are never billed.

Choose the right Batdongsan API endpoint

Use Autocomplete to find a location id

Resolve a district, ward, street or project to an id and a type and pass both into search.

Open Batdongsan Autocomplete API docs

Use Property Search for market coverage

Pick a province, add filters and sort, then page through the results.

Open Batdongsan Search API docs

Use Listing Detail for the full record

Pass a listing id to get coordinates, all photos, legal status and the publisher track record.

Open Batdongsan Listing API docs

Available endpoints

Everything you need in one API.

GET

Property Search

/api/batdongsan/search

Search Vietnamese homes for sale and for rent by province, price, area, rooms and more

Try in Playground View docs
GET

Location Autocomplete

/api/batdongsan/autocomplete

Autocomplete districts, wards, streets and projects to a search-ready id

Try in Playground View docs

Related resources

PropertyGuru API overview

Compare listings from PropertyGuru with Batdongsan.

Rumah123 API overview

Add Indonesian listings from Rumah123 to your research.

Scrappa vs ScrapingBee / ScraperAPI

See how Scrappa compares to the official API.

Batdongsan listing data as JSON
Scrappa:
ScrapingBee / ScraperAPI: Build your own parser
Sale and rent in one route
Scrappa:
ScrapingBee / ScraperAPI: Separate scrapers
Filters guaranteed on every item
Scrappa:
ScrapingBee / ScraperAPI: Not available
Price per 1k requests
Scrappa: From $0.20
ScrapingBee / ScraperAPI: Varies by plan
Unified API key
Scrappa: Yes (80+ APIs)
ScrapingBee / ScraperAPI: Scraping only
Free tier
Scrappa: 500 credits/month
ScrapingBee / ScraperAPI: Trial credits only

Key features

Search, listing, price history, similar, autocomplete, agent, top agents and map marker routes as JSON
Sale and rent in one search route, all 63 provinces
Numeric prices in dong, area, rooms, coordinates, legal status, direction and tags
Autocomplete ids that feed the search filters directly
No browser, no login: public data served through a single Scrappa API key

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by Batdongsan. The Batdongsan API returns structured JSON from public listing data through a Scrappa API key.

Dong. You send min_price and max_price in dong, and the response gives price.value_vnd in dong with the display text next to it.

No. Batdongsan offers no list of the listings of one agent. The agent route returns the profile and the number of listings. Search by location and project to reach listings.

No. Only successful responses are billed. A valid empty search result is successful and billable.

Start using the Batdongsan API

Sign up and get 500 free credits. No credit card required.

Create Free Account View Documentation