# 项目搜索
# 接口介绍
接口信息
接口 ID：2001
接口名称：项目搜索
接口类型：数据获取
接口URL：
HTTP请求方式： POST
授权方式：
接口介绍：
1.根据城市查询符合条件的项目列表；
2.支持按照区县、用物业类型、交易状态、时间，多种条件进行查询；
3.最大返回500条。
# 升级版本
版本记录
当前接口无升级版本
# 请求参数：
请求参数
| 参数名称 | 是否必填 | 类型 | 参数说明 |
|---|---|---|---|
| cityId | 是 | string | 城市ID，取自城市字典，支持单一城市查询 |
| industryDistrictIdList | 否，默认全部区县 | string | 区县ID，取自区县字典，支持多个区县查询 |
| projectName | 否，默认为空 | string | 楼盘名称，模糊查询 |
| category | 否，默认全部类型 | string | 物业类型[住宅：2，商铺：4，写字楼：5]，支持多类型调取 |
| saleStatusId | 否，默认全部状态 | string | 销售状态[0=待售,1=在售,2=售罄]，支持多状态调取 |
| beginDate | 否，默认全部日期 | string | 开盘时间统计开始日期，yyyy-MM-dd |
| endDate | 否，默认全部日期 | string | 开盘时间统计结束日期，yyyy-MM-dd |
| pageSize | 是 | integer | 每页条数，传参为小于或等于100的整数 |
| pageNum | 是 | integer | 当前页数，传参应小于或等于数据总页数 |
# 返回结果：
JSON示例
{
"meta": {
"code": 1,
"message": null,
"structure": 1,
"encrypted": false,
"cached": false
},
"data": {
"totalCount": 500,
"houseSearchBaseDtoList": [
{
"instalmentId": "defa6fd8-d0d4-4452-8d57-5b8ccb256838",
"buildingType": "新房",
"projName": "海淀幸福里生活馆",
"houseAddress": "西北旺镇，北清路和京新高速交叉口西侧约1.5公里",
"houseType": "住宅",
"saleStatus": "待售",
"newcode": "1010128601"
},
{
"instalmentId": "db5847e3-62e7-4467-b551-8c688b2b0968",
"buildingType": "新房",
"projName": "伊甸园·edenbox山里屯",
"houseAddress": "盘山风景区东，蓟州燕山西大街北",
"houseType": "住宅",
"saleStatus": "待售",
"newcode": "1010128555"
},
{
"instalmentId": "02cbfc71-4aa1-4909-8a84-064a06deb277",
"buildingType": "新房",
"projName": "涿州隆基泰和旗舰店",
"houseAddress": "涿州市长空路与龙马路交叉口",
"houseType": "住宅",
"saleStatus": "在售",
"newcode": "1010124035"
},
{
"instalmentId": "102b0b1f-78ef-4711-9c66-97432ecd60a0",
"buildingType": "新房",
"projName": "诺德逸府",
"houseAddress": "樊羊路与六圈南路交汇处往南50米",
"houseType": "住宅",
"saleStatus": "在售",
"newcode": "1010127167"
},
{
"instalmentId": "1bbdb7ab-83ae-456c-b241-ae3e00375e64",
"buildingType": "新房",
"projName": "华贸铂金墅",
"houseAddress": "清苑路（华贸天地北侧）",
"houseType": "别墅",
"saleStatus": "待售",
"newcode": "1010706035"
}
]
}
}
# 参数说明：
参数说明
| 参数名 | 描述 |
|---|---|
| data | 返回查询结果，没有匹配记录则返回为空，具体字段含义见下表 |
| meta | 返回值描述 |
| code | 返回码.1为成功,http状态码为统一http请求错误,其他5位状态码为自定义错误码 |
| message | 消息 |
字段说明：
| 返回值字段 | 类型 | 说明 | 描述 |
|---|---|---|---|
| totalCount | integer | 结果数量 | |
| HouseSearchBaseDtoList | array | 楼盘信息 | |
| instalmentId | string | 楼盘ID | |
| projName | string | 项目名称 | |
| houseAddress | string | 楼盘地址 | |
| houseType | string | 物业类型 | |
| saleStatus | string | 销售状态[0待售，1在售，2售罄] | |
| buildingType | string | 楼盘类型，新房或二手房描述 |