安居客房产数据平台：根据房屋ID获取详情数据的API接口解析

​

在房产数据分析和应用开发中，安居客作为国内重要的平台之一，其数据具有很高的参考价值。本文将探讨安居客平台中一个核心功能：根据房屋ID获取房屋详情数据的API接口。这对于需要批量获取房源信息、进行数据分析或构建房产应用的开发者而言至关重要。

1. 接口核心功能

该API接口的核心功能是：输入一个有效的安居客房源ID，接口将返回该房源对应的结构化详情数据。返回的数据通常包含：

房源基础信息（标题、价格、面积、户型）

位置信息（小区名称、行政区、商圈、经纬度）

房源描述与特色

图片/VR链接

经纪人/开发商信息

发布时间、更新时间等元数据

2. 接口请求方式与地址

请求方法 (HTTP Method): 通常为 GET 或 POST。

接口地址 (Endpoint URL): 安居客平台的API地址结构通常有其特定模式，例如：

https://api.anjuke.com/property/v1/detail?property_id={house_id}

或

https://api.anjuke.com/mobile/v5/property/detail?proid={house_id}

(注意：实际地址可能随版本更新而变化，请以官方文档或最新网络请求为准)。

3. 关键请求参数

最主要的参数就是房屋ID (house_id 或 proid)：

该ID是安居客平台分配给每套房源的唯一标识符。

通常可通过安居客网站或APP的房源详情页URL中提取。例如，URL https://www.anjuke.com/fangyuan/{house_id} 中的 {house_id} 部分即是所需ID。

4. 身份认证与授权

访问安居客的API接口通常需要身份认证：

API Key: 开发者需要注册安居客开放平台账号，申请API Key。请求时需将此Key作为参数（如 ak=YOUR_API_KEY）或放在HTTP Header（如 Authorization: Bearer YOUR_API_KEY）中传递。

访问令牌 (Access Token): 对于更复杂的授权流程，可能需要使用OAuth等机制获取Token。

5. 接口响应格式

安居客API通常返回JSON格式的数据，结构清晰，易于解析。一个简化的响应示例可能如下：

{
    "code": 200,
    "message": "success",
    "data": {
        "property_id": "1234567890",
        "title": "朝阳公园旁 南北通透三居室",
        "price": 8500000,
        "unit_price": 95000,
        "area": 89.5,
        "layout": "3室2厅1卫",
        "community": {
            "name": "阳光上东",
            "district": "朝阳区",
            "bizcircle": "朝阳公园"
        },
        "location": {
            "lng": 116.480881,
            "lat": 39.948708
        },
        "description": "满五唯一，业主诚心出售...",
        "images": [
            "https://img1.anjuke.com/pic1.jpg",
            "https://img1.anjuke.com/pic2.jpg"
        ],
        "agent": {
            "name": "张经理",
            "company": "链家地产"
        },
        "publish_time": "2023-10-15 10:30:00"
    }
}

6. 使用Python调用示例

假设我们已获得合法的API Key和接口地址，以下是一个使用Python requests 库调用该接口的简单示例：

import requests

# 替换为你的实际API Key和房屋ID
API_KEY = "YOUR_AK"
HOUSE_ID = "1234567890"  # 示例ID
ENDPOINT_URL = "https://api.anjuke.com/property/v1/detail"  # 示例地址，以实际为准

# 构造请求参数
params = {
    "property_id": HOUSE_ID,
    "ak": API_KEY
}

try:
    # 发送GET请求
    response = requests.get(ENDPOINT_URL, params=params)
    response.raise_for_status()  # 检查HTTP错误

    # 解析JSON响应
    data = response.json()
    if data["code"] == 200:  # 假设200表示成功
        house_detail = data["data"]
        print(f"房源标题: {house_detail['title']}")
        print(f"价格: {house_detail['price']}元")
        print(f"面积: {house_detail['area']}平方米")
        print(f"所在小区: {house_detail['community']['name']}")
        # ... 处理其他所需字段
    else:
        print(f"接口返回错误: {data['message']} (代码: {data['code']})")

except requests.exceptions.RequestException as e:
    print(f"网络请求出错: {e}")
except ValueError:
    print("解析JSON响应失败")

7. 注意事项

遵守协议: 务必仔细阅读并遵守安居客开放平台的《API使用协议》，尊重数据版权，避免滥用。

频率限制: API通常有调用频率限制（QPS），超出限制可能导致请求失败或被封禁。

字段变动: 返回字段名称、结构或含义可能随平台升级而变化，代码需具备一定容错性。

数据抓取道德: 仅获取公开数据，避免侵犯隐私或干扰平台正常服务。

8. 应用场景

掌握此接口可用于：

构建房产数据监控与分析系统

开发比价工具或房源推荐应用

进行区域房价趋势研究

自动化生成房源报告

总结：安居客根据房屋ID获取详情的API是接入其房产数据生态的关键入口。开发者需关注接口地址、认证方式、参数传递和响应解析。在使用过程中，务必合法合规，并做好错误处理和接口变更的应对预案。

​审核编辑 黄宇