Nhatot Scraper — Vietnam Real Estate Listings

Scrape property listings from Nhatot.com, Chotot's real-estate vertical and Vietnam's busiest property marketplace. This Actor extracts apartments, houses, land, offices and rooms — for sale or for rent — with the structured real-estate attributes buyers actually filter on: legal document, property status, furnishing, size, and price per m². It is fast and low-cost to run.

Run it on the Apify platform to get API access, scheduling, integrations, automatic proxy rotation, and run monitoring out of the box. Export every result to JSON, CSV, Excel, or HTML.

What does Nhatot Scraper do?

It collects real-estate ads from Nhatot and returns one clean, structured record per listing. For each property you get the title, full description, price, images, GPS coordinates, seller info, and — when enrichment is on (the default) — the labeled property attributes that make real-estate data useful: legal paperwork, handover status, furnishing level, and the price per square metre.

Why use Nhatot Scraper?

• Market research & pricing — track asking prices and price/m² by district, project, or property type.
• Lead generation — build lists of for-sale or for-rent listings with seller names and public profiles.
• Investment analysis — compare inventory and legal status across provinces and subcategories.
• Property portals & aggregators — feed a downstream site or CRM with fresh Vietnam listings.
• Trend monitoring — schedule a daily run and watch new supply enter the market.

How to use Nhatot Scraper

1. Open the Actor in Apify Console and go to the Input tab.
2. Choose a Listing type — For sale, For rent, or Both.
3. Pick the Property subcategories you want (apartments, houses, land, offices, rooms). All five are selected by default.
4. Optionally narrow the search with a keyword, a region/province, or a price range (VND).
5. Set Max items per subcategory (default 50) and leave enrichment on for the structured attributes.
6. Click Start. When the run finishes, open the Output tab and download the dataset in your preferred format.

Sale vs. rent (and Phòng trọ)

Nhatot separates for sale (Cần bán) from for rent (Cho thuê). One special case: Phòng trọ (Rooms) exist only as rentals — there are no for-sale rooms. If you select For sale together with only the Rooms subcategory, the Actor stops immediately with a clear error. When you scrape the default full set as For sale, Rooms is simply skipped with a warning. Choose For rent or Both to include rooms.

The rarer wanted ads (Cần mua / Cần thuê — posted by seekers, not sellers) are hidden behind the Include wanted ads toggle and are off by default.

Input

Field	Type	Default	Description
listingType	select: sale / rent / all	sale	For sale, for rent, or both.
includeWantedAds	boolean	false	Also scrape wanted-to-buy / wanted-to-rent ads.
subcategoryIds	multi-select	all five	Apartments (1010), Houses (1020), Land (1040), Offices (1030), Rooms (1050).
search	string	—	Full-text keyword (project name, street, ward…).
regionId	select	Any	Limit to a single of the 63 provinces.
priceFrom / priceTo	integer (VND)	—	Price range. Total price for sale; monthly for rent.
maxItems	integer	50	Number of ads to fetch per subcategory.
enrichDetails	boolean	true	Add structured property attributes (legal document, status, furnishing, price/m²) to every ad.

maxItems is a per-subcategory cap. With the default 50 and all five subcategories, a single run returns up to ~250 items. Increase it (or filter by region/price) for deeper backfills.

Output

Each dataset item looks like this (trimmed):

{
  "adId": 177585277,
  "listId": 133674683,
  "url": "https://www.chotot.com/133674683.htm",
  "title": "Bán căn hộ 2PN Vinhomes Grand Park",
  "price": 8500000000,
  "priceString": "8,5 tỷ",
  "propertyType": "Căn hộ/Chung cư",
  "listingType": "sale",
  "rooms": 2,
  "sizeM2": 98,
  "apartmentType": 1,
  "regionName": "Tp Hồ Chí Minh",
  "areaName": "Quận 7",
  "wardName": "Phường Tân Hưng",
  "latitude": 10.74506,
  "longitude": 106.69885,
  "images": ["https://cdn.chotot.com/....jpg"],
  "listedAt": "2026-08-02T03:49:45.000Z",
  "seller": { "id": 30397140, "name": "Seller", "liveAds": 5 },
  "legalDocument": "Sổ hồng riêng",
  "propertyStatus": "Đã bàn giao",
  "furnishing": "Nội thất đầy đủ",
  "pricePerM2": 86.73,
  "attributes": {
    "property_legal_document": "Sổ hồng riêng",
    "property_status": "Đã bàn giao",
    "furnishing_sell": "Nội thất đầy đủ",
    "price_m2": "86,73 triệu/m²",
    "rooms": "2 phòng",
    "size": "98 m²",
    "address": "..."
  }
}

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

