API文档 地产建筑 购地信息
基本信息
接口地址
https://api.qixin.com/APIService/operation/getLandInfoByNameAndType
数据格式
JSON
请求方式
GET
请求示例
https://api.qixin.com/APIService/operation/getLandInfoByNameAndType?keyword=广州香雪空港跨境物联有限公司&type=1
描述
企业购地信息,有土地公示、结果公告,土地转让、地块抵押、房地产大企业购地以及房地产大地快出让等。根据不同入参类型,分别返回结果内容。
请求参数 (Headers)
参数名类型必填描述
Auth-Version String 2.0(参数值),固定传入:2.0
appkey String 启信慧眼数据开放平台获取 ,获取方式:个人中心-安全中心-API 密钥,获取appkey的同时,请完成IP白名单的配置:个人中心-安全中心-API IP白名单设置,如未配置,接口调试会报错“104 未添加IP白名单”
timestamp String UNIX时间戳,精确到毫秒,示例:1656921036000,当前系统时间近10分钟有效
sign String 请求认证签名,对appkey+timestamp+secret_key进行md5或者sha256摘要计算的结果,小写字符串(实际加密不带入‘+’)
请求参数 (Query)
参数名类型必填描述
keyword String 企业全名/注册号/统一社会信用代码
skip Number 跳过条目数(默认为0,单页返回10条数据)
type Number 数据模块类型: 1:地块公示 2:土地结果公告 3:土地转让 4:土地抵押 5:房地产大企业购地 6:房地产大地块出让
响应参数
参数名类型长度描述
status
data.status
String 10 返回结果状态
message
data.message
String 255 返回结果消息
sign
data.sign
String 32 数据签名
data
data.data
Object 0 返回查询结果,如果没有匹配记录则返回空。具体字段含义见下表
total
data.data.total
Number 10 返回列表中记录总数
items
data.data.items
Array 0 数据列表
type
data.data.items.type
String 255 模块类型 type=1地块公示返回以下数据字段:(文档标识使用,实际不返回)
code
data.data.items.code
String 150 土地编号
publish_date
data.data.items.publish_date
String 50 发布日期
province
data.data.items.province
String 100 行政区
area
data.data.items.area
String 255 土地面积(公顷)
location
data.data.items.location
String 255 土地位置
project_name
data.data.items.project_name
String 150 项目名称
land_use
data.data.items.land_use
String 255 土地用途
release_time
data.data.items.release_time
String 50 公示开始日期
due_time
data.data.items.due_time
String 50 公示结束日期
related_before
data.data.items.related_before
Array 0 受让单位
name
data.data.items.related_before.name
String 255 企业名称
eid
data.data.items.related_before.eid
String 36 企业 id
type
data.data.items.type
String 255 模块类型 type=2 结果公示返回以下数据字段:(文档标识使用,实际不返回)
elect_no
data.data.items.elect_no
String 50 电子监管号
release_time
data.data.items.release_time
String 50 签订日期
province
data.data.items.province
String 100 行政区
area
data.data.items.area
String 255 土地面积(公顷)
land_source
data.data.items.land_source
String 50 土地来源
land_level
data.data.items.land_level
String 50 土地级别
price
data.data.items.price
String 50 成交价格(万元)
use_year
data.data.items.use_year
String 50 土地使用年限
industry
data.data.items.industry
String 50 行业分类
location
data.data.items.location
String 255 土地位置
project_name
data.data.items.project_name
String 150 项目名称
land_use
data.data.items.land_use
String 255 土地用途
approver
data.data.items.approver
String 50 批准单位
signing_mode
data.data.items.signing_mode
String 50 供地方式
ydjdrq
data.data.items.ydjdrq
String 50 约定交地时间
ydkgrq
data.data.items.ydkgrq
String 50 约定开工时间
sjkgrq
data.data.items.sjkgrq
String 50 实际开工时间
ydjgrq
data.data.items.ydjgrq
String 50 约定竣工时间
sjjgrq
data.data.items.sjjgrq
String 50 实际竣工时间
ydrjl_sx
data.data.items.ydrjl_sx
String 50 约定容积率上限
ydrjl_xx
data.data.items.ydrjl_xx
String 50 约定容积率下限
related_before
data.data.items.related_before
Array 0 土地使用权
name
data.data.items.related_before.name
String 255 土地使用权企业名称
eid
data.data.items.related_before.eid
String 36 土地使用权企业 id
type
data.data.items.type
String 255 模块类型 type=3 土地转让返回以下数据字段:(文档标识使用,实际不返回)
code
data.data.items.code
String 150 土地编号
release_time
data.data.items.release_time
String 50 成交时间
province
data.data.items.province
String 100 行政区
area
data.data.items.area
String 255 土地面积(公顷)
use_type
data.data.items.use_type
String 50 土地使用权类型
use_year
data.data.items.use_year
String 50 土地使用年限
transfer_price
data.data.items.transfer_price
String 50 转让价格
transfer_type
data.data.items.transfer_type
String 50 转让方式
use_situation
data.data.items.use_situation
String 50 土地利用状况
land_level
data.data.items.land_level
String 50 土地级别
location
data.data.items.location
String 255 土地位置
land_use
data.data.items.land_use
String 255 土地用途
related_before
data.data.items.related_before
Array 0 原土地使用权
name
data.data.items.related_before.name
String 255 原土地使用权名称
eid
data.data.items.related_before.eid
String 36 原土地使用权企业 id
related_after
data.data.items.related_after
Array 0 现土地使用权
name
data.data.items.related_after.name
String 255 现土地使用权名称
eid
data.data.items.related_after.eid
String 36 现土地使用权企业 id
type
data.data.items.type
String 255 模块类型 type=4 土地抵押返回以下数据字段:(文档标识使用,实际不返回)
code
data.data.items.code
String 150 土地编号
province
data.data.items.province
String 100 行政区
area
data.data.items.area
String 255 土地面积(公顷)
diya_area
data.data.items.diya_area
String 50 抵押面积
pro_amount
data.data.items.pro_amount
String 50 评估金额
rent_amount
data.data.items.rent_amount
String 50 抵押金额
location
data.data.items.location
String 255 土地位置
land_use
data.data.items.land_use
String 255 土地用途
user_code
data.data.items.user_code
String 50 土地他项权利人证号
use_code
data.data.items.use_code
String 50 土地使用权证号
diya_type
data.data.items.diya_type
String 50 土地抵押人性质
shuxing
data.data.items.shuxing
String 50 抵押土地权属性质与使用权类型
release_time
data.data.items.release_time
String 50 土地抵押登记起始时间
dueTime
data.data.items.dueTime
String 50 土地抵押登记结束时间
related_before
data.data.items.related_before
Array 0 土地抵押人(数组)
name
data.data.items.related_before.name
String 255 土地抵押人名
eid
data.data.items.related_before.eid
String 36 土地抵押人企业 id
related_after
data.data.items.related_after
Array 0 土地抵押权(数组)
name
data.data.items.related_after.name
String 255 土地抵押权人名
eid
data.data.items.related_after.eid
String 36 土地抵押权企业 id
type
data.data.items.type
String 255 模块类型 type=5 房地产大企业购地返回以下数据字段:(文档标识使用,实际不返回)
elect_no
data.data.items.elect_no
String 50 电子监管号
province
data.data.items.province
String 100 行政区
area
data.data.items.area
String 255 供地面积(公顷)
release_time
data.data.items.release_time
String 50 签订日期
price
data.data.items.price
String 50 成交价款(万元)
signing_mode
data.data.items.signing_mode
String 50 供应方式
location
data.data.items.location
String 255 土地位置
land_use
data.data.items.land_use
String 255 土地用途
ydkgrq
data.data.items.ydkgrq
String 50 约定开工时间
ydjgrq
data.data.items.ydjgrq
String 50 约定竣工时间
min_rj
data.data.items.min_rj
String 50 最小容积率
max_rj
data.data.items.max_rj
String 50 最大容积率
related_before
data.data.items.related_before
Array 0 受让人
name
data.data.items.related_before.name
String 255 受让人名称
eid
data.data.items.related_before.eid
String 36 受让人企业 id
related_after
data.data.items.related_after
Array 0 上级公司
name
data.data.items.related_after.name
String 255 上级公司名称
eid
data.data.items.related_after.eid
String 36 上级公司 id
type
data.data.items.type
String 255 模块类型 type=6 房地产大地块出让返回以下数据字段:(文档标识使用,实际不返回)
elect_no
data.data.items.elect_no
String 50 电子监管号
province
data.data.items.province
String 100 行政区
area
data.data.items.area
String 255 供地面积(公顷)
release_time
data.data.items.release_time
String 50 签订日期
price
data.data.items.price
String 50 成交价款(万元)
signing_mode
data.data.items.signing_mode
String 50 供应方式
location
data.data.items.location
String 255 土地位置
land_use
data.data.items.land_use
String 255 土地用途
ydkgrq
data.data.items.ydkgrq
String 50 约定开工时间
ydjgrq
data.data.items.ydjgrq
String 50 约定竣工时间
min_rj
data.data.items.min_rj
String 50 最小容积率
max_rj
data.data.items.max_rj
String 50 最大容积率
related_before
data.data.items.related_before
Array 0 受让人(数组)
name
data.data.items.related_before.name
String 255 受让人名称
eid
data.data.items.related_before.eid
String 36 受让人企业 id
related_after
data.data.items.related_after
Array 0 上级公司(数组)
name
data.data.items.related_after.name
String 255 上级公司名称
eid
data.data.items.related_after.eid
String 36 上级公司 id
num
data.data.num
Number 10 当前返回列表的总条数
响应示例
JSON
{
    "status": "200",
    "message": "操作成功",
    "sign": "395852678071839af51c604bcd4e2d5a",
    "data": {
        "total": 1,
        "items": [
            {
                "code": "AB0809003、AB0809004",
                "publish_date": "2017-07-13",
                "province": "广州市",
                "area": "6.6228",
                "location": "白云区钟落潭镇良田村AB0809003、AB0809004地块",
                "project_name": "-",
                "land_use": "仓储用地",
                "release_time": "2017-07-10",
                "due_time": "2017-08-10",
                "related_before": [
                    {
                        "name": "广州香雪空港跨境物联有限公司",
                        "eid": "0eed13f2-b44e-462d-93dd-7385db5964bf"
                    }
                ]
            }
        ],
        "num": 1
    }
}
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

let baseUrl = 'https://api.qixin.com/APIService/operation/getLandInfoByNameAndType';
let appkey = '正式appkey';
let secretKey = '正式secret_key';
let timeStamp = new Date().getTime();
const hash = crypto.createHash('md5');
let sign = hash.update(appkey + timeStamp + secretKey).digest('hex');

let urlParams = {
    keyword: 'keyword的值',
    skip: 'skip的值',
    type: 'type的值'
}

let concatParams = []
for (let key in urlParams) {
    concatParams.push(key + '=' + urlParams[key]);
}

let options = {
    'method': 'GET',
    'url': baseUrl + '?' + concatParams.join('&'),
    'headers': {
        'Connection': 'keep-alive',
        'Auth-version': '2.0',
        'appkey': appkey,
        'timestamp': timeStamp,
        'sign': sign
    }
};

request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});