【贝壳找房API】贝壳找房 (Beike) 数据采集指南
贝壳找房数据采集有两种主要路径：官方开放平台 API 接入（推荐，合法合规）和非官方爬虫采集（存在法律与技术风险）。以下是完整方案与注意事项。
一、官方推荐：贝壳开放平台 API 接入
1. 平台简介与核心优势
贝壳开放平台 提供标准化 API 接口，基于 "楼盘字典" 核心数据，覆盖全国 100 + 城市、2 亿 + 套房屋数据，通过433 个字段标签构建精细化房屋画像贝壳开放平台。
- 优势：合法合规、数据精准、接口稳定、官方技术支持、规避法律风险
2. 核心数据服务
| 服务类型 | 数据内容 | 适用场景 |
|---|---|---|
| 数据验真 | 房屋小区基础信息、产权核验 | 房产交易、金融风控 |
| 房屋价值分析 | 房价评估、成交趋势、市场分析 | 房产估价、投资决策 |
| 商房直连 | 商业房源数据同步、经纪人直连 | 商业地产运营 |
| 楼盘字典 | 标准化房屋基础数据（户型、面积、建成年代等） | 全场景房产数据应用 |
3. 接入流程（3 步快速上手）
- 注册认证：访问开放平台，完成企业 / 个人实名认证
- 创建应用：控制台→应用管理→我的应用→创建应用，获取AK (Appkey) 和 SK (AppSecret)
- 调用接口：查阅技术文档，使用 AK/SK 生成 access_token，发起 API 请求
4. API 调用示例（Python）
python
运行
import requests import hashlib import time # 配置参数 AK = "你的AppKey" SK = "你的AppSecret" timestamp = str(int(time.time())) api_url = "https://api.ke.com/data/verify" # 生成签名（官方认证机制） sign_str = f"{AK}{timestamp}{SK}" sign = hashlib.md5(sign_str.encode()).hexdigest() # 请求头与参数 headers = { "Content-Type": "application/json", "AK": AK, "timestamp": timestamp, "sign": sign } params = { "city_code": "110000", # 北京城市编码 "house_id": "101102345678" # 房源ID } # 发起请求 response = requests.get(api_url, headers=headers, params=params) if response.status_code == 200: data = response.json() print("房屋数据:", data) else: print("请求失败:", response.text)二、非官方采集：爬虫技术方案（需谨慎）
1. 核心技术思路
贝壳网页采用动态渲染 + AJAX 异步加载，真实数据通过 JSON 接口返回，可通过以下方式获取：
- 浏览器 F12 开发者工具→Network→XHR，捕获真实数据接口
- 分析请求参数（house_id、city_code、sign、token 等）
- 模拟浏览器请求头，发送 HTTP 请求获取 JSON 数据
2. 基础 Python 爬虫示例（小区列表）
python
运行
import requests from bs4 import BeautifulSoup import time import random # 配置 city = "bj" # 北京 base_url = f"https://{city}.ke.com/xiaoqu/" headers = { "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36", "Cookie": "你的Cookie（登录后获取）" } # 获取小区总数 def get_total_count(): response = requests.get(base_url, headers=headers) soup = BeautifulSoup(response.text, "lxml") total_text = soup.find("div", class_="total fl").text return int(total_text.split("共")[1].split("个")[0]) # 爬取小区列表 def crawl_communities(): total = get_total_count() pages = total // 20 + 1 # 每页20条 result = [] for page in range(1, pages + 1): url = f"{base_url}pg{page}/" response = requests.get(url, headers=headers) soup = BeautifulSoup(response.text, "lxml") communities = soup.find_all("li", class_="clear xiaoquListItem") for comm in communities: data = { "name": comm.find("div", class_="title").a.text, "price": comm.find("div", class_="totalPrice").span.text, "address": comm.find("div", class_="positionInfo").a.text } result.append(data) time.sleep(random.uniform(2, 5)) # 随机延迟，规避反爬 print(f"已爬取第{page}/{pages}页，累计{len(result)}个小区") return result # 执行爬虫 if __name__ == "__main__": communities_data = crawl_communities() print("爬取完成，共获取", len(communities_data), "个小区数据")3. 反爬机制与应对策略
| 反爬手段 | 应对方法 | 风险等级 |
|---|---|---|
| UA 检测 | 封装浏览器请求头，如 Chrome、Firefox 官方 UA | 低 |
| IP 封禁 | 使用代理 IP 池（建议高匿代理）、控制并发数 | 中 |
| Cookie 验证 | 模拟登录获取有效 Cookie，定期更新 | 中 |
| 动态 Token/sign | 逆向 JS 生成逻辑（高风险，可能违法） | 极高 |
| 滑块 / 图形验证 | Selenium+OCR 识别（复杂，成本高） | 高 |
三、法律合规红线（必须遵守）
1. 核心法律风险
- 反不正当竞争法：法院已认定贝壳房源数据库受法律保护，未经授权批量爬取构成不正当竞争
- 计算机犯罪：破解验签算法、绕过验证获取数据，可能涉嫌 "非法获取计算机信息系统数据罪"，已有判例主犯获刑三年六个月
- 版权侵权：户型图、房源图片等原创内容受版权保护，禁止未经授权使用
- 个人信息保护法：禁止采集房东联系方式、身份证号等隐私数据贝壳
2. 合规采集原则
- 优先官方 API：这是唯一合法合规的商业用途数据获取方式
- 最小必要原则：只采集业务必需数据，不采集隐私与版权内容
- 尊重 robots.txt：查看，遵守禁止访问指令
- 控制请求频率：设置≥3 秒请求间隔，避免服务器压力过大
- 非商业用途：学术研究需注明数据来源，禁止转售数据
四、方案选择建议
| 采集场景 | 推荐方案 | 原因 |
|---|---|---|
| 商业应用 | 贝壳开放平台 API | 合法合规，数据稳定，支持商业用途 |
| 个人学习 / 研究 | 小规模爬虫 + 严格限制 | 仅供学习，不用于商业，控制爬取量 |
| 房产数据分析 | 开放平台 + 第三方数据服务 | 兼顾合规性与数据全面性 |
| 大规模数据采集 | 官方定制化合作 | 保障数据安全与长期使用权限 |
五、总结与行动清单
- 首选官方 API：访问贝壳开放平台，完成注册认证，申请所需数据服务
- 技术准备：获取 AK/SK，阅读 API 文档，开发对接程序