{
  "openapi": "3.0.0",
  "info": {
    "title": "Beike Resale Housing List API (V1)",
    "version": "1.0.0",
    "description": "Get Beike resale Housing List data, including - Supports filtering by city/region, price range, and layout, for building search result pages for property portals and aggregating market data for regional housing trends."
  },
  "paths": {
    "/api/beike/get-ershoufang-list/v1": {
      "get": {
        "tags": [
          "Beike"
        ],
        "summary": "Resale Housing List",
        "description": "Get Beike resale Housing List data, including - Supports filtering by city/region, price range, and layout, for building search result pages for property portals and aggregating market data for regional housing trends.",
        "operationId": "getErshoufangListV1",
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "description": "User authentication token.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cityId",
            "in": "query",
            "description": "The ID of the city (e.g., '110000' for Beijing).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "condition",
            "in": "query",
            "description": "Filter conditions (e.g., region, price range, layout).",
            "required": false,
            "schema": {
              "type": "string",
              "default": ""
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Pagination offset, starting from 0 (e.g., 0, 20, 40...).",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          }
        ],
        "responses": {
          "default": {
            "description": "default response",
            "content": {
              "application/json": {
                "example": {
                  "code": 0,
                  "data": {
                    "request_id": "dd9a1e0e-1bc0-11f1-8335-ba5e53120619",
                    "uniqid": "1055-5AE4-9BAD-7E42-6B9B97F1E7C3",
                    "errno": 0,
                    "error": "",
                    "data": {
                      "totalCount": 0,
                      "noResultNearHouse": 0,
                      "returnCount": 0,
                      "hasMoreData": 0,
                      "headerList": [
                        {
                          "filters": {
                            "checkFilters": {
                              "region": {
                                "name": "区域",
                                "type": 0,
                                "options": [
                                  {
                                    "name": "区域",
                                    "itemType": "district",
                                    "type": 0,
                                    "alias": "d",
                                    "options": [
                                      {
                                        "name": "不限",
                                        "type": 0,
                                        "options": [
                                          {
                                            "name": "不限"
                                          }
                                        ]
                                      }
                                    ]
                                  }
                                ]
                              },
                              "price": {
                                "name": "价格",
                                "itemType": "totalPrice",
                                "type": 1,
                                "alias": "p",
                                "range": {
                                  "name": "自定义价格",
                                  "min": {
                                    "name": "最低总价",
                                    "key": "bp"
                                  },
                                  "max": {
                                    "name": "最高总价",
                                    "key": "ep"
                                  },
                                  "slide": {
                                    "length": 10000000,
                                    "step": 100000,
                                    "minText": "0元",
                                    "maxText": "1000万以上"
                                  },
                                  "rangeUnit": {
                                    "default": "万",
                                    "less": "万以下",
                                    "more": "万以上"
                                  },
                                  "rangeUnitLow": {
                                    "default": "元",
                                    "less": "元以下",
                                    "more": "元以上"
                                  }
                                },
                                "options": [
                                  {
                                    "name": "200万以下",
                                    "id": 1,
                                    "key": "p1",
                                    "left": 0,
                                    "right": 2000000
                                  }
                                ]
                              },
                              "room": {
                                "name": "房型",
                                "itemType": "room_count",
                                "type": 1,
                                "alias": "l",
                                "options": [
                                  {
                                    "name": "一室",
                                    "id": 1,
                                    "key": "l1"
                                  }
                                ]
                              },
                              "area": {
                                "name": "建筑面积",
                                "itemType": "house_area",
                                "type": 1,
                                "alias": "a",
                                "range": {
                                  "name": "自定义建筑面积",
                                  "min": {
                                    "name": "最小",
                                    "key": "ba"
                                  },
                                  "max": {
                                    "name": "最大",
                                    "key": "ea"
                                  },
                                  "slide": {
                                    "length": 200,
                                    "step": 5,
                                    "minText": "0㎡",
                                    "maxText": "200㎡以上"
                                  },
                                  "rangeUnit": {
                                    "default": "㎡",
                                    "less": "㎡以下",
                                    "more": "㎡以上"
                                  }
                                },
                                "options": [
                                  {
                                    "name": "50㎡以下",
                                    "id": 1,
                                    "key": "a1",
                                    "left": 0,
                                    "right": 50
                                  }
                                ]
                              },
                              "more": {
                                "name": "更多",
                                "type": 1,
                                "options": [
                                  {
                                    "name": "建筑面积",
                                    "itemType": "house_area",
                                    "type": 1,
                                    "alias": "a",
                                    "range": {
                                      "name": "自定义建筑面积",
                                      "min": {
                                        "name": "最小",
                                        "key": "ba"
                                      },
                                      "max": {
                                        "name": "最大",
                                        "key": "ea"
                                      },
                                      "slide": {
                                        "length": 200,
                                        "step": 5,
                                        "minText": "0㎡",
                                        "maxText": "200㎡以上"
                                      },
                                      "rangeUnit": {
                                        "default": "㎡",
                                        "less": "㎡以下",
                                        "more": "㎡以上"
                                      }
                                    },
                                    "options": [
                                      {
                                        "name": "50㎡以下",
                                        "id": 1,
                                        "key": "a1",
                                        "left": 0,
                                        "right": 50
                                      }
                                    ]
                                  }
                                ]
                              },
                              "soldMore": {
                                "name": "建筑面积",
                                "type": 1,
                                "options": [
                                  {
                                    "name": "建筑面积",
                                    "itemType": "house_area",
                                    "type": 1,
                                    "alias": "a",
                                    "range": {
                                      "name": "自定义建筑面积",
                                      "min": {
                                        "name": "最小",
                                        "key": "ba"
                                      },
                                      "max": {
                                        "name": "最大",
                                        "key": "ea"
                                      },
                                      "slide": {
                                        "length": 200,
                                        "step": 5,
                                        "minText": "0㎡",
                                        "maxText": "200㎡以上"
                                      },
                                      "rangeUnit": {
                                        "default": "㎡",
                                        "less": "㎡以下",
                                        "more": "㎡以上"
                                      }
                                    },
                                    "options": [
                                      {
                                        "name": "50㎡以下",
                                        "id": 1,
                                        "key": "a1",
                                        "left": 0,
                                        "right": 50
                                      }
                                    ]
                                  }
                                ]
                              }
                            },
                            "sortFilters": [
                              {
                                "name": "默认排序"
                              }
                            ],
                            "listFilters": [
                              {
                                "name": "满五年",
                                "id": 1,
                                "key": "mw1"
                              }
                            ]
                          },
                          "itemKey": "filters"
                        }
                      ],
                      "houseTooFew": 0,
                      "subscribe": 0
                    },
                    "cost": 58
                  }
                }
              }
            }
          }
        },
        "x-order": "32001100"
      }
    }
  },
  "components": {}
}