怎么调用 Zillow 关键词搜索 API?
search使用 platform="zillow"、action="search" 调用“关键词搜索”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 zpid、url、status、status_type、price、currency 等 30 个字段。
Zillow search 的参数分别是什么意思?
keyword必填- 城市、地区或邮编位置文本,例如 Austin, TX 或 78701;不是房源描述关键词。
Zillow 官方说明可按城市、街区、ZIP、县、州和自然语言条件搜索 homes 或 rentals,并结合价格、卧卫、面积等条件;它不证明 EveryInfra 的 category、sort、价格口径、extraction_method 或仅有特定排序值。官方来源:Zillow:自然语言和地点房源搜索来源核查:
category可选- 位置类型,不是房屋类型:auto_detect 自动、address 地址、borough 行政区、city 城市、county 县、flex_region 灵活区域、neighborhood 街区、school 学校、state 州、zipcode 邮编。
查看全部 10 个允许值
addressauto_detectboroughcitycountyflex_regionneighborhoodschoolstatezipcode max_price可选- 最高房源价格,整数;出租搜索按周租金理解,与 min_price 配合。
min_price可选- 最低房源价格,整数;出租搜索按周租金理解,不是 API 调用费用。
sort可选- 房源排序:newest 最新挂牌、recently_changed 最近变更、relevance 相关性、price_asc/price_desc 价格、bedrooms 卧室数、bathrooms 卫浴数、sqft 室内面积、lot_size 地块面积、year_built 建造年份。
查看全部 10 个允许值
bathroomsbedroomslot_sizenewestprice_ascprice_descrecently_changedrelevancesqftyear_built
Zillow 特有返回字段与含义(23)
- zpid
- Zillow 内部房源 ID,该站的主键。
- beds
- 卧室数量,与 bedrooms 同义。
- baths
- 卫生间数量,与 bathrooms 同义。
- area_sqft
- 室内面积,单位平方英尺(1 平方米 ≈ 10.76 平方英尺)。
- lot_area_value
- 地块面积数值,单位见 lot_area_unit —— 两个字段要一起读。
- lot_area_unit
- 地块面积单位(sqft 平方英尺 / acres 英亩)。
- home_type
- 房屋类型,原平台分类(SINGLE_FAMILY / CONDO / TOWNHOUSE 等)。
- home_status
- 房源状态(FOR_SALE / FOR_RENT / SOLD / PENDING 等)。
- status
- 房源状态,与 home_status 同义。
- status_type
- 状态分类,比 status 更粗的一层。
- zestimate
- Zillow 估价模型给出的房屋估值。不是成交价也不是挂牌价。
- rent_zestimate
- Zillow 估算的月租金,同样是模型值不是实际租金。
- days_on_zillow
- 在 Zillow 上的挂牌天数。数值大通常意味着不好卖或定价偏高。
- tax_assessed_value
- 税务评估价值,政府计税用,通常低于市场价。
- broker_name
- 挂牌经纪公司名称。
- is_zillow_owned
- 是否为 Zillow 自持房源(Zillow Offers 收购的房子)。
- has_3d_model
- 是否有 3D 看房模型。
- has_video
- 是否有视频。
- street
- 街道地址。
- zipcode
- 邮编。
- state
- 州。
- latitude
- 纬度。
- longitude
- 经度。