0532-5886 0566 value@cityre.cn

房产自动估价API

安全、高效的房产自动估价接口

房产自动评估API介绍

向下

通过通用API接口实现对特定房产的全面估价分析

接口概述
API简介

禧泰AVM是禧泰数据公司基于自有市场数据体系及我国估价师估价流程规范、国际估价师协会AVM标准,结合多年对房地产市场的认知,所开发的房产自动估价服务。

禧泰AVM基于多元回归分析的统计模型,通过房地产评估中的市场比较法计算房产公允价格。禧泰AVM通过单笔或批量方式,可帮助用户快速得到房产价格及租金水平。

为便于用户使用禧泰AVM,禧泰公司开发了其对应的应用程序接口,简称禧泰AVM API。通过与API的交互,用户可获取输入房产的市场价值、房产特征权重、市场相似案例等内容,提高应用效率,降低评估成本。

目标用户

面向银行、税务、软件平台等专业机构用户

禧泰AVM API特性

禧泰AVM API ---安全、高效、可跨平台应用、满足个性化软件开发的房产自动估价接口

安全
*禧泰AVM API 接口访问采用密钥授权模式访问,非授权不可使用。
*只需要通过禧泰AVM API 传输少量评估必须的信息即可获取评估结果,客户其他关键业务信息可以得到有效私有保护。

高效
禧泰AVM API 可承受每天千万次评估压力,单笔评估响应最快可达0.07秒。

可跨平台应用
禧泰AVM API 可实现跨平台应用,客户可自主根据需要选择PC端或移动端(安卓、苹果)应用。

个性化开发
禧泰AVM API 可以满足客户自主开发的个性需求,客户可以基于API搭建自己的应用程序,实现更多个性化功能,客户可根据需要开发PC端或移动端应用。

功能介绍

覆盖全国367个城市,可评估住宅、写字楼、商铺三类房产的售价和租金,并对房产价格进行全面分析。

1、估价结果接口(估价概要)

依据禧泰房产数据,通过标准化的自动估价模型对估价对象各特征进行全面分析,最终得出估价结果如下:

评估总价:147.0万元

评估单价:16,896元/㎡
评估时点:2015-7-15

共采用669个案例,案例情况如下:

最高单价

22,315元/㎡

最低单价

13,960元/㎡

单价平均值

17,329元/㎡

2、估价结果接口(相似房源案例)

获取与估价对象相似的房源案例信息。

小区

用途

楼层

面积

户型

装修

交易时间

单价(元/㎡)

香港花园

住宅

2/6

104

2室2厅1卫

已装修

2015-6-21

16,827

香港花园

住宅

--

101

2室1厅1卫

已装修

2015-5-23

17,373

香港花园

住宅

4/6

95

2室1厅1卫

已装修

2015-5-21

18,947

香港花园

住宅

1/6

92

2室1厅1卫

已装修

2015-6-18

16,848

香港花园

住宅

--

88

2室1厅1卫

已装修

2015-5-27

17,046

3、估价结果接口(房价优势分析)

获取房产价格直接受到各特征因素影响比重数值。

4、估价结果接口(相似房源交易历史)

获取相似房源历年交易数据,便于了解房产市场变化。

2015年6月

出售

总价:150万元

单价:17,046元/㎡

金门路学区房,绝对是整个香港花园小区内最好的套两户型,双南卧室,精装修。

联系人:管**/经纪人

电话:1318896****

2014年11月

出租

总价:2750元/月

--

2居室房子非常干净,带全部家具、家电,拎包入住。

联系人:张**/经纪人

电话:1379182****

2013年9月

出售

总价:160万元

单价:18,322元/㎡

家具齐全,南北通透,带交通便利,在青岛市南区繁华地段,工作生活方便。

联系人:侯**/经纪人

电话:1396394****

5、小区基本信息接口

获取小区的基本信息,报告小区位置、用途、占地面积、建筑类型、建筑年代、开发商等信息。

小区地址

青岛市南区香港中路123号

名称

香港花园

建成年代

2000年

用途

住宅 普通公寓 商住 办公 商铺

建筑类型

多层、高层

占地面积

186,668㎡[约280亩]

建筑面积

373,335㎡

容积率

2.00

绿化率

32.0%

开发商

山东省房地产开发集团青岛公司

物业公司

——

总车位

782个

 

 

6、小区(周边2km)房产价格分布接口

获取小区或周边各价格区间房产所占比例信息。

7、小区(周边)房价行情走势接口

获取小区或周边房价行情走势数据。

8、小区(周边)房源供给量走势接口

获取小区或周边房价供给量走势数据。

9、附近楼盘价格对比接口

获取附近楼盘的基本特征和均价信息。

名称

道路

方位距离

用途

建筑类型

价格(元/㎡)

金宇华彩

金门路

东北380米

住宅

多层

26,512

辛家庄三小区

逍遥路

东北630米

住宅

多层

14,949

辛家庄二小区

仙游路

东680米

住宅

--

15,856

辛家庄小区

逍遥一路

东400米

住宅

多层

15,213

辛家庄一小区

香港中路

东590米

住宅

--

18,330

10、生活便利度信息

