淘宝开放平台

登录
文档中心 > API类目 > 闲鱼房源-前台

alibaba.idle.new.house.item.query (闲鱼二手房房源查询)

闲鱼二手房房源查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
house_query_dto HouseQueryDTO 必须 查询参数
  • └ item_id
  • Number
  • 必须
  • 123
  • 商品id
  • └ user_nick
  • String
  • 可选
  • 张三
  • 经纪人闲鱼会员名

响应参数

名称 类型 示例值 描述
result EasyResultDTO 返回结果
  • data
  • HouseQueryVO
  • 数据
  • └ house_status
  • Number
  • 0 - 在售 1 - 已售
  • 房源状态
  • videos
  • ImageInfoVO []
  • 视频
  • └ url
  • String
  • https://img.alicdn.xxxx.jpg
  • 视频封面的链接
  • └ type
  • Number
  • 0:图片 10000:视频
  • 文件类型
  • └ video_md5
  • String
  • AARgEoAAMAAAABAAIAAIdpAAQAAAABAA
  • 视频MD5
  • └ video_object
  • String
  • oss
  • 视频OSS ObjectName
  • └ property_class
  • Number
  • 1
  • 产权类型(1-商品房 2-经济适用房 3-回迁房 4-共有产权房 5-其他 6-公房)
  • └ has_owner_entrust
  • Boolean
  • true
  • 是否获得产权人委托
  • seller_vo
  • HouseSellerQueryVO
  • 卖家信息
  • └ staff_full_name
  • String
  • 所属经纪门店+姓名
  • 经纪人昵称
  • └ staff_shop_name
  • String
  • 所属经纪门店+姓名
  • 经纪人姓名
  • └ org_name
  • String
  • xx公司
  • 经纪人所属经纪公司（营业执照公司名）
  • └ org_license
  • String
  • 123
  • 统一社会信用代码或营业执照号（营业执照公司税号）
  • └ back_images
  • String []
  • http://img.alicdn.com/bao/uploaded/i1/O1CN011c47PJt5Lmvbjnk_!!0-fleamarket.jpg
  • 经纪人备案证明图片
  • └ staff_image
  • String
  • http://img.alicdn.com/bao/uploaded/i1/O1CN011c47PJt5Lmvbjnk_!!0-fleamarket.jpg
  • 经纪人头像
  • └ business_license_images
  • String []
  • http://img.alicdn.com/bao/uploaded/i1/O1CN011c47PJt5Lmvbjnk_!!0-fleamarket.jpg
  • 营业执照照片
  • └ staff_id
  • String
  • 123
  • 从业人员编号
  • └ staff_name
  • String
  • 张三
  • 经纪人姓名
  • └ staff_id_card
  • String
  • 身份证号
  • 经纪人身份证号
  • └ staff_phone_number
  • String
  • 18888888888
  • 经纪人手机号
  • └ owner_name
  • String
  • 李四
  • 房产证所有者姓名
  • └ id_code
  • String
  • 123
  • 房产证所有者身份证号
  • └ decorate_level
  • Number
  • 1-豪华装 2-精装 3-简装 4-毛坯
  • 装修程度
  • └ unique_house_id
  • String
  • 1234
  • 房源ID（服务商内部ID）
  • └ room_type
  • String
  • 独栋/联排/复式/平层/跃层/错层/其他
  • 户型结构
  • └ unit_price
  • BigDecimal
  • 1000
  • 单价 xx元/m2
  • images
  • ImageInfoVO []
  • 图片信息
  • └ type
  • Number
  • 0
  • 文件类型
  • └ url
  • String
  • http://img.alicdn.com/bao/uploaded/i1/O1CN011c47PJt5Lmvbjnk_!!0-fleamarket.jpg
  • 文件地址
  • └ property_rights
  • String
  • 共有产权/单独产权
  • 产权所属
  • └ room_area
  • BigDecimal
  • 80
  • 建筑面积单位：㎡
  • └ house_class
  • String
  • 高层、小高层、洋房、别墅、叠墅、公寓、办公、商住公寓、其他
  • 物业类型（房屋类型）
  • └ building_addr
  • String
  • 3栋1单元203室
  • 房屋门牌号
  • └ item_id
  • Number
  • 123
  • 商品id
  • └ total_floor
  • Number
  • 20
  • 总楼层
  • └ has_agency_fee
  • Boolean
  • true
  • 有无中介费
  • └ market_time
  • Number
  • 0-2004年以前 1-2004年 2-2005年 3-2006年 4-2007年 5-2008年 6-2009年 7-2010年 8-2011年 9-2012年 10-2013年 11-2014年 12-2015年 13-2016年 14-2017年 15-2018年 16-2019年 17-2020年 18-2021年 19-2022年 20-2023年 21-2024年
  • 建成年代
  • └ desc
  • String
  • 描述信息
  • 房屋描述
  • └ house_use_class
  • String
  • 普通住宅、商住公寓、办公写字楼、商铺、工业用房、文体娱乐、其他
  • 用途/类型
  • └ total_price
  • BigDecimal
  • 230.5
  • 总价 xx.x万元
  • └ has_real_estate_certificate
  • Boolean
  • true
  • 是否取得不动产证
  • └ house_age
  • String
  • 满五/满二/不满二
  • 房屋年限
  • └ title
  • String
  • 房屋标题
  • 房屋标题
  • └ real_estate_certificate_number
  • String
  • 123
  • 不动产权证号
  • └ elevator_room_ratio
  • String
  • 0.589
  • 梯户比例，是指电梯数和每层楼住户的比例
  • └ floor_class
  • Number
  • 1-低楼层 2-中楼层 3-高楼层
  • 所在楼层
  • └ property_rights_period
  • String
  • 70年产权/40年产权/50年产权/30年产权/永久产权/无产权
  • 产权年限
  • └ floor
  • Number
  • 8
  • 房屋所在楼层
  • └ building_class
  • String
  • 塔楼/板楼/板塔结合
  • 楼型
  • └ verification_code
  • String
  • 123
  • 核验码
  • └ publish_body_class
  • String
  • 服务商/经纪公司/经纪人/其他
  • 发布主体类型
  • community_images
  • ImageInfoVO []
  • 小区图片
  • └ type
  • Number
  • 0
  • 文件类型
  • └ url
  • String
  • https://img.alicdn.xxxx.jpg
  • 图片的链接
  • └ sale_time_str
  • String
  • 2024年05月
  • 挂牌时间
  • └ room_rate
  • BigDecimal
  • 88.88
  • 得房率
  • └ biz_circles
  • String
  • 万达广场
  • 商圈
  • └ face
  • Number
  • 1-朝东 2-朝南 3-朝西 4-朝北 5-西北 6-东北 7-东南 8-西南 9-东西 10-南北
  • 朝向
  • └ detail_address
  • String
  • 杭州市余杭区永福小区
  • 小区详细地址
  • └ has_elevator
  • Number
  • 0-无电梯 1-有电梯
  • 是否有电梯
  • └ has_check_certificate
  • Boolean
  • true/false
  • 是否产证已验
  • └ inner_area
  • BigDecimal
  • 88.88
  • 套内面积
  • └ category_id
  • Number
  • 50023914
  • 类目id
  • └ tags
  • String
  • 南北通透
  • 房源标签（满五/满二/不满二/近地铁/随时看房/新上/降价好房/满五唯一/唯一/七日热门/电梯房/明厨明卫/带车位/南北通透/急售）
  • └ has_parking
  • Number
  • 1
  • 是否带车位（0否/1是/2未知）
  • └ look_time
  • String
  • 周末可看
  • 看房时间（随时可看，周末可看等）
  • └ sale_reason
  • String
  • 破产
  • 业主售卖原因（例如：刚改/结婚/学区/出国/破产等）
  • └ situation
  • Number
  • 1
  • 房屋现状（1-空房 2业主 3-租客住 4-其他）
  • └ ownership_address
  • String
  • 房产证显示地址
  • 房产证地址
  • └ is_only_house
  • Boolean
  • true/false
  • 是否唯一住房
  • layout_pictures_image
  • ImageInfoVO []
  • 户型图
  • └ type
  • Number
  • 0
  • 文件类型
  • └ url
  • String
  • https://img.alicdn.xxxx.jpg
  • 图片的链接
  • └ bed_room_cnt
  • Number
  • 1
  • 房屋户型 - 室(1≤X≤10)
  • └ living_room_cnt
  • Number
  • 0
  • 房屋户型 - 厅(0≤X≤10)
  • └ bath_room_cnt
  • Number
  • 0
  • 房屋户型 - 卫(0≤X≤10)
  • └ success
  • Boolean
  • true/false
  • 是否成功
  • └ error_code
  • String
  • UNAUTHORIZED_PLAT_ACCESS
  • 错误码
  • └ error_msg
  • String
  • 房源机构没有权限
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleNewHouseItemQueryRequest req = new AlibabaIdleNewHouseItemQueryRequest();
AlibabaIdleNewHouseItemQueryRequest.HouseQueryDTO obj1 = new AlibabaIdleNewHouseItemQueryRequest.HouseQueryDTO();
obj1.setItemId(123L);
obj1.setUserNick("张三");
req.setHouseQueryDto(obj1);
AlibabaIdleNewHouseItemQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
<alibaba_idle_new_house_item_query_response>
    <result>
        <data>
            <house_status>0 - 在售 1 - 已售</house_status>
            <videos>
                <image_info_v_o>
                    <url>https://img.alicdn.xxxx.jpg</url>
                    <type>0:图片 10000:视频</type>
                    <video_md5>AARgEoAAMAAAABAAIAAIdpAAQAAAABAA</video_md5>
                    <video_object>oss</video_object>
                </image_info_v_o>
            </videos>
            <property_class>1</property_class>
            <has_owner_entrust>true</has_owner_entrust>
            <seller_vo>
                <staff_full_name>所属经纪门店+姓名</staff_full_name>
                <staff_shop_name>所属经纪门店+姓名</staff_shop_name>
                <org_name>xx公司</org_name>
                <org_license>123</org_license>
                <back_images>
                    <string>http://img.alicdn.com/bao/uploaded/i1/O1CN011c47PJt5Lmvbjnk_!!0-fleamarket.jpg</string>
                </back_images>
                <staff_image>http://img.alicdn.com/bao/uploaded/i1/O1CN011c47PJt5Lmvbjnk_!!0-fleamarket.jpg</staff_image>
                <business_license_images>
                    <string>http://img.alicdn.com/bao/uploaded/i1/O1CN011c47PJt5Lmvbjnk_!!0-fleamarket.jpg</string>
                </business_license_images>
                <staff_id>123</staff_id>
                <staff_name>张三</staff_name>
                <staff_id_card>身份证号</staff_id_card>
                <staff_phone_number>18888888888</staff_phone_number>
                <owner_name>李四</owner_name>
                <id_code>123</id_code>
            </seller_vo>
            <decorate_level>1-豪华装 2-精装 3-简装 4-毛坯</decorate_level>
            <unique_house_id>1234</unique_house_id>
            <room_type>独栋/联排/复式/平层/跃层/错层/其他</room_type>
            <unit_price>1000</unit_price>
            <images>
                <image_info_v_o>
                    <type>0</type>
                    <url>http://img.alicdn.com/bao/uploaded/i1/O1CN011c47PJt5Lmvbjnk_!!0-fleamarket.jpg</url>
                </image_info_v_o>
            </images>
            <property_rights>共有产权/单独产权</property_rights>
            <room_area>80</room_area>
            <house_class>高层、小高层、洋房、别墅、叠墅、公寓、办公、商住公寓、其他</house_class>
            <building_addr>3栋1单元203室</building_addr>
            <item_id>123</item_id>
            <total_floor>20</total_floor>
            <has_agency_fee>true</has_agency_fee>
            <market_time>0-2004年以前 1-2004年 2-2005年 3-2006年 4-2007年 5-2008年 6-2009年 7-2010年 8-2011年 9-2012年 10-2013年 11-2014年 12-2015年 13-2016年 14-2017年 15-2018年 16-2019年 17-2020年 18-2021年 19-2022年 20-2023年 21-2024年</market_time>
            <desc>描述信息</desc>
            <house_use_class>普通住宅、商住公寓、办公写字楼、商铺、工业用房、文体娱乐、其他</house_use_class>
            <total_price>230.5</total_price>
            <has_real_estate_certificate>true</has_real_estate_certificate>
            <house_age>满五/满二/不满二</house_age>
            <title>房屋标题</title>
            <real_estate_certificate_number>123</real_estate_certificate_number>
            <elevator_room_ratio>0.589</elevator_room_ratio>
            <floor_class>1-低楼层 2-中楼层 3-高楼层</floor_class>
            <property_rights_period>70年产权/40年产权/50年产权/30年产权/永久产权/无产权</property_rights_period>
            <floor>8</floor>
            <building_class>塔楼/板楼/板塔结合</building_class>
            <verification_code>123</verification_code>
            <publish_body_class>服务商/经纪公司/经纪人/其他</publish_body_class>
            <community_images>
                <image_info_v_o>
                    <type>0</type>
                    <url>https://img.alicdn.xxxx.jpg</url>
                </image_info_v_o>
            </community_images>
            <sale_time_str>2024年05月</sale_time_str>
            <room_rate>88.88</room_rate>
            <biz_circles>万达广场</biz_circles>
            <face>1-朝东 2-朝南 3-朝西 4-朝北 5-西北 6-东北 7-东南 8-西南 9-东西 10-南北</face>
            <detail_address>杭州市余杭区永福小区</detail_address>
            <has_elevator>0-无电梯 1-有电梯</has_elevator>
            <has_check_certificate>true/false</has_check_certificate>
            <inner_area>88.88</inner_area>
            <category_id>50023914</category_id>
            <tags>南北通透</tags>
            <has_parking>1</has_parking>
            <look_time>周末可看</look_time>
            <sale_reason>破产</sale_reason>
            <situation>1</situation>
            <ownership_address>房产证显示地址</ownership_address>
            <is_only_house>true/false</is_only_house>
            <layout_pictures_image>
                <image_info_v_o>
                    <type>0</type>
                    <url>https://img.alicdn.xxxx.jpg</url>
                </image_info_v_o>
            </layout_pictures_image>
            <bed_room_cnt>1</bed_room_cnt>
            <living_room_cnt>0</living_room_cnt>
            <bath_room_cnt>0</bath_room_cnt>
        </data>
        <success>true/false</success>
        <error_code>UNAUTHORIZED_PLAT_ACCESS</error_code>
        <error_msg>房源机构没有权限</error_msg>
    </result>
</alibaba_idle_new_house_item_query_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部