贝壳获取房源详情

POST🔗 /api/beike/house-detail-v1🔒 需开通

贝壳房源

🔒

该接口需开通后调用暂未开放自助调用。联系销售为你的账号开通权限并发放调用 token。

根据房源 ID 获取价格、面积、户型等。

请求参数

参数名	类型	必填	默认值	说明
token	string	是	-	你的访问令牌（通过 query 传递）
house_id	string	是	-	房源 ID

代码示例

环境地址：示例中的 https://<your_endpoint> 为占位符，请替换为客服为你分配的专属接入地址（详见快速开始）。

cURL

curl -X POST 'https://<your_endpoint>/api/beike/house-detail-v1?token=YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"house_id":"1234567890"}'

Python

import requests

resp = requests.post(
    "https://<your_endpoint>/api/beike/house-detail-v1",
    params={"token": "YOUR_TOKEN"},
    json={
      "house_id": "1234567890"
    },
    timeout=60,
)
print(resp.json())

Node.js

const resp = await fetch('https://<your_endpoint>/api/beike/house-detail-v1?token=YOUR_TOKEN', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"house_id":"1234567890"}),
})
console.log(await resp.json())

响应结果示例

成功响应

{
  "code": 0,
  "message": "ok",
  "data": {
    "house_id": "bk_1",
    "title": "示例房源",
    "total_price": "520万",
    "area": "89㎡"
  }
}

错误响应

{
  "code": 303,
  "message": "采集失败，请稍后重试",
  "data": null
}