获取估价对象周边生活环境信息。

附近交通路线

  • • 南平路站 东490米 320路
  • • 古田路站 东160米 227路环线 322路 33路
  • • 燕儿岛路站 西北360米 227路环线 320路 322路 374路
  • • 燕儿岛路(江西路)站 西北330米 322路 33路 604路环线
  • • 珠海路站 南490米 225路环线
  • • 蒲田路站 东北450米 320路
  • • 辛家庄站 西南300米 104路 110路仰口线 110路北九水线 125路 208路环线 222路 225路环线 232路环线 304路 309路 311路 316路 31路环线 321路 33路 363路 501路 604路环线
  • • 逍遥二路站 北400米 369路
  • • 逍遥二路(宁夏路)站 北480米 309路
  • • 金门路站 东490米 322路

教育

  • • 金门路小学分校 东北60米
  • • 枫叶双语幼儿园 南130米
  • • 青岛五十七中 北260米
  • • 青岛大学附属中学 北330米
  • • 幼儿师范附属第一幼儿园 东北390米
  • • 爱心幼儿园 南470米
  • • 燕儿岛路第一小学 北500米
  • • 金门路小学 东500米
  • • 卫生局幼儿园 北560米
  • • 新世纪幼儿园 东610米

健康

  • • 健联医院 西410米
  • • 上苑医院 西北710米
  • • 青岛市内分泌糖尿病医院 西北930米
  • • 山东省眼科医院 西南950米

商业

  • • 银座家居 东南300米
  • • 青岛爱购商城 西南310米
  • • 贞花韩国服装城 西南360米
  • • 麦凯乐青岛总店 西南450米
  • • 金街购物广场 西南870米
  • • 东泰佳世客 西南890米

宾馆

  • • 青岛佳如家旅馆 南150米
  • • 青岛万庄园旅馆 西南180米
  • • 青岛新客家旅馆 西200米
  • • 青岛紫荆花商务宾馆 西南220米
  • • 如家快捷酒店香港中路店 东南240米
  • • 爱尊客香港中路店 南320米
  • • 爱舍空间王子风尚店 南320米
  • • 海福特燕岛商务酒店 西330米
  • • 锦江之星燕儿岛路店 西北340米
评估声明

1.前提条件是估价对象权属明确、无法律纠纷、无意外事件的,所有运作方式、程序均符合国家、地方的有关法律、规定。

2.本报告结果完全依据市场公开数据,所得分析、意见和结论仅代表我方的专业分析、意见和结论,但受到未知的不确定因素的限制,并不对因数据本身可能存在的错误、缺失和偏差所导致的结果负责。

3.任何投资均有风险,房地产市场亦然。本报告资料仅供参考,任何因使用本报告所做出的投资、交易等决定本网站概不承担责任。

4.本报告最终解释权归全国房产自动估价平台。

接口文档
1 评估相关接口
1.1 评估结果接口

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY
flag sale 评估方式 sale=评售价 rent=评租金
city qd 城市码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
district SNE 行政区码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
haname 二者其一必填 香港花园 评估房源所在的小区名称,通过【小区查询接口】选择,不能自己定义,否则返回错误。
gps (120.4013,36.0647) 评估房源所处的gps,必须是百度坐标点。(格式:120.4013,36.0647)
location 香港中路100号 房源所在地址描述
buildno 1号楼 房源楼座号
unit 1单元 房源单元号
roomno 101室 房源房间号
proptype 住宅 评估房源的房屋用途,取值如下:住宅、办公、商铺,不能自己定义,否则返回错误。
bldgtype 多层 房源建筑类型 ,取值如下:多层 、小高层 、高层 、平房 、别墅 、联体别墅 、单体楼房 、四合院,不能自己定义,否则返回错误。
bldgarea 80 评估房源的面积
floor 1 评估房源所在楼层
height 6 评估房源所在楼座的楼高
face 1 朝向,取值如下:南向 、南北 、东向 、西向 、北向 、东南 、东北 、西南 、西北 、东西,不能自己定义,否则返回错误。
br 2
lr 1
cr 1
ba 1
buildyear 2005 建筑年代
intdeco 毛坯 装修程度,取值如下:毛坯房 、未装修 、局部装修 、简单装修 、精装修 、豪华装修 、中档装修,不能自己定义,否则返回错误。
indostru 平层 室内结构 ,取值如下:平层 、错层 、复式 、阁楼 、带车位 、老式房 、地下室 、带阁楼 、带车库 、其他 、带地下室 、带储藏室 、跃层 、团结户,不能自己定义,否则返回错误。
proprt 产权 权属 ,取值如下:产权,不能自己定义,否则返回错误。

