--- title: "Nhà Tốt API: Search | Perceptlayer" description: "Search from Nhà Tốt as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/nha-tot/search --- [APIs](https://perceptlayer.com/apis) / [Nhà Tốt](https://perceptlayer.com/apis/nha-tot) / Search # Nhà Tốt: Search Search from Nhà Tốt as JSON. 1 credit per successful call. GET `/v1/nha-tot/search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `for` | string | Required | sale, rent | | `category` | string | Optional | all, apartment, house, commercial, land, room | | `region_id` | integer | Optional | Any | | `district_id` | integer | Optional | Any | | `ward_id` | integer | Optional | Any | | `min_price` | integer | Optional | Any | | `max_price` | integer | Optional | Any | | `min_area` | integer | Optional | Any | | `max_area` | integer | Optional | Any | | `bedrooms` | integer | Optional | Any | | `bathrooms` | integer | Optional | Any | | `direction` | string | Optional | east, west, south, north, northeast, southeast, northwest, southwest, 1, 2, 3, 4, 5, 6, 7, 8 | | `legal_document` | string | Optional | pending\_book, deposit\_contract, sale\_contract, pink\_book, 2, 4, 5, 6 | | `apartment_type` | string | Optional | commercial, serviced\_mini, duplex, penthouse, collective, officetel, social\_housing, 1, 2, 3, 4, 5, 6, 7 | | `keyword` | string | Optional | Up to 100 characters | | `account_id` | integer | Optional | Any | | `project_oid` | string | Optional | Any | | `sort` | string | Optional | newest, price\_asc | | `page` | integer | Optional | Any | | `per_page` | integer | Optional | Any | ## Example request Nhà Tốt GET /v1/nha-tot/search?for=rent&category=apartment®ion\_id=13000&min\_price=5000000&max\_price=15000000&bedrooms=2&sort=price\_asc ``` { "success": true, "data": { "items": [ { "id": 134515945, "ad_id": 178572599, "url": "https://www.nhatot.com/134515945.htm", "title": "Cho thuê căn studio", "description": "Cho thuê căn hộ trung tâm Q.Bình Thạnh, căn studio riêng biệt được thiết kế tốt giản, ngăn nắp với 2 màu trắng và đen với đầy đủ công năng: 1 Phòng khách, 1PN + bang công, 1 bếp, 1 toilet, 1 gác lửng. Căn hộ căn góc, với nhiều cửa sổ lấy nắ…", "for": "rent", "status": "active", "category": { "id": 1010, "name": "Căn hộ/Chung cư" }, "price": { "amount": 5000000, "currency": "VND", "label": "5 triệu/tháng", "per_m2_million": 0.15151516, "original_amount": 4900000, "original_label": "4,9 triệu/tháng", "change": 100000, "deposit": 8000000, "is_price_valid": true }, "size": { "area_m2": 33, "unit": "m²" }, "rooms": { "bedrooms": 2, "bathrooms": 1 }, "details": { "legal_document": { "code": 6, "key": "pink_book", "label": "Sổ hồng riêng" }, "apartment_type": { "code": 1, "key": "commercial", "label": "Chung cư thương mại" }, "floor": 4, "furnishing_code": 2, "block": "H4", "unit_number": "502" }, "location": { "region": { "id": 13000, "name": "Tp Hồ Chí Minh", "name_v3": "TP Hồ Chí Minh" }, "district": { "id": 13109, "name": "Quận Bình Thạnh", "code": 109 }, "ward": { "id": 9282, "name": "Phường 26", "name_v3": "Phường Bình Thạnh" }, "street": "Đường số 1", "street_number": "502B Block H4", "latitude": 10.813185, "longitude": 106.708725 }, "project": {}, "media": { "thumbnail": "https://cdn.chotot.com/H3r48cFu1CveTwt8bpI3H5vhMgglNbGmWjgkCqT1vVE/preset:listing/plain/1f618f5b12dc9761997a5cd142c0484a-3000705681312158565.jpg", "images": [ "https://cdn.chotot.com/2hGC9Yia4v5GUTP9Iy8jOEF85sR2cVYEmw2qZKCPUIc/preset:view/plain/1f618f5b12dc9761997a5cd142c0484a-3000705681312158565.jpg", "https://cdn.chotot.com/gv8J_EG65PhlsW-XRbP1leljs-j8OPLZbtxMkFh5_LQ/preset:view/plain/f858b0d0642fe82f061c992bb0b85452-3000705680989767287.jpg", "https://cdn.chotot.com/M8pCyTxsS1ZL4RL0nB6cEmAAt5vDbPJ8_FBpGvFKg08/preset:view/plain/15407cbe7ccde3e7408b56f3cb283e7a-3000705681303317545.jpg" ], "image_count": 5, "has_video": false, "map_image": "https://cdn.chotot.com/admincentre/location/10x813985_106x709522_c_v2.jpg" }, "seller": { "account_id": 45621, "oid": "9f5f993a6303ad278083f58e47d5d5e9", "name": "Thich Đạt Dương", "avatar": "https://cdn.chotot.com/uac2/45621", "is_shop_verified": false, "live_ads": 1, "sold_ads": 31 }, "times": { "listed_at": "2026-10-13T14:38:04Z", "listed_at_epoch_ms": 1791902284000 }, "attributes": [ { "id": "property_legal_document", "label": "Giấy tờ pháp lý", "value": "Sổ hồng riêng" }, { "id": "apartment_type", "label": "Loại hình căn hộ", "value": "Chung cư thương mại" }, { "id": "furnishing_sell", "label": "Tình trạng nội thất", "value": "Nội thất đầy đủ" } ], "extra": { "apartment_feature": 1, "is_sticky": false, "job_tier": 0, "protection_entitlement": false, "pty_jupiter": 0, "sticky_ad_platinum": 0 } }, { "id": 135579595, "ad_id": 179821787, "url": "https://www.nhatot.com/135579595.htm", "title": "SHARE 1 PN thường trong căn 2PN2WC chung cư JAMILA KHANG ĐIỀN", "description": "Vào ở liền\n SHARE 1 PN thường trong căn 2PN2WC chung cư JAMILA KHANG ĐIỀN\nSong Hành, Phường Phú Hữu, Thủ Đức, Thành phố Hồ Chí Minh\nVị trí sát bên Quận 2, thuận tiện di chuyển, Q7, Q2, Q1 chạy thằng đường Song Hành ko lo kẹt xe\nThuê nguyên …", "for": "rent", "status": "active", "category": { "id": 1010, "name": "Căn hộ/Chung cư" }, "price": { "amount": 5000000, "currency": "VND", "label": "5 triệu/tháng", "per_m2_million": 0.06944445, "original_amount": 5000000, "original_label": "5 triệu/tháng", "change": 0, "deposit": 5000000, "is_price_valid": true }, "size": { "area_m2": 72, "unit": "m²" }, "rooms": { "bedrooms": 2, "bathrooms": 2 }, "details": { "legal_document": { "code": 5, "key": "sale_contract", "label": "Hợp đồng mua bán" }, "apartment_type": { "code": 1, "key": "commercial", "label": "Chung cư thương mại" }, "floor": 18, "block": "c", "unit_number": "18.01" }, "location": { "region": { "id": 13000, "name": "Tp Hồ Chí Minh", "name_v3": "TP Hồ Chí Minh" }, "district": { "id": 13119, "name": "Thành phố Thủ Đức", "code": 119 }, "ward": { "id": 9262, "name": "Phường Phú Hữu (Quận 9 cũ)", "name_v3": "Phường Long Trường" }, "street": "Song Hành", "latitude": 10.80134, "longitude": 106.74423 }, "project": { "id": 1327, "oid": "912892746", "name": "Jamila Khang Điền", "type": 1, "transaction_status": 0 }, "media": { "thumbnail": "https://cdn.chotot.com/J1KyhIFCLgcAq1PeKCqTb-atN9Sw0fkzXMqT8kPQDSY/preset:listing/plain/c94a46c44a80bd38b7692cddb07b53ab-3008932159793432852.jpg", "images": [ "https://cdn.chotot.com/CQ7FMbfzF80rmFtm274Y-c0JieSBGobwpCEwFI72DYU/preset:view/plain/c94a46c44a80bd38b7692cddb07b53ab-3008932159793432852.jpg", "https://cdn.chotot.com/RespjvmpsMDGHc9XxR15Tjw0-MsvDoCXB0GoNvkF90Q/preset:view/plain/232d8ec4984009191e7b3deff0fd4eb8-3008932159800695478.jpg", "https://cdn.chotot.com/zCKdU_NclNwj-W6rstViGq8dS7HUnaXNTzcxQf0NXBY/preset:view/plain/9b8da142e0ed394c4f50f4f536483d46-3008932159903842921.jpg" ], "image_count": 5, "has_video": false, "map_image": "https://cdn.chotot.com/admincentre/location/10x802140_106x745030_c_v2.jpg" }, "seller": { "account_id": 30315525, "oid": "ed10062d6e3373e3013c675215f1b5aa", "name": "Thu Hằng", "avatar": "https://cdn.chotot.com/uac2/30315525", "is_shop_verified": false, "live_ads": 1 }, "times": { "listed_at": "2026-10-31T16:16:36Z", "listed_at_epoch_ms": 1793463396994, "first_listed_at": "2026-10-31T16:16:36Z", "first_listed_at_epoch_ms": 1793463396000 }, "attributes": [ { "id": "property_legal_document", "label": "Giấy tờ pháp lý", "value": "Hợp đồng mua bán" }, { "id": "apartment_type", "label": "Loại hình căn hộ", "value": "Chung cư thương mại" }, { "id": "size", "label": "Diện tích sử dụng", "value": "72 m²" } ], "extra": { "is_sticky": false, "job_tier": 0, "protection_entitlement": false, "pty_jupiter": 0, "sticky_ad_platinum": 0 } }, { "id": 131028730, "ad_id": 174489849, "url": "https://www.nhatot.com/131028730.htm", "title": "Cho thuê căn hộ ( 1pn,2pn,3pn). Ngay thủ đức tiện di chuyển Q1,Q2,Q9.", "description": "Thông tin căn hộ.\n\n+ Căn 63m² (1PN+1, 1wc): 5tr Ntcb ( Rèm + tủ bếp trên dưới + máy nước nóng + full thiết bị wc) . Full nội thất : 6tr5\n\n+ Căn 73m² (2pn + 2wc): 6tr2 ( Rèm + tủ bếp trên dưới + máy nước nóng + full thiết bị wc) . Full nội t…", "for": "rent", "status": "active", "category": { "id": 1010, "name": "Căn hộ/Chung cư" }, "price": { "amount": 5000000, "currency": "VND", "label": "5 triệu/tháng", "per_m2_million": 0.07936508, "original_amount": 5000000, "original_label": "5 triệu/tháng", "change": 0, "is_price_valid": true }, "size": { "area_m2": 63, "unit": "m²" }, "rooms": { "bedrooms": 2, "bathrooms": 1 }, "details": { "legal_document": { "code": 6, "key": "pink_book", "label": "Sổ hồng riêng" }, "apartment_type": { "code": 1, "key": "commercial", "label": "Chung cư thương mại" } }, "location": { "region": { "id": 13000, "name": "Tp Hồ Chí Minh", "name_v3": "TP Hồ Chí Minh" }, "district": { "id": 13119, "name": "Thành phố Thủ Đức", "code": 119 }, "ward": { "id": 9260, "name": "Phường Long Trường (Quận 9 cũ)", "name_v3": "Phường Long Trường" }, "street": "Trường Lưu", "latitude": 10.79732, "longitude": 106.82337 }, "project": { "id": 4855, "oid": "1651557106", "name": "MT Eastmark City", "type": 1, "transaction_status": 1 }, "media": { "thumbnail": "https://cdn.chotot.com/Fk5kcoKhLLJ5Cfq72ymjO-DZciV9K-uMe8hlSCiNP8g/preset:listing/plain/e3a43a87c77cf0f4b486d81e25231728-2979870643871273557.jpg", "images": [ "https://cdn.chotot.com/e35fvVQUVGn2erIFE0DqO4ZRDSssLmcsDsutjhqgPuA/preset:view/plain/e3a43a87c77cf0f4b486d81e25231728-2979870643871273557.jpg", "https://cdn.chotot.com/vRRUZ_8QF-YipFcDKPMISVsgMkXAnZWLhHsbMZxV_aY/preset:view/plain/7437412371bf39f88f503f91ab1711c5-2979870643975110489.jpg", "https://cdn.chotot.com/WzmY373O_N1BLUYUsSo8UywggmR0jGftKDkccVwxJuw/preset:view/plain/f1b4f4edbcac1ca565d593e87369ddcd-2979870644160608207.jpg" ], "image_count": 9, "has_video": false, "map_image": "https://cdn.chotot.com/admincentre/location/10x798120_106x824170_c_v2.jpg" }, "seller": { "account_id": 19689747, "oid": "1609dc550c93cde545b5c9f6e5ff1b52", "name": "ho van thọ", "avatar": "https://cdn.chotot.com/uac2/19689747", "is_shop_verified": false, "is_company": true, "rating": 4, "rating_count": 4, "ad_rating": 4, "ad_rating_count": 4, "live_ads": 13, "sold_ads": 48 }, "times": { "listed_at": "2026-11-09T03:22:52Z", "listed_at_epoch_ms": 1794194572137, "first_listed_at": "2026-11-06T13:51:40Z", "first_listed_at_epoch_ms": 1793973100000 }, "attributes": [ { "id": "property_legal_document", "label": "Giấy tờ pháp lý", "value": "Sổ hồng riêng" }, { "id": "apartment_type", "label": "Loại hình căn hộ", "value": "Chung cư thương mại" }, { "id": "size", "label": "Diện tích sử dụng", "value": "63 m²" } ], "extra": { "apartment_feature": 0, "is_sticky": false, "job_tier": 0, "protection_entitlement": true, "pty_jupiter": 0, "sticky_ad_platinum": 0 } } ], "page": 1, "per_page": 20, "total": 2967, "total_pages": 149, "has_more": true }, "meta": { "endpoint_family": "search", "request_id": "req_9ce7bf4cfd6447abaf547edb79cfcfaa", "credits_charged": 1, "credits_remaining": 1838 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. [Run this endpoint in the playground](https://perceptlayer.com/apis/nha-tot?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.