怎么调用 Crexi 关键词搜索 API?
search使用 platform="crexi"、action="search" 调用“关键词搜索”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 id、url、name、text、address、city 等 23 个字段。
Crexi search 的参数分别是什么意思?
keyword必填- Crexi 商业地产搜索的美国州代码,例如 TX、CA、FL,不是物业名称全文搜索;提供 states 或 state 时会覆盖这个州选择,但请求仍需包含必填 keyword。
max_price可选- 搜索挂牌要价上限,以 USD 表示,会转换为整数。即使有价格条件,结果仍可能包含未公开要价的物业;不能保证每条都有价格。
min_price可选- 搜索挂牌要价下限,以 USD 表示;传数字,建议整数。它不是资本化率或每平方英尺价格;直接 property_detail 查询忽略搜索筛选。
property_types可选- 商业地产资产类型,英文字符串或字符串数组,例如 Office(办公)、Retail(零售)、Multifamily(多户住宅)。这是搜索筛选,不是住宅户型;property_detail 的直接 ID 查询忽略这些筛选。
sort可选- 搜索排序:relevance 为目录相关度,newest 为房源发布顺序;均按降序,默认 relevance。不是 last_updated 或资本化率排序;直接 ID 查询不使用排序。
查看全部 2 个允许值
newestrelevance state可选- 单个美国州代码,例如 TX;states 未提供时才读取,并优先于 keyword。查询多个州建议使用 states 数组。
states可选- 美国州代码,可传字符串或数组,例如 TX 或 ["TX", "CA"],会转换为大写。优先级为 states > state > keyword;不是城市名或国家码。
transaction_type可选- 搜索交易类型只接受 sale(出售)或 lease(出租),忽略大小写;省略时默认 sale。rent 等其他显式值会在公开 API 参数校验阶段返回 422,不会静默改成出售。
Crexi 的搜索说明先区分 Sale(出售)和 Lease(出租)。这里只引用交易类型,不表示本接口包含文中地图图层、人口数据或交通流量功能。官方来源:Crexi:Sale 与 Lease 房源搜索来源核查:
查看全部 2 个允许值
leasesale
Crexi 特有返回字段与含义(13)
- property_types
- 物业类型(办公/零售/工业/多户)。
- area_sqft
- 面积,平方英尺。
- in_opportunity_zone
- 是否在机会区(美国税收优惠区,影响投资回报计算)。
- is_unpriced
- 是否未标价。商业地产大量标的是「询价」,筛选时注意。
- is_sold
- 是否已成交。
- status
- 状态。
- updated_at
- 更新时间。
- brokerage_name
- 经纪公司。
- county
- 所属县。
- state
- 州。
- postal_code
- 邮编。
- latitude
- 纬度。
- longitude
- 经度。