Response:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
resultlist 节点 评估结果信息节点 type:结果类型 sale(评售价)
rent(评租金)
summary 节点 评估结果节点
price double 评估总价 unit:价格单位 1019730.3
unitprice double 评估单价 unit:价格单位 14778.7
evaltime date 评估时间 2015-07-20 13:44:37
unitprice-max double 案例最高单价 unit:价格单位 17142.9
unitprice-min double 案例最低单价 unit:价格单位 12500
unitprice-avg double 案例均价 unit:价格单位 14836.5
count int 参与计算的案例量 152
note string 估价说明 近期本小区交易案例较多,且有与评估对象相似度较高的案例,评估结果精准度较高。
beta 节点 房产特征优势分析
bldgarea double 面积 name:字段名称 0.57
br double name:字段名称 0.06
lr double name:字段名称 0.06
floor double 楼层 name:字段名称 0.23
bheight double 楼高 name:字段名称 0.15
face double 朝向 name:字段名称 0.15
samples 节点 评估样本抽样
data 节点
ha string 小区 香港花园
proptype string 房屋用途 住宅
unitprice double 单价 unit:价格单位 <unitprice unit='元/㎡'>14927.5</unitprice>
areasize double 面积 67
floor int 楼层 5
bheight int 楼高 7
br int 2
lr int 1
ba int 1
offertm date 交易时间 2013-06-02

示例一:

请求链接:http://api.creprice.cn/v1/rest/avm/assess?

<result>
   <status>failure</status>
   <statuscode>201</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo>key参数不存在</dataInfo> 
   <dataType>xml</dataType>   
</result>
<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
       <resultlist type="sale">
          <summary>
            <price unit='元'>1019730.3</price>
            <unitprice unit='元/㎡'>14778.7</unitprice>
            <evaltime>2015-07-20 13:44:37</evaltime>
            <unitprice-max unit='元/㎡'>17142.9</unitprice-max>
            <unitprice-min unit='元/㎡'>12500</unitprice-min>
            <unitprice-avg unit='元/㎡'>14836.5</unitprice-avg>
            <count>152</count>
            <note>近期本小区交易案例较多,且有与评估对象相似度较高的案例,评估结果精准度较高。</note>
          </summary>
          <beta>
            <bldgarea>0.34</bldgarea>
            <br>0.29</br>
            <lr>0.26</lr>
            <floor>0.03</floor>
            <bheight>0.01</bheight>
            <face>0.07</face>
          </beta>
          <samples>
            <data>
              <ha>云南路·新街小区</ha>
              <proptype>住宅</proptype>
              <unitprice unit='元/㎡'>14927.5</unitprice>
              <areasize>69</areasize>
              <floor>15</floor>
              <bheight>33</bheight>
              <intdeco>局部装修</intdeco>
              <br>2</br>
              <lr>1</lr>
              <cr></cr>
              <ba>1</ba>
              <offertm>2015-06-29 00:00:00</offertm>
            </data>
            ...
          </samples>
          <dealhistory>
            <data>
              <offertm>2015年6月</offertm>
              <dealtype>出售</dealtype>
              <price>150万元</price>
              <unitprice>14927.5</unitprice>              
              <floor>15</floor>
              <bheight>33</bheight>
              <intdeco>局部装修</intdeco>
              <br>2</br>
              <lr>1</lr>
              <cr></cr>
              <ba>1</ba>
              <offertm>2015-06-29 00:00:00</offertm>
            </data>
            ...
          </dealhistory>
       </resultlist>
      </xml>
   </data> 
</result>
1.2 相似房源挂牌情况接口

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY
flag sale 评估方式 sale=评售价 rent=评租金
city qd 城市码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
district SNE 行政区码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
haname 香港花园 评估房源所在的小区名称,通过【 小区查询接口】选择,不能自己定义,否则返回错误。
proptype 住宅 评估房源的房屋用途,取值如下:住宅、办公、商铺,不能自己定义,否则返回错误。
bldgarea 80 评估房源的面积
floor 1 评估房源所在楼层
height 6 评估房源所在楼座的楼高
br 2
lr 1
cr 1
ba 1

Response:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
resultlist 节点 评估结果信息节点 type:结果类型 sale(评售价)
rent(评租金)
deal 节点 相似房源挂牌情况
data 节点
offertm string 交易时间 2015-6-22
price double 总价 unit:价格单位 <price unit='万元'>150</price>
source string 来源。特别字段,需沟通获取 城市房产
contact string 联系人 侯宝全/经纪人
tel string 电话
1396394****
ha string 小区 香港花园
proptype string 房屋用途 住宅
br int 2
lr int 1
ba int 1
floor int 楼层 5
bheight int 楼高 7
areasize double 面积 67

示例一:
请求链接:http://api.creprice.cn/v1/rest/housing/similardeal?

<result>
       <status>failure</status>
       <statuscode>201</statuscode>
       <time>2015-03-31 06:58:14</time>
       <dataInfo>key参数不存在</dataInfo> 
       <dataType>xml</dataType>   
    </result>

示例二:
请求链接:http://api.creprice.cn/v1/rest/housing/similardeal?apiKey=XXXXXXXXXXXX&city=qd&district=SNE&haname=香港花园&proptype=住宅&bldgarea=69&floor=3&height=33&br=2&lr=1&flag=sale

