接口地址、调用示例，点一下就能复制。

公开查询无需密钥；增量检查、AI 回写和图片上传使用同一个 Bearer Token。页面不会保存你输入的令牌。

无需鉴权

读取与组合查询

GET 或 POST JSON，返回分页记录、单条裁图、完整原图与裁剪坐标。

Bearer Token

增量检查与写入

幂等检查新文章、保存原图，再回写 AI 结构化结果。

每日运行

自动定时执行

ECS 每天北京时间 09:30 自动拉取、归档原图并执行本地 OCR。

写入令牌

可选。填入后，下方写入示例和任务提示词会自动变成可直接复制的版本；令牌只保存在当前页面内存，不会上传或持久化。

公开只读查询 API

不接受 SQL，只接受白名单参数；GET 与 POST 的能力一致。

OpenAPI JSON

GET / POSThttps://hotel.xbrain.site/api/query

公开读取

cURL · GET 组合查询

curl --get 'https://hotel.xbrain.site/api/query' \
  --data-urlencode 'district=德胜' \
  --data-urlencode 'minArea=60' \
  --data-urlencode 'maxArea=100' \
  --data-urlencode 'maxPrice=800' \
  --data-urlencode 'sort=unit-asc' \
  --data-urlencode 'pageSize=20'

cURL · POST JSON

curl -X POST 'https://hotel.xbrain.site/api/query' \
  -H 'Content-Type: application/json' \
  -d '{
    "keyword": "三里河 南北",
    "startDate": "2026-01-01",
    "endDate": "2026-12-31",
    "minArea": 60,
    "maxArea": 120,
    "minPrice": 300,
    "maxPrice": 1000,
    "sort": "newest",
    "page": 1,
    "pageSize": 24
  }'

AI 全库读取顺序

先调用目录接口，并持续请求返回的 nextPageUrl，直到 nextCursor 为 null；再使用每项 detailUrl 逐条读取完整字段、独立裁图和原图。目录游标固定同一次遍历的数据快照，更新期间也不会跳项。

cURL · 遍历全部房源目录

curl --get 'https://hotel.xbrain.site/api/query/catalog' \
  --data-urlencode 'limit=500'

cURL · 按 recordId 查完整详情

curl 'https://hotel.xbrain.site/api/query/records/RECORD_ID_FROM_CATALOG'

文字条件

keyword, community, district, school, orientation, floorBand, reviewStatus, articleId

日期与户型

startDate, endDate, bedrooms, livingRooms, bathrooms, minFloor, maxFloor, minFloorTotal, maxFloorTotal

数值区间

minListPrice/maxListPrice, minPrice/maxPrice, minArea/maxArea, minUnitPrice/maxUnitPrice, minNegotiation/maxNegotiation, minCycleDays/maxCycleDays, minConfidence

分页与排序

page, pageSize；sort 支持 newest、oldest、price、area、unit、discount、cycle 的升降序

每条结果都包含独立成交字段；一张图有多笔成交时，还会返回sourceRecordIndex与sourceRegion，用于从同一份原图中定位对应小区。imageUrl是本条房源的独立裁图，originalImageUrl则始终指向完整原图。