toolzerhub API Docs

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
GET
/v1/zillow/history

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.

Lengthlength <= 300
curl -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."  }}