<result>
       <status>success</status>
       <statuscode>1</statuscode>
       <time>2015-03-31 06:58:14</time>
       <dataInfo></dataInfo> 
       <dataType>xml</dataType>  
       <data>
          <xml>
           <resultlist type="sale">
              <deal>
                <data>
                  <offertm>2015-6-22</offertm>
                  <price unit='万元'>150</price>
                  <source>城市房产</source> 
                  <contact>管**/经纪人</contact>     
                  <tel>1318996****</tel>             
                  <ha>云南路·新街小区</ha>
                  <proptype>住宅</proptype>
                  <br>2</br>
                  <lr>1</lr>
                  <cr></cr>
                  <ba>1</ba>
                  <floor>15</floor>
                  <bheight>33</bheight>
                  <areasize>69</areasize>             
                </data>
                ...
              </deal>
           </resultlist>
          </xml>
       </data> 
    </result>

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY
flag sale 评估方式 sale=评售价 rent=评租金
city qd 城市码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
district SNE 行政区码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
haname 二者其一必填 香港花园 评估房源所在的小区名称,通过【小区查询接口】选择,不能自己定义,否则返回错误。
gps (120.4013,36.0647) 评估房源所处的gps,必须是百度坐标点。(格式:(120.4013,36.0647))
location 香港中路100号 房源所在地址描述
buildno 1号楼 房源楼座号
unit 1单元 房源单元号
roomno 101室 房源房间号
proptype 住宅 评估房源的房屋用途,取值如下:住宅、办公、商铺,不能自己定义,否则返回错误。
bldgtype 多层 房源建筑类型 ,取值如下:多层 、小高层 、高层 、平房 、别墅 、联体别墅 、单体楼房 、四合院,不能自己定义,否则返回错误。
bldgarea 80 评估房源的面积
floor 1 评估房源所在楼层
height 6 评估房源所在楼座的楼高
face 1 朝向,取值如下:南向 、南北 、东向 、西向 、北向 、东南 、东北 、西南 、西北 、东西,不能自己定义,否则返回错误。
br 2
lr 1
cr 1
ba 1
buildyear 2005 建筑年代
intdeco 毛坯 装修程度,取值如下:毛坯房 、未装修 、局部装修 、简单装修 、精装修 、豪华装修 、中档装修,不能自己定义,否则返回错误。
indostru 平层 室内结构 ,取值如下:平层 、错层 、复式 、阁楼 、带车位 、老式房 、地下室 、带阁楼 、带车库 、其他 、带地下室 、带储藏室 、跃层 、团结户,不能自己定义,否则返回错误。
proprt 产权 权属 ,取值如下:产权,不能自己定义,否则返回错误。

Response:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
resultlist 节点 评估结果信息节点 type:结果类型 sale(评售价)
rent(评租金)
summary 节点 评估结果节点
price double 评估总价 unit:价格单位 1019730.3
unitprice double 评估单价 unit:价格单位 14778.7
evaltime date 评估时间 2015-07-20 13:44:37
unitprice-max double 案例最高单价 unit:价格单位 17142.9
unitprice-min double 案例最低单价 unit:价格单位 12500
unitprice-avg double 案例均价 unit:价格单位 14836.5
count int 参与计算的案例量 152
note string 估价说明 近期本小区交易案例较多,且有与评估对象相似度较高的案例,评估结果精准度较高。
beta 节点 房产特征优势分析
bldgarea double 面积 name:字段名称 0.57
br double name:字段名称 0.06
lr double name:字段名称 0.06
floor double 楼层 name:字段名称 0.23
bheight double 楼高 name:字段名称 0.15
face double 朝向 name:字段名称 0.15
samples 节点 评估样本抽样
data 节点
ha string 小区 香港花园
proptype string 房屋用途 住宅
unitprice double 单价 unit:价格单位 <unitprice unit='元/㎡'>14927.5</unitprice>
areasize double 面积 67
floor int 楼层 5
bheight int 楼高 7
br int 2
lr int 1
ba int 1
offertm date 交易时间 2013-06-02
deal 节点 相似房源挂牌情况
data 节点
offertm string 交易时间 2015-6-22
price double 总价 unit:价格单位 <price unit='万元'>150</price>
source string 来源。特别字段,需沟通获取 城市房产
contact string 联系人 侯宝全/经纪人
tel string 电话
1396394****
ha string 小区 香港花园
proptype string 房屋用途 住宅
br int 2
lr int 1
ba int 1
floor int 楼层 5
bheight int 楼高 7
areasize double 面积 67
dealhistory 节点 相似房源交易历史
data 节点
offertm string 交易时间 2015年6月
dealtype string 交易方式 出售
price double 总价 unit:价格单位 <price unit='万元'>150</price>
unitprice double 单价 unit:价格单位 <unitprice unit='元/㎡'>17611.9</unitprice>
contact string 联系人 侯宝全/经纪人
tel string 电话
1396394****
ha string 小区 香港花园
proptype string 房屋用途 住宅
br int 2
lr int 1
ba int 1
floor int 楼层 5
bheight int 楼高 7
areasize double 面积 67
note string 说明 2 居室房子非常干净,带全部家具、家电,拎包入住。

示例一:

请求链接:http://api.creprice.cn/v1/rest/avm/assess?

<result>
   <status>failure</status>
   <statuscode>201</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo>key参数不存在</dataInfo> 
   <dataType>xml</dataType>   
