--- title: "Batdongsan.com.vn API: Search | Perceptlayer" description: "Search from Batdongsan.com.vn as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/batdongsan/search --- [APIs](https://perceptlayer.com/apis) / [Batdongsan.com.vn](https://perceptlayer.com/apis/batdongsan) / Search # Batdongsan.com.vn: Search Search from Batdongsan.com.vn as JSON. 1 credit per successful call. GET `/v1/batdongsan/search` ## Parameters Send parameters in the query string. | Parameter | Type | Required | Allowed values | | --- | --- | --- | --- | | `listing_type` | string | Optional | sale, rent | | `city` | string | Required | AG, BD, BDD, BG, BK, BL, BN, BP, BTH, BTR, CB, CM, CT, DDB, DDL, DDN, DDT, DNA, DNO, GL, HB, HD, HG, HGI, HN, HNA, HP, HT, HY, KG, KH, KT, LA, LCA, LCH, LDD, LS, NA, NB, NDD, NT, PT, PY, QB, QNA, QNG, QNI, QT, SG, SL, ST, TB, TG, TH, TN, TNI, TQ, TTH, TV, VL, VP, VT, YB | | `category` | string | Optional | Any | | `min_price` | number | Optional | Any | | `max_price` | number | Optional | Any | | `min_area` | number | Optional | Any | | `max_area` | number | Optional | Any | | `bedrooms` | string | Optional | Any | | `bathrooms` | string | Optional | Any | | `frontage_width` | integer | Optional | 1, 2, 3, 4, 5, 6 | | `road_width` | integer | Optional | 1, 2, 3, 4, 5, 6 | | `location_id` | string | Optional | Any | | `location_type` | string | Optional | street, district, project, ward | | `verified` | boolean | Optional | Any | | `pro_agent` | boolean | Optional | Any | | `sort` | string | Optional | default, verified, price\_asc, price\_desc, price\_per\_m2\_asc, price\_per\_m2\_desc, area\_asc, area\_desc | | `page` | integer | Optional | Any | | `per_page` | integer | Optional | Any | | `legality` | string | Optional | Any | | `interior` | string | Optional | Any | | `floors` | string | Optional | Any | | `direction` | string | Optional | Any | | `balcony_direction` | string | Optional | Any | ## Example request Batdongsan.com.vn GET /v1/batdongsan/search?listing\_type=sale&city=HN&min\_area=50&max\_area=60&bedrooms=2&bathrooms=2&sort=price\_asc ``` { "success": true, "data": { "applied_filters": { "listing_type": "sale", "city": "HN", "min_area": "50", "max_area": "60", "bedrooms": "2", "bathrooms": "2", "sort": "price_asc" }, "pagination": { "page": 1, "per_page": 20, "total": 546, "total_pages": 28, "returned": 13, "has_next_page": true }, "items": [ { "id": 46479967, "url": "https://batdongsan.com.vn/ban-can-ho-chung-cu-duong-to-huu-mhd-trung-van/re-nhat-du-an-ban-2-ngu-2wc-tai-gia-1-950-ty-lh-pr46479967", "title": "(Rẻ nhất dự án) Bán căn 2 phòng ngủ 2wc tại MHD Trung Văn giá 1.650 tỷ. LH", "category": { "id": 324, "name": "Bán căn hộ chung cư" }, "listing_type": "sale", "price": { "value_vnd": 1650000000, "display": "1,65 tỷ", "unit_display": "33 tr/m²", "unit_id": 2 }, "area": 50, "bedrooms": 2, "bathrooms": 2, "address": { "full": "MHD Trung Văn, Đường Tố Hữu, Phường Trung Văn, Quận Nam Từ Liêm, Hà Nội", "city_level": "Nam Từ Liêm, Hà Nội", "district_level": "Trung Văn, Nam Từ Liêm", "short": "Q. Nam Từ Liêm (P. Đại Mỗ mới)" }, "location": { "city_code": "HN", "city_name": "Hà Nội", "ward_id": 23563, "ward_name": "Phường Đại Mỗ", "street_id": 3151, "street_name": "Đường Tố Hữu", "project_id": 4699, "project_name": "MHD Trung Văn", "address": "MHD Trung Văn, Đường Tố Hữu, Phường Đại Mỗ, Hà Nội" }, "old_location": { "district_id": 14, "district_name": "Quận Nam Từ Liêm", "city_code": "HN", "city_name": "Hà Nội", "ward_id": 11381, "ward_name": "Phường Trung Văn", "street_id": 3151, "street_name": "Đường Tố Hữu", "project_id": 4699, "project_name": "MHD Trung Văn", "address": "MHD Trung Văn, Đường Tố Hữu, Phường Trung Văn, Quận Nam Từ Liêm, Hà Nội" }, "images": [ { "url": "https://file4.batdongsan.com.vn/2026/10/29/20261029095512-25e7_wm.jpg", "crop_url": "https://file4.batdongsan.com.vn/resize/492x273/2026/10/29/20261029095512-25e7_wm.jpg", "thumb_url": "https://file4.batdongsan.com.vn/resize/745x510/2026/10/29/20261029095512-25e7_wm.jpg" }, { "url": "https://file4.batdongsan.com.vn/2026/10/29/20261029095512-0167_wm.jpg", "crop_url": "https://file4.batdongsan.com.vn/resize/492x273/2026/10/29/20261029095512-0167_wm.jpg", "thumb_url": "https://file4.batdongsan.com.vn/resize/745x510/2026/10/29/20261029095512-0167_wm.jpg" }, { "url": "https://file4.batdongsan.com.vn/2026/10/29/20261029095512-3496_wm.jpg", "crop_url": "https://file4.batdongsan.com.vn/resize/492x273/2026/10/29/20261029095512-3496_wm.jpg", "thumb_url": "https://file4.batdongsan.com.vn/resize/745x510/2026/10/29/20261029095512-3496_wm.jpg" } ], "media_count": 13, "description": "Bán gấp căn 2 phòng ngủ 2wc tại MHD Trung Văn!\n\nTòa A MHD Trung Văn.\n50m | 2PN | 2WC.\nFull nội thất đẹp như ảnh vào ở ngay!\nThời hạn 40 năm tính từ 2026.\nCam kết nhà thật giá thật.\n\nGiá chỉ 1,650 tỷ căn 2 ngủ diện tích đẹp, vị trí thuận lợi…", "vip": { "id": 5, "name": "Thường" }, "verified": { "is_verified": false }, "is_expired": false, "last_up_time": "2026-11-07T20:26:50.885+00:00", "posted_label": "5 ngày trước", "author": { "id": 1813345, "name": "Lê Dương", "avatar_url": "https://file4.batdongsan.com.vn/resize/200x200/2024/06/26/20240626145836-18e9.jpg", "phone_masked": "0971516***", "profile_url": "https://guru.batdongsan.com.vn/pa/923cbf4a118c5b69", "agent_id": "923cbf4a118c5b69", "is_pro_agent": true } }, { "id": 46479261, "url": "https://batdongsan.com.vn/ban-can-ho-chung-cu-phuong-hoang-liet-hh2-linh-dam/hh-am-56m2-1-7-ty-tang-toa-an-toan-pr46479261", "title": "HH2 Linh Đàm - 56m2 - 1,7 tỷ - Tầng, tòa an toàn", "category": { "id": 324, "name": "Bán căn hộ chung cư" }, "listing_type": "sale", "price": { "value_vnd": 1700000000, "display": "1,7 tỷ", "unit_display": "30,36 tr/m²", "unit_id": 2 }, "area": 56, "bedrooms": 2, "bathrooms": 2, "address": { "full": "HH2 Linh Đàm, Phường Hoàng Liệt, Quận Hoàng Mai, Hà Nội", "city_level": "Hoàng Mai, Hà Nội", "district_level": "Hoàng Liệt, Hoàng Mai", "short": "Q. Hoàng Mai (P. Hoàng Liệt mới)" }, "location": { "city_code": "HN", "city_name": "Hà Nội", "ward_id": 4363, "ward_name": "Phường Hoàng Liệt", "project_id": 2319, "project_name": "HH2 Linh Đàm", "address": "HH2 Linh Đàm, Phường Hoàng Liệt, Hà Nội" }, "old_location": { "district_id": 8, "district_name": "Quận Hoàng Mai", "city_code": "HN", "city_name": "Hà Nội", "ward_id": 9484, "ward_name": "Phường Hoàng Liệt", "project_id": 2319, "project_name": "HH2 Linh Đàm", "address": "HH2 Linh Đàm, Phường Hoàng Liệt, Quận Hoàng Mai, Hà Nội" }, "images": [ { "url": "https://file4.batdongsan.com.vn/2026/10/29/20261029083548-519e_wm.jpg", "crop_url": "https://file4.batdongsan.com.vn/resize/492x273/2026/10/29/20261029083548-519e_wm.jpg", "thumb_url": "https://file4.batdongsan.com.vn/resize/745x510/2026/10/29/20261029083548-519e_wm.jpg" }, { "url": "https://file4.batdongsan.com.vn/2026/10/29/20261029083548-dac5_wm.jpg", "crop_url": "https://file4.batdongsan.com.vn/resize/492x273/2026/10/29/20261029083548-dac5_wm.jpg", "thumb_url": "https://file4.batdongsan.com.vn/resize/745x510/2026/10/29/20261029083548-dac5_wm.jpg" }, { "url": "https://file4.batdongsan.com.vn/2026/10/29/20261029083548-13db_wm.jpg", "crop_url": "https://file4.batdongsan.com.vn/resize/492x273/2026/10/29/20261029083548-13db_wm.jpg", "thumb_url": "https://file4.batdongsan.com.vn/resize/745x510/2026/10/29/20261029083548-13db_wm.jpg" } ], "media_count": 4, "description": "HH2 Linh Đàm - 56m2 - 1,7 tỷ - Tầng, tòa an toàn\n56m2 - 2PN 2VS\nCửa Bắc, ban công Tây Nam\nGiá 1,7 tỷ\nNhà full đồ 3 ĐH, trần, sàn, máy giặt, tủ lạnh, giường, tủ...\nLiên hệ Hương", "vip": { "id": 5, "name": "Thường" }, "verified": { "is_verified": false }, "is_expired": false, "last_up_time": "2026-10-29T08:36:35.087+00:00", "posted_label": "2 tuần trước", "author": { "id": 4773659, "name": "Thu Hương BĐS", "avatar_url": "https://file4.batdongsan.com.vn/resize/200x200/2026/10/29/20261029081922-a901.jpg", "phone_masked": "0392731***", "profile_url": "https://guru.batdongsan.com.vn/pa/744730857936586b", "agent_id": "744730857936586b", "is_pro_agent": false } }, { "id": 45565972, "url": "https://batdongsan.com.vn/ban-can-ho-chung-cu-xa-dai-thinh-chung-cu-rosa-garden/ban-cc-gia-thoa-thuan-54m2-2pn-2wc-me-linh-ha-noi-pr45565972", "title": "Bán chung cư Rosa Garden HUD Mê Linh Central, 54m2, 2PN, 2WC full đồ cho thuê được 7 triệu/tháng", "category": { "id": 324, "name": "Bán căn hộ chung cư" }, "listing_type": "sale", "price": { "value_vnd": 1950000000, "display": "1,95 tỷ", "unit_display": "36,11 tr/m²", "unit_id": 2 }, "area": 54, "bedrooms": 2, "bathrooms": 2, "address": { "full": "Chung cư Rosa Garden, Xã Đại Thịnh, Huyện Mê Linh, Hà Nội", "city_level": "Mê Linh, Hà Nội", "district_level": "Đại Thịnh, Mê Linh", "short": "H. Mê Linh (X. Quang Minh mới)" }, "location": { "city_code": "HN", "city_name": "Hà Nội", "ward_id": 8971, "ward_name": "Xã Quang Minh", "project_id": 5196, "project_name": "Chung cư Rosa Garden", "address": "Chung cư Rosa Garden, Xã Quang Minh, Hà Nội" }, "old_location": { "district_id": 17, "district_name": "Huyện Mê Linh", "city_code": "HN", "city_name": "Hà Nội", "ward_id": 10167, "ward_name": "Xã Đại Thịnh", "project_id": 5196, "project_name": "Chung cư Rosa Garden", "address": "Chung cư Rosa Garden, Xã Đại Thịnh, Huyện Mê Linh, Hà Nội" }, "images": [ { "url": "https://file4.batdongsan.com.vn/2026/09/22/20260922170634-c016_wm.jpg", "crop_url": "https://file4.batdongsan.com.vn/resize/492x273/2026/09/22/20260922170634-c016_wm.jpg", "thumb_url": "https://file4.batdongsan.com.vn/resize/745x510/2026/09/22/20260922170634-c016_wm.jpg" }, { "url": "https://file4.batdongsan.com.vn/2026/09/22/20260922170634-32e8_wm.jpg", "crop_url": "https://file4.batdongsan.com.vn/resize/492x273/2026/09/22/20260922170634-32e8_wm.jpg", "thumb_url": "https://file4.batdongsan.com.vn/resize/745x510/2026/09/22/20260922170634-32e8_wm.jpg" }, { "url": "https://file4.batdongsan.com.vn/2026/09/22/20260922170634-c5b2_wm.jpg", "crop_url": "https://file4.batdongsan.com.vn/resize/492x273/2026/09/22/20260922170634-c5b2_wm.jpg", "thumb_url": "https://file4.batdongsan.com.vn/resize/745x510/2026/09/22/20260922170634-c5b2_wm.jpg" } ], "media_count": 3, "description": "Bán chung cư Rosa Garden HUD Mê Linh Central diện tích 54m2, 2PN, 2WC full đồ cho thuê được 7 triệu/tháng và đối diện dự án Khu đô thị 205 hecta của Sungroup. Với diện tích 54m2, căn hộ này được thiết kế gồm 2 phòng ngủ và 2 phòng tắm, phù …", "vip": { "id": 5, "name": "Thường" }, "verified": { "is_verified": false }, "is_expired": false, "last_up_time": "2026-11-08T13:01:07.12+00:00", "posted_label": "4 ngày trước", "author": { "id": 813620, "name": "Nguyễn Văn Đạt", "avatar_url": "https://file4.batdongsan.com.vn/resize/200x200/2025/05/07/20250507102248-d4f5.jpg", "phone_masked": "0937827***", "profile_url": "https://guru.batdongsan.com.vn/pa/f64a3999b9ff94da", "agent_id": "f64a3999b9ff94da", "is_pro_agent": true } } ] }, "meta": { "filtered_out": 7, "endpoint_family": "search", "request_id": "req_eb2bd3de9cec40779b5530799228ad15", "credits_charged": 1, "credits_remaining": 1891 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. [Run this endpoint in the playground](https://perceptlayer.com/apis/batdongsan?try=search#playground) with your own parameters. 1 credit per successful call; failed calls are free.