?

在房產數據應用開發中，獲取精準的房源信息是關鍵。貝殼找房作為國內領先的房產平臺，其數據接口為開發者提供了豐富的房源詳情信息。本文將從技術角度分析如何調用貝殼找房的二手房詳情API接口，并給出實際代碼示例。

一、API接口基本結構

貝殼找房的二手房詳情接口通常采用RESTful風格設計，通過HTTP GET請求獲取數據。核心參數包括：

房源ID（house_id）：唯一標識符

城市編碼（city_code）：定位城市區域

認證令牌（access_token）：權限校驗

典型請求URL格式示例：

https://api.ke.com/ershoufang/detail?house_id=101102345678&city_code=110000&access_token=xxxxxx

二、響應數據結構解析

成功調用接口后，返回的JSON數據通常包含以下關鍵字段：

{
  "code": 200,
  "message": "success",
  "data": {
    "basic": {
      "title": "朝陽公園旁南北通透三居室",
      "total_price": 850,
      "unit_price": 78000,
      "room": 3,
      "hall": 2,
      "area": 109.5,
      "orientation": "南"
    },
    "position": {
      "district": "朝陽區",
      "community": "泛海國際",
      "subway": "14號線東風北橋站800米"
    },
    "transaction": {
      "listing_date": "2023-05-20",
      "last_trade": "2020-08-15"
    },
    "images": [
      {"url": "https://img1.ke.com/pic1.jpg", "type": "living_room"},
      {"url": "https://img1.ke.com/pic2.jpg", "type": "bedroom"}
    ]
  }
}

三、Python調用示例

使用requests庫實現基礎調用：

import requests
import json

def get_house_detail(house_id, city_code, access_token):
    url = "https://api.ke.com/ershoufang/detail"
    params = {
        "house_id": house_id,
        "city_code": city_code,
        "access_token": access_token
    }
    
    try:
        response = requests.get(url, params=params, timeout=10)
        if response.status_code == 200:
            data = json.loads(response.text)
            if data.get('code') == 200:
                return data['data']
            else:
                print(f"API錯誤: {data.get('message')}")
        else:
            print(f"HTTP錯誤: {response.status_code}")
    except Exception as e:
        print(f"請求異常: {str(e)}")
    
    return None

# 示例調用
house_data = get_house_detail("101102345678", "110000", "your_token_here")
if house_data:
    print(f"房源標題: {house_data['basic']['title']}")
    print(f"總價: {house_data['basic']['total_price']}萬")

四、關鍵技術要點

反爬機制應對

設置合理的請求間隔（建議≥3秒）

使用動態User-Agent頭部

通過官方渠道申請合法access_token

數據更新策略

# 使用Redis記錄最后更新時間
redis_key = f"ke_house:{house_id}:last_update"
if not redis.exists(redis_key) or time.time() - float(redis.get(redis_key)) > 86400:
    # 超過24小時更新數據
    update_data(house_id)

異常處理

捕獲JSONDecodeError處理格式錯誤

監控429狀態碼（請求頻次限制）

實現自動重試機制（帶指數退避）

五、注意事項

嚴格遵守《數據安全法》和平臺用戶協議

敏感字段（如業主聯系方式）需脫敏處理

建議使用官方SDK（若有提供）

大規模采集需提前聯系平臺開放平臺部門

注：本文僅作技術交流，實際接口參數請以貝殼找房開放平臺最新文檔為準。

通過合理使用API接口，開發者可以構建基于實時房產數據的創新應用，但務必注意合規性和數據安全。建議定期檢查接口變更，保持代碼的持續適應性。

?審核編輯 黃宇