</result>
<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
       <resultlist type="sale">
          <summary>
            <price unit='元'>1019730.3</price>
            <unitprice unit='元/㎡'>14778.7</unitprice>
            <evaltime>2015-07-20 13:44:37</evaltime>
            <unitprice-max unit='元/㎡'>17142.9</unitprice-max>
            <unitprice-min unit='元/㎡'>12500</unitprice-min>
            <unitprice-avg unit='元/㎡'>14836.5</unitprice-avg>
            <count>152</count>
            <note>近期本小区交易案例较多,且有与评估对象相似度较高的案例,评估结果精准度较高。</note>
          </summary>
          <beta>
            <bldgarea>0.34</bldgarea>
            <br>0.29</br>
            <lr>0.26</lr>
            <floor>0.03</floor>
            <bheight>0.01</bheight>
            <face>0.07</face>
          </beta>
          <samples>
            <data>
              <ha>云南路·新街小区</ha>
              <proptype>住宅</proptype>
              <unitprice unit='元/㎡'>14927.5</unitprice>
              <areasize>69</areasize>
              <floor>15</floor>
              <bheight>33</bheight>
              <intdeco>局部装修</intdeco>
              <br>2</br>
              <lr>1</lr>
              <cr></cr>
              <ba>1</ba>
              <offertm>2015-06-29 00:00:00</offertm>
            </data>
            ...
          </samples>
          <dealhistory>
            <data>
              <offertm>2015年6月</offertm>
              <dealtype>出售</dealtype>
              <price>150万元</price>
              <unitprice>14927.5</unitprice>              
              <floor>15</floor>
              <bheight>33</bheight>
              <intdeco>局部装修</intdeco>
              <br>2</br>
              <lr>1</lr>
              <cr></cr>
              <ba>1</ba>
              <offertm>2015-06-29 00:00:00</offertm>
            </data>
            ...
          </dealhistory>
       </resultlist>
      </xml>
   </data> 
</result>
1.3 相似房源交易历史接口

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY
city qd 城市码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
district SNE 行政区码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
haname 香港花园 评估房源所在的小区名称,通过【 小区查询接口】选择,不能自己定义,否则返回错误。
proptype 住宅 评估房源的房屋用途,取值如下:住宅、办公、商铺,不能自己定义,否则返回错误。
bldgarea 80 评估房源的面积
floor 1 评估房源所在楼层
height 6 评估房源所在楼座的楼高
br 2
lr 1
cr 1
ba 1

Response:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
resultlist 节点 评估结果信息节点
dealhistory 节点 相似房源交易历史
data 节点
offertm string 交易时间 2015年6月
dealtype string 交易方式 出售
price double 总价 unit:价格单位 <price unit='万元'>150</price>
unitprice double 单价 unit:价格单位 <unitprice unit='元/㎡'>17611.9</unitprice>
contact string 联系人 侯宝全/经纪人
tel string 电话
1396394****
ha string 小区 香港花园
proptype string 房屋用途 住宅
br int 2
lr int 1
ba int 1
floor int 楼层 5
bheight int 楼高 7
areasize double 面积 67
note string 说明 2 居室房子非常干净,带全部家具、家电,拎包入住。

示例一:
请求链接:http://api.creprice.cn/v1/rest/housing/similardealhsy?

<result>
   <status>failure</status>
   <statuscode>201</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo>key参数不存在</dataInfo> 
   <dataType>xml</dataType>   
</result>

示例二:
请求链接:http://api.creprice.cn/v1/rest/housing/similardealhsy?apiKey=XXXXXXXXXXXX&city=qd&district=SNE&haname=香港花园&proptype=住宅&bldgarea=69&floor=3&height=33&br=2&lr=1

<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
       <resultlist>
          <dealhistory>
            <data>
              <offertm>2015年6月</offertm>
              <dealtype>出售</dealtype>
              <price unit='万元'>150</price>
              <unitprice unit='元/㎡'>14927.5</unitprice> 
              <contact>管**/经纪人</contact>     
              <tel>1318996****</tel>             
              <ha>云南路·新街小区</ha>
              <proptype>住宅</proptype>
              <br>2</br>
              <lr>1</lr>
              <cr></cr>
              <ba>1</ba>
              <floor>15</floor>
              <bheight>33</bheight>
              <areasize>69</areasize>
              <note>2 居室房子非常干净,带全部家具、家电,拎包入住。</note>
            </data>
            ...
          </dealhistory>
       </resultlist>
      </xml>
   </data> 
</result>
2 基础信息接口
2.1 小区信息接口

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY
city qd 城市码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
district SNE 行政区码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
haname 香港花园 小区名称,通过【小区查询接口】选择,不能自己定义,否则返回错误。

Response:

非写字楼时:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
ha 节点 小区信息
location string 小区地址 青岛市市南区东部香港中路123号
name string 小区名称 香港花园
lon double 经度 120.1234
lat double 纬度 35.1234
buildyear string 建成年代 2000年
proptype string 用途 住宅 普通公寓 商住 办公 商铺
bldgtype string 建筑类型 多层、高层
floorarea string 占地面积 186,668㎡ [约 280 亩]
bldgarea string 建筑面积 373,335㎡
volumerate double 容积率 2.00
greenrate string 绿化率 32.0%
dv string 开发商 山东省房地产开发集团青岛公司
sv string 物业公司 物业公司
parking string 总车位数 1000个

