点评口碑 · 数据 API

Zillow

Zillow API

按城市或 ZIP 邮编查找 Zillow 房源,读取住宅详情与经纪人资料,分开保存挂牌价、Zestimate 和租金估计,供美国住宅市场资料整理使用。 调用 POST /api/v1/social ;返回结构化 JSON,$1.39 / 千次;失败不计费。

5

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Zillow 能力清单

action必填参数可选参数单次条数模式单价返回字段
searchkeywordcategory, max_price, min_price, sort默认 20 · 最多 200同步$1.39 / 千次zpid · url · status · status_type · price · currency · address · street · city · state · zipcode · latitude · longitude · beds · baths · area_sqft · home_type · home_status · zestimate · rent_zestimate · tax_assessed_value · lot_area_value · lot_area_unit · days_on_zillow · broker_name · is_zillow_owned · has_3d_model · has_video · image_url · platform
zip_searchzipdays_on_zillow, for_rent, for_sale_by_agent, for_sale_by_owner, max_price, min_price, sold—同步$1.39 / 千次zpid · url · status · status_type · price · currency · address · street · city · state · zipcode · latitude · longitude · beds · baths · area_sqft · home_type · home_status · zestimate · rent_zestimate · tax_assessed_value · lot_area_value · lot_area_unit · days_on_zillow · broker_name · is_zillow_owned · has_3d_model · has_video · image_url · platform
profileurlproperty_status—同步$1.39 / 千次zpid · url · home_status · home_type · price · currency · address · city · state · zipcode · county · latitude · longitude · beds · baths · area_sqft · lot_area_value · lot_area_unit · year_built · price_per_sqft · hoa_fee · has_garage · parking_capacity · zestimate · rent_zestimate · zestimate_low_percent · zestimate_high_percent · tax_assessed_value · tax_assessed_year · property_tax_rate · last_sold_price · last_sold_at · days_on_zillow · photo_count · description · listing_agent · listing_agent_phone · listing_broker · mls_id · mls_name · platform · images · price_history · schools
property_detailurl——同步$1.39 / 千次id · url · address · city · state · postal_code · latitude · longitude · price · zestimate · rent_zestimate · tax_assessed_value · status · home_type · bedrooms · bathrooms · area_sqft · lot_size · year_built · days_on_market · text · image_url · photo_count · platform
agentskeywordbrokerage, city, min_rating默认 20 · 最多 200同步$1.39 / 千次id · url · name · business_name · types · address · city · state · postal_code · phone · rating · rating_scale · review_count · is_top_agent · avatar_url · platform

Zillow 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

怎么调用 Zillow 主页或对象详情 API?

profile

使用 platform="zillow"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 zpid、url、home_status、home_type、price、currency 等 44 个字段。

Zillow 将 Zestimate 定义为住宅市场价值的模型估计,明确它不是专业估价,也不能替代专业估价;缺少足够可靠数据时可能没有估值。官方来源:Zillow:Zestimate 的定义与限制来源核查:

Zillow 将 Rent Zestimate 作为租金研究的起点,建议同时研究周边出租房源;它与房屋出售价值的 Zestimate 不是同一个指标。官方来源:Zillow:Rent Zestimate 租金参考来源核查:

Zillow profile 的参数分别是什么意思?

url必填
Zillow homedetails 房源链接,用于读取单套详情;不是搜索结果页。
property_status可选
目标房源状态提示:for_sale 在售、recently_sold 已售、for_rent 出租;用于帮助读取指定房源,不是发现房源的搜索条件。
查看全部 3 个允许值

for_rentfor_salerecently_sold

