Get property history
Get a property's price history, tax history, schools, and nearby comparable homes. The graphql_errors field can contain partial-data notices on a successful response.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
zpid*string
Zillow's numeric id for the home, e.g. 2146999031 from /homedetails/.../2146999031_zpid/. Every /v1/zillow/search and /v1/zillow/sitemap result carries one. A pasted property URL is accepted and reduced to the id — the address slug in it is decoration, not part of the key.
Length
length <= 300curl -X GET "https://example.com/v1/zillow/history?zpid=2146999031" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "requested_zpid": "2146999031", "zpid": 2146999031, "url": "https://www.zillow.com/homedetails/2146999031_zpid/", "address": { "street_address": "2114 S Trumbull Ave", "city": "Chicago", "state": "IL", "zipcode": "60623" }, "price_history": [ { "date": "2025-08-01", "time": "string", "price": 480000, "event": "Price change", "price_change_rate": -0.03, "source": "MLS #12345678" } ], "tax_history": [ { "time": "string", "tax_paid": 3210, "value": 162000, "tax_increase_rate": 0.041, "value_increase_rate": 0.055 } ], "schools": [ { "name": "Marshall Elementary", "rating": 3, "level": "Elementary", "grades": "PK-8", "distance": 0.4, "assigned": null, "link": "https://www.greatschools.org/example" } ], "nearby_homes": [ { "zpid": "2077663766", "url": "https://www.zillow.com/homedetails/2077663766_zpid/", "price": 415000, "currency": "USD", "home_status": "SOLD", "home_type": "SINGLE_FAMILY", "bedrooms": 3, "bathrooms": 2, "living_area": 1600, "living_area_value": 1600, "lot_size": 3125, "latitude": 41.8442, "longitude": -87.7128, "zestimate": 402100, "last_sold_price": 380000, "address": { "street_address": "2114 S Trumbull Ave", "city": "Chicago", "state": "IL", "zipcode": "60623" } } ], "graphql_errors": [ { "message": "Failed to fetch visualizations" } ], "usage_note": "An empty list here means the property has no such records; /zillow/property returns null for these fields instead, meaning that response does not carry them. Each nearby home's zpid is the exact value /zillow/property takes." }}