写字楼时:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
ha 节点 小区信息
location string 小区地址 青岛市市南区东部香港中路123号
name string 小区名称 香港花园
lon double 经度 120.1234
lat double 纬度 35.1234
buildyear string 建成年代 2000年
proptype string 用途 住宅 普通公寓 商住 办公 商铺
bldgtype string 建筑类型 多层、高层
floorarea string 占地面积 186,668㎡ [约 280 亩]
bldgarea string 建筑面积 373,335㎡
dv string 开发商 山东省房地产开发集团青岛公司
sv string 物业公司 物业公司
parking string 总车位数 1000个
lift string 电梯情况
oblevel string 写字楼级别 甲级
<result>
   <status>failure</status>
   <statuscode>201</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo>API KEY参数不存在</dataInfo> 
   <dataType>xml</dataType>   
</result>
<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
       <ha>
        <location>青岛市南区香港中路123号</location>
        <name>香港花园</name>
        <lon>120.3654</lon>
        <lat>35.1234</lat>
        <buildyear>2000年</buildyear>
        <proptype>住宅 普通公寓 商住 办公 商铺</proptype>
        <bldgtype>高层 多层</bldgtype>
        <floorarea>186,668㎡ [约 280 亩]</floorarea>
        <bldgarea>373,335㎡</bldgarea>
        <volumerate>2.00</volumerate>
        <greenrate>32.0%</greenrate>
        <dv>开发商</dv>
        <sv>物业公司</sv>
        <parking>200个</parking>
        <lift>物业公司</lift>
        <oblevel>甲级</oblevel>
       </ha>
      </xml>
   </data> 
</result>
<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
       <ha>
        <location>青岛市南区香港中路100号</location>
        <name>中商大厦</name>
        <lon>120.3654</lon>
        <lat>35.1234</lat>
        <buildyear>2000年</buildyear>
        <proptype>办公</proptype>
        <bldgtype>高层</bldgtype>
        <floorarea>5,368㎡[约8亩]</floorarea>
        <bldgarea>373,335㎡</bldgarea>
        <dv>开发商</dv>
        <sv>物业公司</sv>
        <parking>200个</parking>
        <lift>物业公司</lift>
        <oblevel>甲级</oblevel>
       </ha>
      </xml>
   </data> 
</result>
2.2 附近楼盘信息接口

该接口返回小区或GPS百度坐标点的周边楼盘的相关信息

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY
city qd 城市码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
district SNE 行政区码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
haname 二者其一必填 香港花园 小区名称,通过【查询小区接口】选择,不能自己定义,否则返回错误。
gps (120.4013,36.0647) 查询的中心点,必须是百度坐标点。(格式:120.4013,36.0647)
distance 500 500 查询的半径,单位:米,与gps搭配使用
取值如下:500、1000、1500、2000,不能自己定义,否则返回错误
pricetype sale 楼盘价格类型,sale=售价 rent=租金
proptype 住宅 评估房源的房屋用途,取值如下:住宅、办公、商铺,不能自己定义,否则返回错误。

Response:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
halist 节点 楼盘信息列表
item nodelist 单个楼盘信息
name string 名称 金宇华彩
lon double 经度 120.1234
lat double 纬度 35.1234
street string 道路 金门路
direction string 方位 东北
distance string 距离 380米
proptype string 用途 住宅
bldgtype string 建筑类型 多层
price string 价格 unit:价格单位 26,512
<result>
   <status>failure</status>
   <statuscode>201</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo>API KEY参数不存在</dataInfo> 
   <dataType>xml</dataType>   
</result>
<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
         <halist>
            <item>
               <name>金宇华彩</name>
               <lon>120.1234</lon>
               <lat>35.1234</lat>
               <street>金门路</street>
               <direction>东北</direction>
               <distance>380米</distance>
               <proptype>住宅</proptype>
               <bldgtype>多层</bldgtype>
               <price unit='元/㎡'>26,512</lat>
            </item>
            ......
         </halist>         
      </xml>
   </data> 
</result>
2.3 周边生活便利度接口

该接口返回小区或GPS百度坐标点的周边公交、教育、医疗、商业、宾馆等信息

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY
city qd 城市码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
district SNE 行政区码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
haname 二者其一必填 香港花园 小区名称,通过【查询小区接口】选择,不能自己定义,否则返回错误。
gps (120.4013,36.0647) 查询的中心点,必须是百度坐标点。(格式:120.4013,36.0647)
distance 500 500 查询的半径,单位:米,与gps搭配使用
取值如下:500、1000、1500、2000,不能自己定义,否则返回错误

