Mengikis data hartanah dengan Python untuk mencari peluang

Tutorial ini akan meneroka cara menggunakan perpustakaan permintaan Python untuk mengikis data hartanah daripada API. Kami juga akan mempelajari cara menggunakan penapis untuk mendapatkan semula hartanah yang berpotensi tawar-menawar yang telah menurunkan harganya baru-baru ini.

---

Pengenalan

Apabila mencari peluang pelaburan hartanah yang hebat, pengurangan harga terkini selalunya merupakan salah satu petunjuk terpenting. Mempunyai alat yang memaparkan sifat ini dengan cepat boleh menjimatkan banyak masa dan boleh membantu anda memulakan sebelum orang lain menyedarinya!

Dalam artikel ini kami akan:

1. Bincangkan asas berinteraksi dengan API hartanah menggunakan permintaan.
2. Ketahui cara menggunakan parameter pertanyaan untuk menapis hasil—terutama memfokuskan pada pertanyaan perubahan harga.
3. Menghuraikan dan memaparkan data yang dikembalikan dalam format ringkas.

---

Keperluan

• DipasangPython 3
• Terminal atau gesaan baris arahan
• Familiar dengan asas perpustakaan permintaan Python
• Kunci API (jika diperlukan oleh API)

---

Langkah 1: Fahami API

API yang kami gunakan mungkin mengembalikan data berikut:

• ID Harta
• Tajuk atau alamat
• Harga
• Lokasi
• Perubahan Harga Bersejarah
• Maklumat lain yang berkaitan

Parameter pertanyaan utama

API ini menyokong berbilang parameter pertanyaan yang membantu kami menapis hasil:

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

Kami akan memberi perhatian khusus kepada parameter **eventPriceVariation** untuk **mencari hartanah** yang telah turun harga.

---

Langkah 2: Buat Permintaan

Berikut ialah skrip contoh untuk menanyakan titik akhir menggunakan perpustakaan permintaan Python. Laraskan parameter dan pengepala seperti yang diperlukan, terutamanya jika X-API-KEY diperlukan.

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}")

Perihalan parameter penting

eventPriceVariationMin = '-10'

Ini bermakna anda sedang mencari penurunan harga sekurang-kurangnya 10%.

eventPriceVariationMax = '0'

Menetapkan ini kepada 0 memastikan anda tidak memasukkan hartanah yang mengalami kenaikan harga atau sebarang perubahan melebihi 0%. Pada asasnya, anda menangkap perubahan negatif atau sifar.

? Petua: Laraskan nilai min/maks agar sesuai dengan strategi anda. Sebagai contoh, -5 dan 5 akan termasuk perubahan harga dalam ±5%.

Potensi perangkap dan langkah berjaga-jaga

1. Pengesahan: Sentiasa pastikan anda menggunakan kunci API yang sah. Sesetengah API juga mempunyai had kadar atau kuota penggunaan.
2. Ralat pengendalian: Kendalikan situasi di mana API turun atau parameter tidak sah.
3. Pengesahan Data: API mungkin mengembalikan data yang tidak lengkap untuk beberapa senarai. Sentiasa semak medan yang tiada.
4. Format Tarikh: Pastikan fromDate dan toDate anda berada dalam format yang diiktiraf oleh API (cth., YYYY-MM-DD).
5. Set Data Besar: Jika API mengembalikan ratusan atau ribuan senarai, penomboran mungkin diperlukan. Semak sama ada parameter paging seperti halaman atau had wujud dalam dokumen API.

---

Ringkasan

Kini anda mempunyai skrip Python asas untuk merangkak data hartanah, memfokuskan pada hartanah yang telah turun harga. Kaedah ini boleh menjadi sangat berkuasa jika anda ingin melabur dalam hartanah, atau hanya mahu menjejaki trend pasaran.

Seperti biasa, sila laraskan parameter kepada keperluan khusus anda. Anda boleh melanjutkan skrip ini untuk mengisih hasil mengikut harga, menyepadukan analitis lanjutan dan juga memasukkan data ke dalam model pembelajaran mesin untuk mendapatkan cerapan yang lebih mendalam.

Selamat memburu dan semoga anda menemui permata tersembunyi!

---

Bacaan lanjut

• Python Meminta Dokumentasi
• Perbandingan API Data Hartanah
• API Estet Strim
• Inti Utama API Data Hartanah

Atas ialah kandungan terperinci Mengikis data hartanah dengan Python untuk mencari peluang. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!