# Zillow Details API (zillow.profile)

- Canonical page: https://everyinfra.com/en/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 | A Zillow `homedetails` property URL for profile or `property_detail`. The latter also accepts a full street address in this field. A property-detail URL cannot be substituted for a search-results URL. |
| property_status | enum: for_rent / for_sale / recently_sold | no | not declared | A known-status hint for the target profile property: `for_sale`, `recently_sold`, or `for_rent`. It helps read one specified property and is not a discovery filter. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| zpid | platform-native meaning |
| url | Link to the record on the platform. |
| home_status | platform-native meaning |
| home_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. |
| city | City name in the platform's language, not normalized. |
| state | platform-native meaning |
| zipcode | platform-native meaning |
| county | platform-native meaning |
| latitude | platform-native meaning |
| longitude | platform-native meaning |
| beds | platform-native meaning |
| baths | platform-native meaning |
| area_sqft | platform-native meaning |
| lot_area_value | platform-native meaning |
| lot_area_unit | platform-native meaning |
| year_built | platform-native meaning |
| price_per_sqft | platform-native meaning |
| hoa_fee | platform-native meaning |
| has_garage | platform-native meaning |
| parking_capacity | platform-native meaning |
| zestimate | platform-native meaning |
| rent_zestimate | platform-native meaning |
| zestimate_low_percent | platform-native meaning |
| zestimate_high_percent | platform-native meaning |
| tax_assessed_value | platform-native meaning |
| tax_assessed_year | platform-native meaning |
| property_tax_rate | platform-native meaning |
| last_sold_price | platform-native meaning |
| last_sold_at | platform-native meaning |
| days_on_zillow | platform-native meaning |
| photo_count | platform-native meaning |
| description | Summary or description, usually shorter than text. |
| listing_agent | platform-native meaning |
| listing_agent_phone | platform-native meaning |
| listing_broker | platform-native meaning |
| mls_id | platform-native meaning |
| mls_name | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| images | Array of image links in the platform's display order; absent when there are no 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