Response:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
traffic 节点 附近交通路线
item nodelist 站点信息
name string 站点名称 南平路站
direction string 方位
distance string 距离 500米
routes nodelist 线路列表
route string 线路 320 路
education 节点 教育
item nodelist 教育信息
name string 学校名称 金门路小学分校
direction string 方位
distance string 距离 500米
medical 节点 医疗
item nodelist 医疗信息
name string 医院名称 健联医院
direction string 方位
distance string 距离 500米
business 节点 商业
item nodelist 商业信息
name string 商业名称 银座家居
direction string 方位
distance string 距离 500米
hotel 节点 宾馆
item nodelist 宾馆信息
name string 宾馆名称 青岛佳如家旅馆
direction string 方位
distance string 距离 500米
<result>
   <status>failure</status>
   <statuscode>201</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo>API KEY参数不存在</dataInfo> 
   <dataType>xml</dataType>   
</result>
<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
         <traffic>
            <item>
               <name>南平路站</name>
               <direction></direction>
               <distance>500米</distance>
               <routes>
                  <route>227路环线 </route>
                  <route>322路</route>
                  ......
               </routes>
            </item>
            ......
         </traffic>
         <education>
            <item>
               <name>金门路小学分校</name>
               <direction></direction>
               <distance>500米</distance>
            </item>
            ......
         </education>
         <medical>
            <item>
               <name>健联医院</name>
               <direction></direction>
               <distance>500米</distance>
            </item>
            ......
         </medical>
         <business>
            <item>
               <name>银座家居</name>
               <direction></direction>
               <distance>500米</distance>
            </item>
            ......
         </business>
         <hotel>
            <item>
               <name>青岛佳如家旅馆</name>
               <direction></direction>
               <distance>500米</distance>
            </item>
            ......
         </hotel>
      </xml>
   </data> 
</result>
3 行情接口
3.1 房价行情走势分析

若查询小区,则返回该小区的供给单价走势数据
若查询GPS,则直接返回GPS周边距离的供给单价走势数据。

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY
city qd 城市码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
district SNE 行政区码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
haname 二者其一必填 香港花园 小区名称,通过【查询小区接口】选择,不能自己定义,否则返回错误。
gps 120.4013,36.0647 查询的中心点,必须是百度坐标点。(格式:120.4013,36.0647)
distance 500 500 查询的半径,单位:米,与gps搭配使用
取值如下:500、1000、1500、2000,不能自己定义,否则返回错误
proptype 住宅 住宅 用途,取值如下:住宅、办公、商铺 ,不能自己定义,否则返回错误。
sinceyear 1 1 年限。1 表示从上个月往前推 1 年,2 表示从上个月往前推 2 年,5 表示从当上个月前推 5 年,10 表示从上个月往前推 10 年(只能是 1、2、5、10,若是其它值则认为是 1)
flag sale sale 租售类型,sale=出售 rent=出租

Response:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
drawdata 节点 走势数据 unit:价格单位 <drawdata unit=“元/㎡”>
plot nodelist 每个数据点
x string 时间 2015-06
y double 数据 6047

示例一:
请求链接:http://api.creprice.cn/v1/rest/stat/pricelinedata?

<result>
   <status>failure</status>
   <statuscode>201</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo>API KEY参数不存在</dataInfo> 
   <dataType>xml</dataType>   
</result>

示例二:
请求链接:http://api.creprice.cn/v1/rest/stat/pricelinedata?apiKey=XXXXXXXXXXXX&city=qd&district=SNE&haname=香港花园

<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
         <drawdata unit="元/㎡">
            <plot>
               <x>2014-06</x>
               <y>6047</y>
            </plot>
            ......
         </drawdata>
      </xml>
   </data> 
</result>

示例三:
请求链接:http://api.creprice.cn/v1/rest/stat/pricelinedata?apiKey=XXXXXXXXXXXX&city=qd&district=SNE&gps=120.1234,35.1234&distance=1000

<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
         <drawdata unit="元/㎡">
            <plot>
               <x>2014-06</x>
               <y>6047</y>
            </plot>
            ......
         </drawdata>
      </xml>
   </data> 
</result>
3.2 房源供给量变化

若查询小区,则返回该小区的供给量变化数据
若查询GPS,则直接返回gps周边距离的供给量变化数据。

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY
city qd 城市码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
district SNE 行政区码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
haname 二者其一必填 香港花园 小区名称,通过【查询小区接口】选择,不能自己定义,否则返回错误。
gps 120.4013,36.0647 查询的中心点,必须是百度坐标点。(格式:120.4013,36.0647)
distance 500 500 查询的半径,单位:米,与gps搭配使用
取值如下:500、1000、1500、2000,不能自己定义,否则返回错误
proptype 住宅 住宅 用途,取值如下:住宅、办公、商铺 ,不能自己定义,否则返回错误。
sinceyear 1 1 年限。1 表示从上个月往前推 1 年,2 表示从上个月往前推 2 年,5 表示从当上个月前推 5 年,10 表示从上个月往前推 10 年(只能是 1、2、5、10,若是其它值则认为是 1)
flag sale sale 租售类型,sale=出售 rent=出租

Response:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
drawdata 节点 走势数据 unit:价格单位 <drawdata unit=“套”>
plot nodelist 每个数据点
x string 时间 2015-06
y double 数据 6047

示例一:
请求链接:http://api.creprice.cn/v1/rest/stat/countlinedata?

<result>
   <status>failure</status>
   <statuscode>201</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo>API KEY参数不存在</dataInfo> 
   <dataType>xml</dataType>   
</result>