Data fields

Field	Description
adId, listId	Ad and listing identifiers.
url	Stable chotot.com short URL for the ad.
title, description	Ad headline and full body text.
price, priceString	Numeric price (VND) and the display string (e.g. 8,5 tỷ).
propertyType	Apartment / house / land / office / room.
listingType	sale, rent, wanted_buy, or wanted_rent.
rooms, sizeM2, apartmentType	Bedrooms, area in m², apartment type code.
regionName, areaName, wardName	Province, district, ward.
latitude, longitude	GPS coordinates.
images, numberOfImages	Full-size photo URLs.
listedAt, relativeDate	ISO timestamp and the Vietnamese relative-time string.
seller	Seller id, name, avatar, and live-ad count.
legalDocument, propertyStatus, furnishing	Flattened key property attributes.
pricePerM2	Numeric price per m² (triệu VND/m²).
attributes	Full id → value map of labeled property attributes (when enriched).

The structured attributes — the headline feature

Generic scrapers hand you a wall of description text. This Actor decodes Nhatot's labeled real-estate attributes into clean fields. The three most-asked ones — legal document (Giấy tờ pháp lý), property status (Tình trạng BĐS), and furnishing (Nội thất) — are promoted to top-level columns, and pricePerM2 is parsed into a number you can sort and filter on. The complete set lives in the attributes map (toilets, block, apartment features, full address, and more).

How much does it cost to scrape Nhatot?

This Actor is pay-per-result. You are charged per listing delivered, plus a small add-on per item that is enriched with structured attributes. A typical enriched item costs roughly $2 per 1,000 items — real-estate data with decoded legal/furnishing/price-per-m² attributes. Turn enrichDetails off to skip the enrichment charge if you only need the basic listing. New Apify accounts include monthly free usage to try it out.

Because the property vertical is relatively compact, even a full enriched sweep is inexpensive and completes quickly — ideal for a scheduled daily refresh.

Tips & advanced options

• Limit cost — lower maxItems, deselect subcategories, or turn off enrichDetails.
• Deeper backfills — the Actor automatically splits dense subcategories by region, then district, then price band, so large result sets are collected reliably and completely. Filter by regionId or price to focus the crawl.
• Daily monitoring — schedule a run and dedupe downstream on listId to detect new supply.
• Advanced input — power users can pass extra district/ward geo-filters and a custom proxyConfiguration directly in the input JSON, even though they are not shown as form fields. A proxy is normally unnecessary.

FAQ, disclaimers & support

Is scraping Nhatot legal? This Actor collects only publicly available listing data and does not bypass logins or access private information. You are responsible for using the output in line with Nhatot's Terms of Service and applicable laws (including personal-data rules). Do not use the data for spam or unlawful purposes.

Why do the URLs point to chotot.com? Public ad URLs on chotot.com redirect to the canonical Nhatot page for the same listing. The short chotot.com URL is stable and always resolves, so it is the one stored.

Known limitations. The Actor does not return property project/development data, historical price trends, revealed phone numbers, or agency profiles — these are out of scope.

Feedback & issues. Found a bug or need an extra field? Open a ticket on the Issues tab. Custom scraping solutions are available on request.

Changelog

0.1

• Initial release: sale/rent/wanted filtering, five property subcategories, region and price filters, structured attribute enrichment (legal document, status, furnishing, price/m²), and automatic backfill of large result sets.