Zillow 特有返回字段与含义(34)
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 等)。
zestimate
Zillow 估价模型给出的房屋估值。不是成交价也不是挂牌价。
rent_zestimate
Zillow 估算的月租金,同样是模型值不是实际租金。
days_on_zillow
在 Zillow 上的挂牌天数。数值大通常意味着不好卖或定价偏高。
tax_assessed_value
税务评估价值,政府计税用,通常低于市场价。
zipcode
邮编。
state
州。
latitude
纬度。
longitude
经度。
year_built
建成年份。
zestimate_low_percent
估值区间下限相对 zestimate 的百分比偏移。
zestimate_high_percent
估值区间上限相对 zestimate 的百分比偏移。
price_per_sqft
单位面积价格 = 价格 / 室内面积。
hoa_fee
业主协会月费。美国公寓和部分社区的强制费用,算总持有成本要带上。
property_tax_rate
房产税率,百分数。
tax_assessed_year
税务评估的年份。
last_sold_price
上一次成交价。
last_sold_at
上一次成交时间。
mls_id
多重上市服务系统的房源编号,北美房产行业通用标识。
mls_name
该房源所属的 MLS 系统名称。
listing_broker
挂牌经纪公司,与 broker_name 同义。
listing_agent
挂牌经纪人姓名。
listing_agent_phone
挂牌经纪人电话。
has_garage
是否有车库。
parking_capacity
车位数量。
photo_count
房源照片数量。
county
所属县(美国行政区划,介于州和市之间)。

怎么调用 Zillow 房源详情 API?

property_detail

使用 platform="zillow"、action="property_detail" 调用“房源详情”能力;返回单个对象,主要包含 id、url、address、city、state、postal_code 等 24 个字段。

Zillow 将 Zestimate 定义为住宅市场价值的模型估计,明确它不是专业估价,也不能替代专业估价;缺少足够可靠数据时可能没有估值。官方来源:Zillow:Zestimate 的定义与限制来源核查:

Zillow property_detail 的参数分别是什么意思?

url必填
Zillow homedetails 房源链接或完整地址;传链接时按页面读取,其他文本按地址查询。
Zillow 特有返回字段与含义(16)
area_sqft
室内面积,单位平方英尺(1 平方米 ≈ 10.76 平方英尺)。
home_type
房屋类型,原平台分类(SINGLE_FAMILY / CONDO / TOWNHOUSE 等)。
status
房源状态,与 home_status 同义。
zestimate
Zillow 估价模型给出的房屋估值。不是成交价也不是挂牌价。
rent_zestimate
Zillow 估算的月租金,同样是模型值不是实际租金。
tax_assessed_value
税务评估价值,政府计税用,通常低于市场价。
state
州。
latitude
纬度。
longitude
经度。
year_built
建成年份。
photo_count
房源照片数量。
bedrooms
卧室数量。
bathrooms
卫生间数量,可能是小数(1.5 = 一个全卫加一个半卫,美国计法)。
lot_size
地块面积,已带单位的文本形式。
days_on_market
在市场上的天数,可能早于上架 Zillow 的时间。
postal_code
邮编,与 zipcode 同义。

怎么调用 Zillow 房产经纪人 API?

agents

使用 platform="zillow"、action="agents" 调用“房产经纪人”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 id、url、name、business_name、types、address 等 16 个字段。

Zillow agents 的参数分别是什么意思?

keyword必填
美国州的两位缩写,例如 TX;不是经纪人姓名或房源关键词。
brokerage可选
经纪公司名称包含过滤,不是房屋建筑类型。
city可选
城市名过滤,应与 keyword 中的州匹配。

官方说明 Find an Agent 可按街区、ZIP 或城市查找经纪人,结果卡会呈现星级、评价数量、价格范围和销售等资料;排序会参考地点、评分和评价数,但不证明 EveryInfra 的州代码、brokerage、严格 min_rating 筛选,也不支持扩写为 property managers 或 lenders。官方来源:Zillow:Agent Finder 的地点、评分与评价线索来源核查:

