使用 Python 抓取房地產資料來尋找機會

本教學將探討如何使用Python的requests函式庫從API中抓取房地產資料。我們還將學習如何應用過濾器來檢索最近降價的潛在廉價房產。

---

引言

尋找絕佳房地產投資機會時，近期降價往往是最重要的指標之一。擁有一個能快速顯示這些房產的工具可以節省大量時間，並可能幫助您在其他人注意到之前搶佔先機！

在本篇文章中，我們將：

1. 討論使用requests與房地產API互動的基礎知識。
2. 學習如何使用查詢參數過濾結果－尤其關注價格變化查詢。
3. 以簡潔的格式解析並顯示傳回的資料。

---

需求

• 已安裝Python 3
• 終端機或命令列提示符
• 熟悉Python requests函式庫的基礎知識
• API金鑰（如果API需要）

---

步驟1：了解API

我們使用的API可能會傳回以下資料：

• 房產ID
• 標題或地址
• 價格
• 位置
• 歷史價格變動
• 其他相關資訊

關鍵查詢參數

此API支援多個幫助我們過濾結果的查詢參數：

参数	类型	描述
**includedDepartments[]**	数组	按部门过滤。示例：departments/77
**fromDate**	日期	仅检索在此日期之后列出（或更新）的房产。
**propertyTypes[]**	数组	按房产类型过滤。示例：0代表公寓，1代表房屋，等等。
**transactionType**	字符串	0代表出售，1代表出租，等等。
**withCoherentPrice**	布尔值	仅检索价格与市场价格一致的房产。
**budgetMin**	数字	最低预算阈值。
**budgetMax**	数字	最高预算阈值。
**eventPriceVariationFromCreatedAt**	日期	创建价格类型事件的日期——包含在内。
**eventPriceVariationMin**	数字	价格变化的最小百分比（负数或正数）。

我們將特別關注**eventPriceVariation**參數來**查找價格下降的房產**。

---

步驟2：建立請求

以下是使用Python的requests函式庫查詢端點的範例腳本。根據需要調整參數和標頭，尤其是在需要X-API-KEY的情況下。

<code class="language-python">import requests
import json

# 1. 定义端点URL
url = "https://api.stream.estate/documents/properties"

# 2. 创建参数
params = {
    'includedDepartments[]': 'departments/77',
    'fromDate': '2025-01-10',
    'propertyTypes[]': '1',    # 1可能代表“公寓”
    'transactionType': '0',    # 0可能代表“出售”
    'withCoherentPrice': 'true',
    'budgetMin': '100000',
    'budgetMax': '500000',
    # 关注价格变化
    'eventPriceVariationFromCreatedAt': '2025-01-01',  # 从年初开始
    'eventPriceVariationMin': '-10',  # 至少下降10%
}

# 3. 使用API密钥定义标头
headers = {
  'Content-Type': 'application/json',
  'X-API-KEY': '<your_api_key_here>'
}

# 4. 发出GET请求
response = requests.get(url, headers=headers, params=params)

# 5. 处理响应
if response.status_code == 200:
    data = response.json()
    print(json.dumps(data, indent=2))
else:
    print(f"请求失败，状态码为{response.status_code}")</code>

重要參數說明

eventPriceVariationMin = '-10'

這意味著您正在尋找至少下降10%的價格。

eventPriceVariationMax = '0'

將其設定為0可確保您不包含價格上漲或任何高於0%的變化的房產。從本質上講，您捕獲的是負變化或零變化。

? 提示：調整最小/最大值以適應您的策略。例如，-5和5將包括±5%範圍內的價格變化。

潛在陷阱與注意事項

1. 驗證: 請務必確保您使用有效的API金鑰。某些API還具有速率限製或使用配額。
2. 錯誤處理: 處理API停機或參數無效的情況。
3. 資料驗證: API可能傳回某些清單的非完整資料。始終檢查是否存在缺失字段。
4. 日期格式: 確保您的fromDate和toDate採用API辨識的格式（例如，YYYY-MM-DD）。
5. 大型資料集: 如果API傳回數百或數千個列表，則可能需要分頁。檢查API文件中是否存在page或limit等分頁參數。

---

總結

現在，您擁有一個基本的Python腳本來抓取房地產數據，重點關注價格下降的房產。如果您想投資房地產，或者只是想追蹤市場趨勢，這種方法可能非常強大。

與以​​往一樣，請依照您的特定需求調整參數。您可以擴充此腳本以按價格排序結果、整合進階分析，甚至將資料插入機器學習模型以獲得更深入的見解。

祝您抓取愉快，願您找到隱藏的寶石！

---

進一步閱讀

• Python Requests文件
• 房地產資料API比較
• Stream Estate API
• 房地產資料API的要點

以上是使用 Python 抓取房地產資料來尋找機會的詳細內容。更多資訊請關注PHP中文網其他相關文章！