# Zillow 关键词搜索 API (zillow.search)

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

Zillow 关键词搜索按 `keyword` 找一个地方的房源，填城市、地区或邮编这类位置文本，例如 Austin, TX 或 78701，不是房源描述里的词。每套房有价格 `price`、卧室数 `beds`、卫生间数 `baths`、面积 `area_sqft`、状态 `home_status` 和估值 `zestimate`。它回答「这个地方有哪些房源、什么价位、状态如何」，适合做区域选房和房价摸底。

`category` 告诉接口 `keyword` 属于哪类位置，`auto_detect` 让接口自己判断，也可以指定 `zipcode`、`city` 等，它不是房屋类型。`min_price` 和 `max_price` 是整数，出租搜索按周租金理解。

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | 城市、地区或邮编位置文本，例如 Austin, TX 或 78701；不是房源描述关键词。 |
| category | enum: address / auto_detect / borough / city / county / flex_region / neighborhood / school / state / zipcode | no | not declared | 位置类型，不是房屋类型：auto_detect 自动、address 地址、borough 行政区、city 城市、county 县、flex_region 灵活区域、neighborhood 街区、school 学校、state 州、zipcode 邮编。 |
| max_price | not declared | no | not declared | 最高房源价格，整数；出租搜索按周租金理解，与 min_price 配合。带小数时向上取整。 |
| min_price | not declared | no | not declared | 最低房源价格，整数；出租搜索按周租金理解，不是 API 调用费用。带小数时向下取整。 |
| sort | enum: bathrooms / bedrooms / lot_size / newest / price_asc / price_desc / recently_changed / relevance / sqft / year_built | no | not declared | 房源排序：newest 最新挂牌、recently_changed 最近变更、relevance 相关性、price_asc/price_desc 价格、bedrooms 卧室数、bathrooms 卫浴数、sqft 室内面积、lot_size 地块面积、year_built 建造年份。 |
| limit | integer (1–200) | no | 20 | 这次调用最多返回的条数，整数，1–200；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。 |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| 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）。 |

## 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": "search",
  "params": {
    "keyword": "Austin, TX"
  }
}'
```

```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": "search",
        "params": {
            "keyword": "Austin, TX",
        },
    },
    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; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "zillow",
  "action": "search",
  "results": [
    {
      "zpid": 448089721,
      "url": "https://www.zillow.com/homedetails/Falcon-Plan-Cascades-at-Onion-Creek-Austin-TX-78747/448089721_zpid/",
      "address": {
        "city": "Austin",
        "state": "TX",
        "streetAddress": "Falcon Plan, Cascades at Onion Creek",
        "zipcode": "78747"
      },
      "beds": 4,
      "baths": 3,
      "area_sqft": 2323,
      "platform": "zillow"
    },
    {
      "zpid": 64905773,
      "url": "https://www.zillow.com/homedetails/8811-High-Valley-Rd-Austin-TX-78737/64905773_zpid/",
      "address": {
        "city": "Austin",
        "state": "TX",
        "streetAddress": "8811 High Valley Rd",
        "zipcode": "78737"
      },
      "beds": 2,
      "baths": 1,
      "area_sqft": 900,
      "platform": "zillow"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### 关键词搜索和邮编房源搜索怎么选？

位置不止是邮编，还可能是城市、街区、学校，用关键词搜索，还能用 `sort` 排序。已经知道美国邮编、想按出租、经纪人挂牌、房主自售、已售等状态筛，用邮编房源搜索，那里有这些开关，这一页没有。

### `zestimate` 可以当成交价吗？

不可以。它是 Zillow 估价模型给的估值，既不是成交价，也不是挂牌价；`rent_zestimate` 同样是模型估的月租金，不是实际租金。`tax_assessed_value` 是政府计税用的评估价值，通常低于市场价。

### 地块面积的单位怎么看？

`lot_area_value` 的单位看 `lot_area_unit`，是 sqft 平方英尺或 acres 英亩，两个字段要一起读。`area_sqft` 是室内面积，单位平方英尺，1 平方米约合 10.76 平方英尺；`days_on_zillow` 数值大，通常意味着不好卖或定价偏高。

## 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
