# Zillow ZIP code search API (zillow.zip_search)

- Canonical page: https://everyinfra.com/en/zillow-api/zip_search
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "zillow", "action": "zip_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

## Health

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

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| zip | not declared | yes | not declared | A US ZIP code for `zip_search`, preferably a five-character string so leading zeros are preserved. A comma- or whitespace-separated string and a ZIP-code array are also accepted. Multiple ZIP targets remain subject to the actual request-billing rules and are not a free batch. With several ZIP codes, `limit` caps the total listings the call returns, not the count per ZIP code. |
| days_on_zillow | enum: 1 / 12m / 14 / 24m / 30 / 36m / 6m / 7 / 90 | no | not declared | A `zip_search` time preset: empty for no restriction; `1`, `7`, `14`, `30`, or `90` for days; or `6m`, `12m`, `24m`, or `36m` for months. It generally means time listed, but for sold homes it means time since sale. It is not an arbitrary day count or a quality judgment. |
| for_rent | not declared | no | not declared | A JSON boolean that includes rental listings in `zip_search`. It is not exclusive and can be combined with other status filters. Do not send the string `"false"`. |
| for_sale_by_agent | not declared | no | not declared | A JSON boolean that includes agent-listed homes in `zip_search`. It defaults to true only when no sale-by-owner, rental, or sold status is selected; selecting another status removes that implicit default. |
| for_sale_by_owner | not declared | no | not declared | A JSON boolean that includes owner-listed homes in `zip_search`. It does not prove that a transaction has no commission or intermediary cost. |
| max_price | not declared | no | not declared | The maximum listing-price filter for `search` and `zip_search`. In `zip_search`, it overrides `price_max`. It is not the upper bound of a Zillow home-value estimate. Filtering uses whole numbers: decimals round up (145.98 becomes 146). |
| min_price | not declared | no | not declared | The standard minimum-price field for `search` and `zip_search`. In `zip_search`, it overrides `price_min`. It is not an agent service fee. Filtering uses whole numbers: decimals round down (39.81 becomes 39). |
| sold | not declared | no | not declared | A JSON boolean that includes sold homes in `zip_search`. Selecting it does not guarantee that every area exposes a public sale amount. |
| limit | integer (1–200) | no | 20 | The most rows to return in this call, an integer from 1 to 200. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| zpid | platform-native meaning |
| url | Link to the record on the platform. |
| status | platform-native meaning |
| status_type | platform-native meaning |
| price | Price as a number without a currency symbol; see currency. |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| address | Full address, passed through as is. |
| street | platform-native meaning |
| city | City name in the platform's language, not normalized. |
| state | platform-native meaning |
| zipcode | platform-native meaning |
| latitude | platform-native meaning |
| longitude | platform-native meaning |
| beds | platform-native meaning |
| baths | platform-native meaning |
| area_sqft | platform-native meaning |
| home_type | platform-native meaning |
| home_status | platform-native meaning |
| zestimate | platform-native meaning |
| rent_zestimate | platform-native meaning |
| tax_assessed_value | platform-native meaning |
| lot_area_value | platform-native meaning |
| lot_area_unit | platform-native meaning |
| days_on_zillow | platform-native meaning |
| broker_name | platform-native meaning |
| is_zillow_owned | platform-native meaning |
| has_3d_model | platform-native meaning |
| has_video | platform-native meaning |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| platform | Source platform identifier, the same as platform in the request (for example 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": "zip_search",
  "params": {
    "zip": "78701"
  }
}'
```

```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": "zip_search",
        "params": {
            "zip": "78701",
        },
    },
    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 233. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "zillow",
  "action": "zip_search",
  "results": [
    {
      "zpid": "89552472",
      "beds": 1,
      "baths": 1,
      "area_sqft": 801,
      "is_zillow_owned": false,
      "has_3d_model": true,
      "has_video": false,
      "platform": "zillow"
    },
    {
      "zpid": "•••",
      "beds": 2,
      "baths": 2,
      "area_sqft": 793,
      "is_zillow_owned": false,
      "has_3d_model": false,
      "has_video": false,
      "platform": "zillow"
    }
  ],
  "count": 233,
  "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
