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 OKJSONX-Credits-Used: 1

Recorded from our API and shortened.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.