?

在房產數據分析和應用開發中，安居客作為國內重要的平臺之一，其數據具有很高的參考價值。本文將探討安居客平臺中一個核心功能：根據房屋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是接入其房產數據生態的關鍵入口。開發者需關注接口地址、認證方式、參數傳遞和響應解析。在使用過程中，務必合法合規，并做好錯誤處理和接口變更的應對預案。

?審核編輯 黃宇