toolzerhub API Docs

Search properties

Search up to 41 property listings in a region with price, beds, baths, address and coordinates — plus counts of matching properties and reachable pages. Requires region. Each row's zpid feeds /v1/zillow/property →. status is for_sale or sold; rentals are not offered.

1 credit / requestBilled only on success
GET
/v1/zillow/search

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

region*string

The region slug from a Zillow URL, e.g. san-francisco-ca from https://www.zillow.com/san-francisco-ca/. A bare state (ca) or zip code (94103) also works. A pasted search URL is accepted in either of Zillow's spellings and reduced to the slug; status and page segments in it are dropped.

Lengthlength <= 500
page?integer

Which page of listings, 41 per page. Capped at 20 — Zillow's own limit regardless of match count: San Francisco sold reports 18,802 matching properties but only 20 reachable pages. Walk with next_page, which is null past the cap. Pages do not overlap.

Range1 <= value <= 20
Default1
status?string

for_sale (default) or sold. sold returns a sample, flagged by results_are_capped. For rentals, use /v1/zillow/sitemap with family=for_rent.

Default"for_sale"

Value in

  • "for_sale"
  • "sold"
curl -X GET "https://example.com/v1/zillow/search?region=san-francisco-ca" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "region": "san-francisco-ca",    "status": "for_sale",    "page": 1,    "url": "https://www.zillow.com/san-francisco-ca/",    "results": [      {        "zpid": "2146999031",        "url": "https://www.zillow.com/homedetails/2146999031_zpid/",        "price": 480000,        "price_display": "$480,000",        "bedrooms": 3,        "bathrooms": 2,        "living_area": 1600,        "address": "2114 S Trumbull Ave, Chicago, IL 60623",        "street_address": "2114 S Trumbull Ave",        "city": "Chicago",        "state": "IL",        "zipcode": "60623",        "latitude": 41.84,        "longitude": -87.71,        "status_text": "House for sale",        "status_type": "FOR_SALE",        "marketing_status": "For Sale",        "raw_home_status": "ForSale",        "broker_name": "RE/MAX Partners",        "image_url": "https://photos.zillowstatic.com/fp/abc-p_e.jpg",        "has_image": true,        "is_zillow_owned": false,        "has_open_house": false,        "open_house_start": "string",        "open_house_end": "string",        "open_house_description": "Sat 1-3pm",        "has_3d_model": false,        "has_video": false,        "is_featured_listing": false,        "is_undisclosed_address": false,        "content_type": "property"      }    ],    "count": 41,    "page_size": 41,    "total_results": 773,    "total_pages": 19,    "max_browsable_pages": 20,    "results_are_capped": false,    "has_more": true,    "next_page": 2,    "next_url": "https://www.zillow.com/san-francisco-ca/2_p/",    "region_details": {      "property1": null,      "property2": null    },    "query_state": {      "property1": null,      "property2": null    },    "usage_note": "Each result's zpid is the exact value /zillow/property takes. total_results is how many properties match; total_pages is how many you can actually reach, and on sold listings they differ by more than 20x."  }}