# Zillow 主页或对象详情 API (zillow.profile)

- Canonical page: https://everyinfra.com/zillow-api/profile
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "zillow", "action": "profile", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=zillow&action=profile

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| url | not declared | yes | not declared | Zillow homedetails 房源链接，用于读取单套详情；不是搜索结果页。 |
| property_status | enum: for_rent / for_sale / recently_sold | no | not declared | 目标房源状态提示：for_sale 在售、recently_sold 已售、for_rent 出租；用于帮助读取指定房源，不是发现房源的搜索条件。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| zpid | Zillow 内部房源 ID，该站的主键。 |
| url | 该记录在原平台上的可访问链接。 |
| home_status | 房源状态（FOR_SALE / FOR_RENT / SOLD / PENDING 等）。 |
| home_type | 房屋类型，原平台分类（SINGLE_FAMILY / CONDO / TOWNHOUSE 等）。 |
| price | 价格数值，不含货币符号；币种见 currency。 |
| currency | 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。 |
| address | 详细地址，原文透传。 |
| city | 城市名，用原平台的语言书写，未做中英归一。 |
| state | 州。 |
| zipcode | 邮编。 |
| county | 所属县（美国行政区划，介于州和市之间）。 |
| latitude | 纬度。 |
| longitude | 经度。 |
| beds | 卧室数量，与 bedrooms 同义。 |
| baths | 卫生间数量，与 bathrooms 同义。 |
| area_sqft | 室内面积，单位平方英尺（1 平方米 ≈ 10.76 平方英尺）。 |
| lot_area_value | 地块面积数值，单位见 lot_area_unit，两个字段要一起读。 |
| lot_area_unit | 地块面积单位（sqft 平方英尺 / acres 英亩）。 |
| year_built | 建成年份。 |
| price_per_sqft | 单位面积价格 = 价格 / 室内面积。 |
| hoa_fee | 业主协会月费。美国公寓和部分社区的强制费用，算总持有成本要带上。 |
| has_garage | 是否有车库。 |
| parking_capacity | 车位数量。 |
| zestimate | Zillow 估价模型给出的房屋估值。**不是成交价也不是挂牌价**。 |
| rent_zestimate | Zillow 估算的月租金，同样是模型值不是实际租金。 |
| zestimate_low_percent | 估值区间下限相对 zestimate 的百分比偏移。 |
| zestimate_high_percent | 估值区间上限相对 zestimate 的百分比偏移。 |
| tax_assessed_value | 税务评估价值，政府计税用，通常低于市场价。 |
| tax_assessed_year | 税务评估的年份。 |
| property_tax_rate | 房产税率，百分数。 |
| last_sold_price | 上一次成交价。 |
| last_sold_at | 上一次成交时间。 |
| days_on_zillow | 在 Zillow 上的挂牌天数。数值大通常意味着不好卖或定价偏高。 |
| photo_count | 房源照片数量。 |
| description | 简介或描述，通常比 text 短。 |
| listing_agent | 挂牌经纪人姓名。 |
| listing_agent_phone | 挂牌经纪人电话。 |
| listing_broker | 挂牌经纪公司，与 broker_name 同义。 |
| mls_id | 多重上市服务系统的房源编号，北美房产行业通用标识。 |
| mls_name | 该房源所属的 MLS 系统名称。 |
| platform | 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。 |
| images | 图片链接数组，按平台展示顺序；没有图片时不出现这个字段。 |
| price_history | platform-native meaning |
| schools | platform-native meaning |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "zillow",
  "action": "profile",
  "params": {
    "url": "https://www.zillow.com/homedetails/6105-W-Club-Ln-Richmond-VA-23226/12345678_zpid/"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "zillow",
        "action": "profile",
        "params": {
            "url": "https://www.zillow.com/homedetails/6105-W-Club-Ln-Richmond-VA-23226/12345678_zpid/",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "zillow",
  "action": "profile",
  "results": {
    "zpid": 12345678,
    "home_type": "SINGLE_FAMILY",
    "beds": 3,
    "baths": 3.5,
    "area_sqft": 3187,
    "year_built": 1980,
    "zestimate": 786600,
    "rent_zestimate": 3646,
    "property_tax_rate": 0.72,
    "last_sold_price": 325000,
    "last_sold_at": "2018-04-30T00:00:00+00:00",
    "days_on_zillow": 3071,
    "photo_count": 1,
    "description": "This 3187 square foot single family home has 3 bedrooms and 3.5 bathrooms. This home is located at 6105 W Club Ln, Richmond, VA 23226.",
    "platform": "zillow"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=zillow
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
