# Zillow — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for homes for sale, rent, or recently sold listings on Zillow while accessing detailed property information, Zestimates, agent profiles, and current mortgage rates all in one place. Streamline your real estate research by gathering comprehensive property details, agent information, and financing options without navigating multiple pages.

**Category:** Real Estate | **Website:** [zillow.com/](https://zillow.com/) | **Docs:** [parse.bot/marketplace/082cc2d5-948e-46e7-9f1c-e4b06b5f67cc/zillow-com-api](https://parse.bot/marketplace/082cc2d5-948e-46e7-9f1c-e4b06b5f67cc/zillow-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-zillow-com-api-082cc2d5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_agent_profile

Retrieve a real estate agent's full profile by their username/URL slug. Returns sales stats, reviews, listings, service areas, and professional information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Agent's Zillow profile username/slug (e.g., 'everydoorrealestate') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zillow-com-api-082cc2d5/get_agent_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### get_mortgage_rates

Retrieve current mortgage interest rates from Zillow Home Loans. Returns rates for various loan types including conventional fixed (10/15/20/30-year), FHA fixed, VA fixed, jumbo fixed, and adjustable-rate mortgages. Each rate includes the interest rate, APR, and associated fees/points. Rates update daily.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zillow-com-api-082cc2d5/get_mortgage_rates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_property_details

Retrieve full details for a specific property by its Zillow property ID (zpid). Returns comprehensive property information including price, address, lot size, tax assessment, and listing metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zpid` | string | Yes | Zillow property ID (numeric string, e.g., '29505949') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zillow-com-api-082cc2d5/get_property_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zpid":"<string>"}'
```

### get_zestimate

Get the Zestimate (automated home value estimate) and rent Zestimate for a property by zpid.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `zpid` | string | Yes | Zillow property ID (numeric string, e.g., '2080998636') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zillow-com-api-082cc2d5/get_zestimate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zpid":"<string>"}'
```

### search_agents

Search for real estate agents by location. Returns paginated results with agent profile cards including ratings, sales data, and contact links. Results include top agents, teams, and individual agents serving the specified area.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | Yes | City and state (e.g., 'Seattle, WA', 'Los Angeles, CA') |
| `page` | integer | No | Page number for pagination (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zillow-com-api-082cc2d5/search_agents \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>"}'
```

### search_homes_for_rent

Search for rental properties in a specific location. Returns paginated results with up to 41 listings per page, including building-level and unit-level rental data with price ranges, availability counts, and amenity information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | Yes | City and state, ZIP code, or neighborhood (e.g., 'Los Angeles, CA', '10001', 'Brooklyn, NY') |
| `page` | integer | No | Page number for pagination (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zillow-com-api-082cc2d5/search_homes_for_rent \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>"}'
```

### search_homes_for_sale

Search for homes listed for sale in a specific location. Returns paginated results with up to 41 listings per page, including property details like price, beds, baths, area, zestimate, and location coordinates. Uses Zillow's internal search API which resolves the location string to a geographic region.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | Yes | City and state, ZIP code, or neighborhood (e.g., 'Seattle, WA', '90210', 'Capitol Hill, Seattle, WA') |
| `page` | integer | No | Page number for pagination (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zillow-com-api-082cc2d5/search_homes_for_sale \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>"}'
```

### search_recently_sold

Search for recently sold properties in a specific location. Returns paginated results with up to 41 listings per page, including sold price, sale date, zestimate, and property details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | Yes | City and state, ZIP code, or neighborhood (e.g., 'Chicago, IL', '60601', 'Lincoln Park, Chicago, IL') |
| `page` | integer | No | Page number for pagination (1-based) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-zillow-com-api-082cc2d5/search_recently_sold \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>"}'
```