> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spidra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Zillow

> Get Zillow search results (with up to 500 map homes), property details with price and tax history, buildings, agents and agent directories as structured data, for 1 credit per link.

Send a Zillow link to [Scrape](https://docs.spidra.io/scrape.md) or [Batch scrape](https://docs.spidra.io/batch-scrape.md) and you get the page's data as JSON: every listing in a search, a home's full details and history, an apartment building's floor plans, or an agent's profile. Each link costs 1 credit, and links that can't be read cost nothing.

## Example

```json theme={null}
{ "urls": ["https://www.zillow.com/austin-tx/"], "output": "json", "wait": true }
```

The item's `result`, shortened to one listing:

```json theme={null}
{
  "type": "search",
  "totalResults": 5634,
  "totalPages": 20,
  "listingCount": 41,
  "listings": [
    {
      "zpid": "442024655",
      "address": "2702 S 2nd St #1 & 2, Austin, TX 78704",
      "price": 300000,
      "beds": 5,
      "baths": 6,
      "livingArea": 2496,
      "homeType": "SINGLE_FAMILY",
      "statusText": "Active",
      "daysOnZillow": 8,
      "url": "https://www.zillow.com/homedetails/2702-S-2nd-St-1-2-Austin-TX-78704/442024655_zpid/"
    }
  ],
  "mapListingCount": 502,
  "mapListings": ["..."]
}
```

On page 1 of a search, `mapListings` adds up to 500 homes Zillow plots on the map for the same search, with the same fields.

## Links that work

| Link | Example | You get |
| - | - | - |
| Search | `zillow.com/austin-tx/`, `/homes/...`, `/<zip>_rb/`, `/rentals/`, `/sold/`, any `searchQueryState` link, `/2_p/` for page 2 | Every listing on the page, totals and page info, and map homes on page 1 |
| Property | `zillow.com/homedetails/.../<zpid>_zpid/` | The home's full details, history, schools and agents |
| Building | `zillow.com/b/<slug>/`, `/apartments/<city-st>/<name>/<id>/` | Floor plans with every unit, amenities, rents and scores |
| Agent | `zillow.com/profile/<name>/` | The agent's contact details as published, reviews, listings and sales |
| Agent directory | `zillow.com/professionals/real-estate-agent-reviews/<city-st>/` | The agents on the page with ratings and sales stats |

## Fields

**Search listing:** `zpid`, `url`, `address` and its parts, `price`, `statusType`, `homeStatus`, `homeType`, `beds`, `baths`, `livingArea`, `lotAreaValue`, `zestimate`, `rentZestimate`, `taxAssessedValue`, `daysOnZillow`, `soldPrice`, `dateSold`, `priceChange`, `brokerName`, `listingAgent`, `latitude`, `longitude`, `photos`, open house times, and building fields for apartments (`buildingName`, `units`, `minRent`, `maxRent`).

**Property:** address parts, `parcelId`, `latitude`, `longitude`, `homeStatus`, `homeType`, `price`, `zestimate` with its range, `rentZestimate`, `bedrooms`, `bathrooms`, `livingArea`, `lotSize`, `yearBuilt`, `pricePerSquareFoot`, `description`, `daysOnZillow`, `pageViewCount`, `favoriteCount`, `lastSoldPrice`, `monthlyHoaFee`, `propertyTaxRate`, `taxAssessedValue`, `mlsId`, `listingAgent`, `coListingAgent`, `broker`, `buyerAgent`, `openHouses`, `priceHistory`, `taxHistory`, `schools` (with ratings), `facts`, `photos` and `nearbyHomes`.

## Limits

* Zillow shows up to 41 listings per search page. Use `/2_p/` and so on for more, or rely on `mapListings` on page 1.
* Contact details for agents are what Zillow publishes on the page.
* Pages are read as a signed-out visitor; your cookies are never sent to Zillow.

## Templates

Ready-made [templates](https://docs.spidra.io/templates.md) for Zillow: homes in an area, rentals in an area, property details, agents in an area, agent profiles and apartment rents by floor plan.

> [!NOTE]
>
> Check Zillow's terms before you collect data from it. You're responsible for how you use what you collect.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.