# 地块搜索

# 接口介绍

接口信息

接口 ID:1001

接口名称:土地搜索

接口类型:数据获取

接口URL

HTTP请求方式: POST

授权方式

接口介绍

1.根据城市查询符合条件的土地列表;

2.支持按照区县、用地性质、成交状态、时间多种条件进行查询;

3.返回近三年土地数据,最大返回500条。

# 升级版本

版本记录

当前接口无升级版本

# 请求参数

请求参数

参数名称 是否必填 类型 参数说明
cityCode string 城市Code,取自土地城市字典,支持单一城市查询
districtCodeList 否,默认为全部区县 string 区县Code,取自区县字典,支持多个区县查询
landName 否,默认为空 string 地块名称,模糊查询
landSn 否,默认为空 string 地块编号,模糊查询
landNature 否,默认为全部性质 string 用地性质[住宅用地;综合用地(含住宅);商业/办公用地;工业用地;其它用地],支持多性质同时查询
dealStatusId 否,默认为全部状态 string 土地状态ID [未成交:1,已成交:2,流拍:3,取消交易:4,中止交易:5,延迟交易:6],支持多状态同时查询
noticeBeginDate 否,默认全部日期 string 公告时间统计开始日期,yyyy-MM-dd
noticeEndDate 否,默认全部日期 string 公告时间统计结束日期,yyyy-MM-dd
pushoutBeginDate 否,默认全部日期 string 推出时间统计开始日期,yyyy-MM-dd
pushoutEndDate 否,默认全部日期 string 推出时间统计结束日期,yyyy-MM-dd
dealBeginDate 否,默认全部日期 string 成交时间统计开始日期,yyyy-MM-dd
dealEndDate 否,默认全部日期 string 成交时间统计结束日期,yyyy-MM-dd
deadLineBeginDate 否,默认可调取近36个月日期 string 截止时间统计开始日期,yyyy-MM-dd
deadLineEndDate 否,默认全部日期 string 截止时间统计结束日期,yyyy-MM-dd
pageSize integer 每页条数,传参为小于或等于100的整数
pageNum integer 当前页数,传参应小于或等于数据总页数

# 返回结果

JSON示例

{
    "meta": {
        "code": 1,
        "message": null,
        "structure": 1,
        "encrypted": false,
        "cached": false
    },
    "data": {
        "totalCount": 500,
        "landBaseSearchDtoList": [
            {
                "landId": "3bfad112-2862-4d01-a44a-eb3aeef01eaa",
                "landName": "北二环路以南、规划园区中路以东",
                "landSn": "2021GY-015",
                "cityName": "德州市",
                "cityCode": "371400",
                "districtName": "平原县",
                "districtCode": "371426",
                "landNature": "工业用地",
                "dealStatus": "未成交"
            },
            {
                "landId": "50abaf33-0caf-4c7b-8e14-f75f327d4dbb",
                "landName": "腰站镇政府以北、105国道(腰站镇段)以西)",
                "landSn": "2021JZ-005",
                "cityName": "德州市",
                "cityCode": "371400",
                "districtName": "平原县",
                "districtCode": "371426",
                "landNature": "住宅用地",
                "dealStatus": "未成交"
            },
            {
                "landId": "556e06ef-4b9c-4b87-af34-49b5a3ba5ac5",
                "landName": "恩城镇105国道以东",
                "landSn": "2021GY-017",
                "cityName": "德州市",
                "cityCode": "371400",
                "districtName": "平原县",
                "districtCode": "371426",
                "landNature": "工业用地",
                "dealStatus": "未成交"
            },
            {
                "landId": "8615cca5-851a-4221-90a5-8c17da69bf69",
                "landName": "北二环路以南、规划园区中路以东",
                "landSn": "2021GY-016",
                "cityName": "德州市",
                "cityCode": "371400",
                "districtName": "平原县",
                "districtCode": "371426",
                "landNature": "工业用地",
                "dealStatus": "未成交"
            },
            {
                "landId": "0ee8eda3-6c41-4017-93e5-9652804af59b",
                "landName": "银鹤食品东侧、开元大道北侧",
                "landSn": "LL2021-31-2",
                "cityName": "德州市",
                "cityCode": "371400",
                "districtName": "乐陵市",
                "districtCode": "371481",
                "landNature": "工业用地",
                "dealStatus": "未成交"
            }
        ]
    }
}

# 参数说明

参数说明:

参数名 描述
data 返回查询结果,没有匹配记录则返回为空,具体字段含义见下表
meta 返回值描述
    code 返回码.1为成功,http状态码为统一http请求错误,其他5位状态码为自定义错误码
    message 消息

字段说明

返回值字段 类型 说明 描述
totalCount integer 结果数量
LandBaseSearchDtoList array 土地列表
    cityCode string 城市Code
    cityName string 城市名称
    dealStatus string 成交状态(1=未成交;2=已成交;3=流拍;4,5,6=交易变更(取消/中止/延迟))
    districtCode string 土地区县Code
    districtName string 区县名称
    landId string 地块ID
    landName string 地块名称
    landNature string 用地性质(住宅用地;综合用地(含住宅);商业/办公用地;工业用地;其它用地)
    landSn string 地块编号

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

京 ICP备 18037826号-5