# 周边二手房
# 接口介绍
接口信息
接口 ID：3003
接口名称：周边二手房
接口类型：数据获取
接口URL：
HTTP请求方式： POST
授权方式：
接口介绍：
1.目前支持输入经纬度坐标，获取半径范围内，二手房楼盘的基本信息、市场交易数据；
2.可查询城市范围根据字典进行提供，半径范围最大5公里；
3.二手房楼盘展示历史全时间范围的楼盘；
4.单次查询最大返回500条结果；
5.适用于针对项目做可行性研究和经营管理，以坐标点为核心，全面了解周边楼盘详细数据。
# 升级版本
版本记录
当前接口无升级版本
# 请求参数：
请求参数
| 参数名称 | 是否必填 | 类型 | 参数说明 |
|---|---|---|---|
| cityId | 是 | string | 城市ID，取自城市字典，支持单一城市查询 |
| coordinateType | 否，默认高德 | string | 坐标类型(坐标类型[百度:bd09高德:gcj02,默认为高德]) |
| lng | 是 | string | 经度，精确到小数点后6位 |
| lat | 是 | string | 纬度，精确到小数点后6位 |
| radius | 是 | integer | 半径（米），最大不超过5000米 |
| category | 否，默认全部类型 | string | 物业类型（住宅：2，商铺：4，写字楼：5），支持多类型同时查询 |
| scompleteDate | 否，默认全部时间 | string | 楼龄（5年以内：1,5-10年：2,10-20年：3,20年以上：4） |
| beginDate | 否，默认为全部日期 | string | 开盘时间统计开始节点 |
| endDate | 否，默认为全部日期 | string | 开盘时间统计结束节点 |
| pageSize | 是 | integer | 每页条数，传参为小于100的整数 |
| pageNum | 是 | integer | 当前页数，传参应小于或等于数据总页数 |
# 返回结果：
JSON示例
{
"meta": {
"code": 1,
"message": null,
"structure": 1,
"encrypted": false,
"cached": false
},
"data": {
"totalCount": 500,
"circumEsfHouseBaseSearchDtoList": [
{
"projectName": "金鹿大楼",
"instalmentId": "24ad5741-6624-4fcc-88e5-d83aa8d8a256",
"houseAddress": "巨鹿路1号、巨鹿路17号",
"totalDoorNum": 378,
"buildYear": "1994-01-01",
"buildingCategory": "板楼",
"buildStructure": "钢混",
"openDate": "",
"scompleteDate": "1994-01-01",
"livinDate": "",
"developer": "",
"lng": "121.475502",
"lat": "31.229387",
"esfNewcodePriceDtoList": [
{
"dateMonth": "2020-07",
"housePgPrice": "85362"
},
{
"dateMonth": "2020-06",
"housePgPrice": "84755"
},
{
"dateMonth": "2020-05",
"housePgPrice": "82401"
},
{
"dateMonth": "2020-04",
"housePgPrice": "79841"
},
{
"dateMonth": "2020-03",
"housePgPrice": "77032"
},
{
"dateMonth": "2020-02",
"housePgPrice": "81173"
}
]
},
{
"projectName": "老重庆中路新里",
"instalmentId": "8b0b1652-ec40-4079-9f73-3b59453f7042",
"houseAddress": "老重庆中路64弄",
"totalDoorNum": 0,
"buildYear": "1942-01-01",
"buildingCategory": "板楼",
"buildStructure": "砖混",
"openDate": "",
"scompleteDate": "1942-01-01",
"livinDate": "",
"developer": "",
"lng": "121.476540",
"lat": "31.227987",
"esfNewcodePriceDtoList": [
{
"dateMonth": "2020-07",
"housePgPrice": "104763"
},
{
"dateMonth": "2020-06",
"housePgPrice": "103726"
},
{
"dateMonth": "2020-05",
"housePgPrice": "102699"
},
{
"dateMonth": "2020-04",
"housePgPrice": "101682"
},
{
"dateMonth": "2020-03",
"housePgPrice": "100675"
},
{
"dateMonth": "2020-02",
"housePgPrice": "99678"
}
]
},
{
"projectName": "康绥公寓",
"instalmentId": "0b59e9c2-0770-4b5e-8a90-89457d285b1f",
"houseAddress": "淮海中路494弄",
"totalDoorNum": 180,
"buildYear": "1949-01-01",
"buildingCategory": "板楼",
"buildStructure": "砖混",
"openDate": "",
"scompleteDate": "1949-01-01",
"livinDate": "",
"developer": "",
"lng": "121.476097",
"lat": "31.227457",
"esfNewcodePriceDtoList": [
{
"dateMonth": "2020-07",
"housePgPrice": "145550"
},
{
"dateMonth": "2020-06",
"housePgPrice": "143807"
},
{
"dateMonth": "2020-05",
"housePgPrice": "154651"
},
{
"dateMonth": "2020-04",
"housePgPrice": "142879"
},
{
"dateMonth": "2020-03",
"housePgPrice": "141647"
},
{
"dateMonth": "2020-02",
"housePgPrice": "148751"
}
]
}
]
}
}
# 参数说明：
参数说明
| 参数名 | 描述 |
|---|---|
| data | 返回查询结果，没有匹配记录则返回为空，具体字段含义见下表 |
| meta | 返回值描述 |
| code | 返回码.1为成功,http状态码为统一http请求错误,其他5位状态码为自定义错误码 |
| message | 消息 |
字段说明：
| 返回值字段 | 类型 | 说明 | 描述 |
|---|---|---|---|
| totalCount | integer | 结果数量 | |
| CircumEsfHouseBaseSearchDtoList | array | 二手房项目 | |
| projectName | string | 楼盘名称 | |
| instalmentId | string | 楼盘ID | |
| lng | string | 经度，会根据入参"coordinateType"字段进行返回 | |
| lat | string | 纬度，会根据入参"coordinateType"字段进行返回 | |
| cityName | string | 城市名称 | |
| cityId | string | 城市ID | |
| districtName | string | 区县名称 | |
| industryDistrictId | string | 区县ID | |
| houseAddress | string | 楼盘地址 | |
| buildYear | string | 建筑年代 | |
| buildingCategory | string | 建筑类别 | |
| buildStructure | string | 建筑结构 | |
| livinDate | string | 入住时间 | |
| openDate | string | 开盘时间 | |
| scompleteDate | string | 竣工时间 | |
| totalDoorNum | string | 小区户数 | |
| developer | string | 开发商 | |
| EsfHouseDealDataDtoList | Array | 交易数据 | |
| dateMonth | string | 月份 | |
| housePgPrice | string | 评估价 |