# Zillow (/docs/zillow) Search Zillow homes for sale, for rent or sold, then read one home with its price history and tax history Zillow lists homes for sale, homes and apartments for rent, and recently sold homes across the United States. These endpoints search an area, read one home in full with its price history and tax history, and look up the places Zillow knows. Every home uses the canonical `Place` shape, and the listing facts sit in `place.ext.listing`, the same shape Redfin homes use. Base URL: `/v1/zillow/...` Zillow exposes 3 routes here. ## Quickstart ### Search an area Pass a city, ZIP code, neighborhood or address as `location`. `status` picks homes `for_sale` (the default), `for_rent` or `sold`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/zillow/search?location=Austin%2C%20TX&status=for_sale&price_max=600000&beds_min=3" \ -H "x-api-key: YOUR_API_KEY" ``` ### Read one home Take `place.id` (the zpid) from a search row, or pass the Zillow listing link as `url`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/zillow/property?zpid=70344560" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "place": { "id": "70344560", "name": "5810 Vasey Blvd", "address": "5810 Vasey Blvd, Austin, TX 78724", "ext": { "listing": { "price": 250000, "status": "for_sale", "beds": 4, "baths": 3, "sqft": 1952, "year_built": 2006, "price_history": [ { "date": "2026-11-05", "price": 250000, "event": "priceChange", "source": "Unlock MLS" } ] } } } } } ``` ### Find the right place name `locations` turns a partial name into the regions and addresses Zillow knows, so the `location` you search with matches what Zillow means. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/zillow/locations?query=Austin" \ -H "x-api-key: YOUR_API_KEY" ``` ## Questions people ask ### Can I get a home's sale history? Yes. `GET /v1/zillow/property` returns `place.ext.listing.price_history`, newest first, with each event's date, price, what happened in Zillow's own words (for example `listedForSale`, `priceChange`, `sold`) and its source, back through earlier listings and sales. `tax_history` carries the yearly tax paid and assessed value. On some answers the history has dates and prices without the event names, and the tax history is null. ### Why does a rental have no zpid? Zillow lists many rentals as buildings. A `for_rent` row is the building: `place.id` is the building id and the price is its lowest base rent. ### When did a sold home sell? Sold search rows carry the sale price but not the sale date. Read the home with `GET /v1/zillow/property`; the sale is an event in its price history. ### Can I search a map area instead of a place name? Yes. Send `map_bounds` as `north,east,south,west` in place of `location`. ## All endpoints **How far back and how deep** Each list returns one page at a time. Send `cursor` for the next page, or `max_items` or `max_pages` to collect several pages in one call. A page size appears only where it has been verified. [How paging works](/docs/pagination.md). | Path | Rows per page | Date window | One call collects | | --- | --- | --- | --- | | `/v1/zillow/locations` | about 10 | none | up to 5,000 rows or 50 pages; `limit` up to 100 | | `/v1/zillow/search` | about 41 | none | up to 5,000 rows or 50 pages | ## Platform notes **Money is in US dollars and areas are in square feet.** `place.ext.listing.currency` says so on every row. **Search pages with a cursor.** Pass the returned `cursor` for the next page; Zillow stops a search after its own page limit, so narrow the area or the filters to reach every home. **A zpid that does not exist answers `404`** and is not charged. ## Next steps - [Redfin](/docs/redfin.md): The same Place and listing shape from Redfin. - [Realtor.com](/docs/realtor.md): Homes for sale and for rent from a search link. - [Apartments.com](/docs/apartments.md): Rental buildings with rent by bedroom count.