贝壳获取二手房列表

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

贝壳房源

🔒

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

按城市 / 小区分页获取在售二手房列表。

请求参数

参数名	类型	必填	默认值	说明
token	string	是	-	你的访问令牌（通过 query 传递）
city	string	是	-	城市拼音
community_id	string	否	-	小区 ID（可选）
page	number	否	1	页码

代码示例

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

cURL

curl -X POST 'https://<your_endpoint>/api/beike/house-list-v1?token=YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"city":"bj","community_id":"c_1","page":1}'

Python

import requests

resp = requests.post(
    "https://<your_endpoint>/api/beike/house-list-v1",
    params={"token": "YOUR_TOKEN"},
    json={
      "city": "bj",
      "community_id": "c_1",
      "page": 1
    },
    timeout=60,
)
print(resp.json())

Node.js

const resp = await fetch('https://<your_endpoint>/api/beike/house-list-v1?token=YOUR_TOKEN', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"city":"bj","community_id":"c_1","page":1}),
})
console.log(await resp.json())

响应结果示例

成功响应

{
  "code": 0,
  "message": "ok",
  "data": {
    "city": "bj",
    "total": 12800,
    "list": [
      {
        "house_id": "bk_1",
        "title": "示例房源",
        "total_price": "520万",
        "area": "89㎡"
      }
    ]
  }
}

错误响应

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