Property Search
/api/chotot-nha/v1/search
Search sale or rent listings of five categories with location, price, area, room and keyword filters
Scrappa's Nha Tot API returns structured JSON from Nha Tot (Cho Tot), a large Vietnamese property marketplace. Search apartments, houses, commercial space, land and rooms for sale or rent, filter by region, district, ward, price, area, bedrooms and bathrooms, read the full detail of one listing, list the ads of one seller and resolve locations and housing projects. Prices are numeric VND values and every search page matches the page you asked for.
Try it now
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.
curl -X GET "https://scrappa.co/api/chotot-nha/v1/search?for=rent&category=apartment®ion_id=13000&min_price=5000000&max_price=15000000&bedrooms=2&sort=price_asc" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
{
"success": true,
"data": {
"items": [
{
"id": 134915432,
"url": "https://www.nhatot.com/134915432.htm",
"title": "Shop house cc Hiep Thanh city",
"for": "sale",
"price": {"amount": 4190000000, "currency": "VND", "label": "4,19 ty"},
"size": {"area_m2": 120, "unit": "m2"},
"rooms": {"bedrooms": 3, "bathrooms": 3}
}
],
"page": 1,
"per_page": 20,
"total": 2543,
"total_pages": 128,
"has_more": true
},
"meta": {
"endpoint_family": "search",
"billable": true
}
}
Structured data for real applications. Here are some ideas.
Read numeric VND prices, price per square metre and area to compare sale and rent listings across Ho Chi Minh City, Hanoi and other regions.
Filter rentals by district, price, area and bedrooms and sort by price to build rental finders.
Watch one listing for price changes, photos and attributes, including the previous price.
Read seller profiles and list every ad of one seller with rating and sold ads.
Resolve free text, regions, districts, wards and housing projects into ids for the search filters.
Nha Tot scraper API
The Nha Tot API is built for property analytics, rental tools and real-estate search features in Vietnam. Each listing carries a numeric VND price, area, rooms, coordinates, ward and district names, photos and the seller.
Search apartments, houses, commercial space, land and rooms for sale and rent.
Filter by region, district, ward, price, area, bedrooms, bathrooms and keyword.
Sort by newest or price; the page you ask for is the page you get.
Open any listing for attributes, address and all photos.
List all ads of one seller with the numeric account id.
Phone numbers are never returned.
Read the region and district ids once, then reuse them in search. Wards give the finest filter.
Open Nha Tot Regions API docsFilter by category, location, price, area and rooms to collect matching listings with live paging metadata.
Open Nha Tot Search API docsEverything you need in one API.
/api/chotot-nha/v1/search
Search sale or rent listings of five categories with location, price, area, room and keyword filters
/api/chotot-nha/v1/listing
Get the full detail of one listing
/api/chotot-nha/v1/seller
Get the public profile of one seller or agent
/api/chotot-nha/v1/autocomplete
Find location suggestions with ready filter ids
/api/chotot-nha/v1/projects
Find housing projects, districts and streets by name
/api/chotot-nha/v1/regions
List the regions of Vietnam with their districts
/api/chotot-nha/v1/wards
List the wards of one district
See how Scrappa compares to the official API.
| Feature | Scrappa | ScrapingBee / ScraperAPI |
|---|---|---|
| Nha Tot listing data as JSON | Build your own parser | |
| Filters checked before the response | ||
| Price per 1k requests | From $0.20 | Varies by credits per request |
| Unified API key | Yes (80+ APIs) | Scraping only |
| Free tier | 500 credits/month | Trial credits |
No. Scrappa is an independent service and is not affiliated with or endorsed by Nha Tot or Cho Tot. The API returns structured JSON from public listings through a Scrappa API key.
Every Scrappa account includes 500 free credits each month. After that, each request costs one credit. Failed requests are never charged.
Use the one-based page parameter and per_page up to 50. The response returns page, per_page, total, total_pages and has_more. Nha Tot serves only the first 10000 results of a search, so narrow the filters for deeper results.
Call search with the numeric account_id of a search item. The seller profile endpoint takes the 32 character seller oid instead.
No. Phone numbers are never returned. Listings and sellers return their public data only.