# 周边二手房

# 接口介绍

接口信息

接口 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 评估价

copyright © 2021 北京中指宏远数据信息技术有限公司 Beijing Zhong Zhi Hong Yuan Data Information Technology Co.,Ltd 版权所有

京 ICP备 18037826号-5