min_rating可选
最低平均星级,整数 0–5;不填不筛选,设置后无评价人员会被排除。
Zillow 特有返回字段与含义(5)
state
州。
postal_code
邮编,与 zipcode 同义。
is_top_agent
该经纪人是否被 Zillow 标为优质经纪。
business_name
经纪公司或机构名称(经纪人搜索结果里用)。
types
房源类型列表。
Zillow search 调用流程一次 Zillow search 调用的全过程:向 POST /api/v1/social 发送 platform="zillow"、action="search",以及必填参数 keyword;返回结构化 JSON,含 zpid、url、status、status_type、price 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "zillow"action: "search"keywordEveryInfra$1.39 / 千次2 · 响应 · 列表zpidurlstatusstatus_typeprice
一次 Zillow search 调用的全过程:向 POST /api/v1/social 发送 platform="zillow"、action="search",以及必填参数 keyword;返回结构化 JSON,含 zpid、url、status、status_type、price 等字段;返回列表,单次最多 200 条,计费 $1.39 / 千次,失败与空结果不计费。

Zillow 原始字段名

EveryInfra 统一字段名

左边是 Zillow 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Zillow 的独有字段名(当前目录)

全站 89 个平台的当前目录中,这 35 个字段名只在 Zillow 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • zpid
  • status_type
  • street
  • zipcode
  • home_type
  • home_status
  • zestimate
  • rent_zestimate
  • tax_assessed_value
  • lot_area_value
  • lot_area_unit
  • days_on_zillow
  • is_zillow_owned
  • has_3d_model
  • price_per_sqft
  • hoa_fee
  • has_garage
  • parking_capacity

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

zpid
Zillow 内部房源 ID,该站的主键。
url
该记录在原平台上的可访问链接。
status
房源状态,与 home_status 同义。
status_type
状态分类,比 status 更粗的一层。
price
价格数值,不含货币符号;币种见 currency。
currency
价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
address
详细地址,原文透传。
street
街道地址。
city
城市名,用原平台的语言书写,未做中英归一。
state
州。
zipcode
邮编。
latitude
纬度。
longitude
经度。
beds
卧室数量,与 bedrooms 同义。
baths
卫生间数量,与 bathrooms 同义。
area_sqft
室内面积,单位平方英尺(1 平方米 ≈ 10.76 平方英尺)。
home_type
房屋类型,原平台分类(SINGLE_FAMILY / CONDO / TOWNHOUSE 等)。
home_status
房源状态(FOR_SALE / FOR_RENT / SOLD / PENDING 等)。
zestimate
Zillow 估价模型给出的房屋估值。不是成交价也不是挂牌价。
rent_zestimate
Zillow 估算的月租金,同样是模型值不是实际租金。
tax_assessed_value
税务评估价值,政府计税用,通常低于市场价。
lot_area_value
地块面积数值,单位见 lot_area_unit —— 两个字段要一起读。
lot_area_unit
地块面积单位(sqft 平方英尺 / acres 英亩)。
days_on_zillow
在 Zillow 上的挂牌天数。数值大通常意味着不好卖或定价偏高。
broker_name
挂牌经纪公司名称。
is_zillow_owned
是否为 Zillow 自持房源(Zillow Offers 收购的房子)。
has_3d_model
是否有 3D 看房模型。
has_video
是否有视频。
image_url
图片链接。多图能力可能返回 image_urls 数组。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
county
所属县(美国行政区划,介于州和市之间)。
year_built
建成年份。
price_per_sqft
单位面积价格 = 价格 / 室内面积。
hoa_fee
业主协会月费。美国公寓和部分社区的强制费用,算总持有成本要带上。
has_garage
是否有车库。
parking_capacity
车位数量。
zestimate_low_percent
估值区间下限相对 zestimate 的百分比偏移。
zestimate_high_percent
估值区间上限相对 zestimate 的百分比偏移。
tax_assessed_year
税务评估的年份。
property_tax_rate
房产税率,百分数。
last_sold_price
上一次成交价。
last_sold_at
上一次成交时间。
photo_count
房源照片数量。
description
简介或描述,通常比 text 短。
listing_agent
挂牌经纪人姓名。
listing_agent_phone
挂牌经纪人电话。
listing_broker
挂牌经纪公司,与 broker_name 同义。
mls_id
多重上市服务系统的房源编号,北美房产行业通用标识。
mls_name
该房源所属的 MLS 系统名称。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
postal_code
邮编,与 zipcode 同义。
bedrooms
卧室数量。
bathrooms
卫生间数量,可能是小数(1.5 = 一个全卫加一个半卫,美国计法)。
lot_size
地块面积,已带单位的文本形式。
days_on_market
在市场上的天数,可能早于上架 Zillow 的时间。
text
正文内容,已去除 HTML 标签。长文可能被截断。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
business_name
经纪公司或机构名称(经纪人搜索结果里用)。
types
房源类型列表。
phone
联系电话,原文透传,未做号码格式归一。
rating
评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
is_top_agent
该经纪人是否被 Zillow 标为优质经纪。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。

