# 地块搜索
# 接口介绍
接口信息
接口 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 | 地块编号 |