示例二:
请求链接:http://api.creprice.cn/v1/rest/stat/countlinedata?apiKey=XXXXXXXXXXXX&city=qd&district=SNE&haname=香港花园

<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
         <drawdata unit="套">
            <plot>
               <x>2014-06</x>
               <y>6047</y>
            </plot>
            ......
         </drawdata>
      </xml>
   </data> 
</result>

示例三:
请求链接:http://api.creprice.cn/v1/rest/stat/countlinedata?apiKey=XXXXXXXXXXXX&city=qd&district=SNE&gps=120.1234,35.1234&distance=1000

<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
         <drawdata unit="套">
            <plot>
               <x>2014-06</x>
               <y>6047</y>
            </plot>
            ......
         </drawdata>
      </xml>
   </data> 
</result>
3.3 价格分布比较

若查询小区,则返回该小区的供给单价分布数据
若查询GPS,则直接返回gps周边距离的供给单价分布数据。

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY
city qd 城市码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
district SNE 行政区码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
haname 二者其一必填 香港花园 小区名称,通过【查询小区接口】选择,不能自己定义,否则返回错误。
gps 120.4013,36.0647 查询的中心点,必须是百度坐标点。(格式:120.4013,36.0647)
distance 500 500 查询的半径,单位:米,与gps搭配使用
取值如下:500、1000、1500、2000,不能自己定义,否则返回错误
proptype 住宅 住宅 用途,取值如下:住宅、办公、商铺 ,不能自己定义,否则返回错误。
flag sale sale 租售类型,sale=出售 rent=出租

Response:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
drawdata 节点 分布数据 unit:数据单位 <drawdata unit=“%”>
plot nodelist 每个数据点
x string 区间最小值 0
y double 该区间所占百分比 0.24

示例一:
请求链接:http://api.creprice.cn/v1/rest/stat/pricebardata?

<result>
   <status>failure</status>
   <statuscode>201</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo>API KEY参数不存在</dataInfo> 
   <dataType>xml</dataType>   
</result>

示例二:
请求链接:http://api.creprice.cn/v1/rest/stat/pricebardata?apiKey=XXXXXXXXXXXX&city=qd&district=SNE&gps=120.1234,35.1234&distance=1000

<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
         <drawdata unit="%">
            <plot>
               <x>0</x>
               <y1>0.24</y1>
            </plot>
            <plot>
               <x>2000</x>
               <y1>2.96</y1>
            </plot>
            <plot>
               <x>4000</x>
               <y1>12.52</y1>
            </plot>
            <plot>
               <x>6000</x>
               <y1>21.14</y1>
            </plot>
            ......
         </drawdata>
      </xml>
   </data> 
</result>
4 辅助接口
4.1 城市行政区接口

获取所有的城市及行政区的信息。
建议:用户在使用该接口时可以一次性读取,多次使用,以提高效率。

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY

Response:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
citys 节点 城市列表
province nodelist 省份 id:省份码 name:省份名称 <province id=“anhui” name=“安徽”>
city nodelist 城市信息 id:城市码 name:城市名称 <city id=“bj” name=“北京”>
district nodelist 行政区信息 id:城市码 <district id=“YJ”>迎江区</district>
<result>
   <status>failure</status>
   <statuscode>201</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo>API KEY参数不存在</dataInfo> 
   <dataType>xml</dataType>   
</result>
<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
        <citys>
          <province id="anhui" name="安徽">
             <city id="aq" name="安庆">
                <district id="YJ">迎江区</district>
                ......
             </city>              
             ......
          </province>
          <province id="bejing" name="北京">
             <city id="bj" name="北京>
                <district id="dc">东城区</district>
                ......
             </city>
          </province>
          ......
        </citys>
      </xml>
   </data> 
</result>
4.2 小区查询接口

根据关键字查询指定小区,该接口最多返回10个小区

Request:

参数 是否必填 默认值 举例 含义
apiKey API KEY
city qd 城市码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
district SNE 行政区码,通过【城市行政区接口】选择,不能自己定义,否则返回错误。
keywords 中商大厦 搜索关键字

Response:

名称 类型 含义 属性 示例
result 根节点
status string success/failure
statuscode int 状态码,1表示成功
time datetime 服务器时间 2015-03-31 06:58:14
dataInfo string 状态信息
dataType string json/xml xml
data 节点
xml 节点
has nodelist 小区列表
ha string 小区信息
<result>
   <status>failure</status>
   <statuscode>201</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo>API KEY参数不存在</dataInfo> 
   <dataType>xml</dataType>   
</result>
<result>
   <status>success</status>
   <statuscode>1</statuscode>
   <time>2015-03-31 06:58:14</time>
   <dataInfo></dataInfo> 
   <dataType>xml</dataType>  
   <data>
      <xml>
       <has>
        <ha>中商大厦</item>
       </has>
      </xml>
   </data> 
</result>

如果您有任何房地产估价或大量客户住址数据清洗的需求,欢迎联系我们。

邮箱:value@cityre.cn业务交流群:338695066
联系方式
  • 点击这里给我发消息
联系电话:
0532 - 58860566
400 - 600 - 4577
技术支持:
value@cityre.cn