当前目录另列出 images · price_history · schools,这些字段尚无逐项释义;请先核对 Zillow 对应接口的用例与实际响应,不按字段名猜测类型或含义。

请求填写示例

search 填城市、地区或邮编;agents 中同名 keyword 则是美国州缩写。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

zillow_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"zillow","action":"search","params":{"keyword":"Austin, TX"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "zpid": null,
  "url": null,
  "status": null,
  "status_type": null,
  "price": null,
  "currency": null,
  "address": null,
  "street": null,
  "city": null,
  "state": null,
  "zipcode": null,
  "latitude": null,
  "longitude": null,
  "beds": null,
  "baths": null,
  "area_sqft": null,
  "home_type": null,
  "home_status": null,
  "zestimate": null,
  "rent_zestimate": null,
  "tax_assessed_value": null,
  "lot_area_value": null,
  "lot_area_unit": null,
  "days_on_zillow": null,
  "broker_name": null,
  "is_zillow_owned": null,
  "has_3d_model": null,
  "has_video": null,
  "image_url": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

根据 Zillow 城市或邮编建立住宅候选。

用位置文本搜索房源,再按返回地址核对搜索区域。

查看 search 的 category 参数 →
  • keyword 填城市、地区或邮编;category=city 或 zipcode 指位置类型,不是住宅户型。结合 zpid、address、price、currency 和 home_type 整理结果。
  • location、region 与 keyword 有输入优先级,不要给出互相冲突的地区;挂牌价不等于 Zestimate,币种缺失时不凭站点名称自行补值。

按 Zillow ZIP 对比出租与在售房源

用 zip_search 查询邮编范围,明确指定希望包含的房源状态。

查看 zip_search 的 for_rent 参数 →
  • zip 推荐五位字符串以保留前导零;for_rent、sold、for_sale_by_owner 是 JSON 布尔值,可组合使用,未选其他状态时默认包含经纪人挂牌。结合 zpid、zipcode、status 与 price 保存记录。
  • 状态开关不是互斥单选,出租与出售的价格不能直接混排;多邮编不代表免费批量,days_on_zillow 在已售筛选下也不能简单当成房屋持续挂牌天数。

区分 Zillow 房源挂牌价、估值与税评估

用 profile 读取指定房源,把不同价格字段分别归档。

查看 profile 的 url 参数 →
  • url 使用 homedetails 房源链接;price、zestimate、rent_zestimate、tax_assessed_value 与 last_sold_price 各有含义,结合 home_status 和 last_sold_at 核对。
  • Zestimate 是模型估值,不是专业估价或实际成交价;Rent Zestimate 是租金估计,不是已签租约。profile 返回房源对象,不是房主或经纪人档案。

用完整地址查询 Zillow 单套住宅

没有房源链接时,可通过 property_detail 的 url 字段提交完整地址。

查看 property_detail 的 url 参数 →
  • 该 url 字段可填完整地址或 homedetails 链接;返回 id、postal_code、bedrooms、bathrooms、area_sqft 与 days_on_market。
  • 它与 profile 的 zpid、zipcode、beds、baths 命名不同,不能直接复用全部字段映射;面积是平方英尺,zestimate 缺失不记为零,也不等于没有市场价值。

按州整理 Zillow 经纪人目录

用 agents 查询公开从业者资料,核对所属公司和服务地区。

查看 agents 的 city 参数 →
  • keyword 填 TX 等州缩写,不是经纪人姓名;city 可缩小到州内城市,brokerage 可按经纪公司名称过滤,再结合 name、business_name、city、state、rating 与 review_count 核对返回资料。
  • 当前公开 agents 接口不开放 propertyManagers、lenders 或 state 别名;这些类别与经纪人的字段不能直接类推。最低星级也不代表独立资质认证。

Zillow API 常见问题

Zillow API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="zillow"、action 和 params。以 search 为例,必填 keyword,可选 category、max_price、min_price、sort。search 填城市、地区或邮编;agents 中同名 keyword 则是美国州缩写。 Zillow 共 5 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Zillow API 怎么收费?

$1.39 / 千次,Zillow 全部 5 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 719 次 Zillow 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Zillow API 一次能返回多少条数据?

Zillow 有 3 个列表接口,包括 search、zip_search、agents。其余 2 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Zillow API 返回哪些字段?

当前目录为 search 列出 zpid、url、status、status_type、price、currency 等 30 个字段名。按全站当前目录统计,35 个字段名只在 Zillow 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「根据 Zillow 城市或邮编建立住宅候选。」怎样接入 Zillow API?

用位置文本搜索房源,再按返回地址核对搜索区域。 keyword 填城市、地区或邮编;category=city 或 zipcode 指位置类型,不是住宅户型。结合 zpid、address、price、currency 和 home_type 整理结果。 location、region 与 keyword 有输入优先级,不要给出互相冲突的地区;挂牌价不等于 Zestimate,币种缺失时不凭站点名称自行补值。

「按 Zillow ZIP 对比出租与在售房源」怎样接入 Zillow API?

用 zip_search 查询邮编范围,明确指定希望包含的房源状态。 zip 推荐五位字符串以保留前导零;for_rent、sold、for_sale_by_owner 是 JSON 布尔值,可组合使用,未选其他状态时默认包含经纪人挂牌。结合 zpid、zipcode、status 与 price 保存记录。 状态开关不是互斥单选,出租与出售的价格不能直接混排;多邮编不代表免费批量,days_on_zillow 在已售筛选下也不能简单当成房屋持续挂牌天数。

「区分 Zillow 房源挂牌价、估值与税评估」怎样接入 Zillow API?

用 profile 读取指定房源,把不同价格字段分别归档。 url 使用 homedetails 房源链接;price、zestimate、rent_zestimate、tax_assessed_value 与 last_sold_price 各有含义,结合 home_status 和 last_sold_at 核对。 Zestimate 是模型估值,不是专业估价或实际成交价;Rent Zestimate 是租金估计,不是已签租约。profile 返回房源对象,不是房主或经纪人档案。

「用完整地址查询 Zillow 单套住宅」怎样接入 Zillow API?

没有房源链接时,可通过 property_detail 的 url 字段提交完整地址。 该 url 字段可填完整地址或 homedetails 链接;返回 id、postal_code、bedrooms、bathrooms、area_sqft 与 days_on_market。 它与 profile 的 zpid、zipcode、beds、baths 命名不同,不能直接复用全部字段映射;面积是平方英尺,zestimate 缺失不记为零,也不等于没有市场价值。

可以先免费试用 Zillow API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 Zillow 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 5 个能力。无需信用卡。

开始调用 Zillow API

加微信领 $1 免费额度,先选一个 Zillow 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始