Zillow Search
GET
Search Zillow listings from a search or map URL and retrieve prices, beds, baths, coordinates, and listing status.
Credit cost: 3 credits per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringFull Zillow search or map results URL.
Example 1 (city search URL):
https://www.zillow.com/staten-island-ny/Example 2 (map search URL):
https://www.zillow.com/homes/for_sale/Staten-Island-NY_rb/Notes:
- Only Zillow URLs are accepted (search pages, map results, filtered browse URLs).
- Pagination and filter parameters present in the URL are respected.
- Use each result's
detail_urlwith the Zillow Property endpoint.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
results?array<>curl -X GET 'https://api.piloterr.com/v2/zillow/search?query=string'Example Response
{ "results": [ { "id": "32361983", "area": 2500, "beds": 4, "list": true, "zpid": "32361983", "baths": 3, "pgapt": "ForSale", "price": "$699,000", "sgapt": "For Sale (Broker)", "address": "20 Kyle Ct, Staten Island, NY 10312", "img_src": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-p_e.jpg", "pals_id": "479004_501695", "lat_long": { "latitude": 40.557384, "longitude": -74.19698 }, "has_image": true, "zestimate": 695900, "detail_url": "https://www.zillow.com/homedetails/20-Kyle-Ct-Staten-Island-NY-10312/32361983_zpid/", "broker_name": "Listing by: Real Broker NY LLC", "status_text": "House for sale", "status_type": "FOR_SALE", "address_city": "Staten Island", "has3_d_model": true, "address_state": "NY", "address_street": "20 Kyle Ct", "address_zipcode": "10312", "country_currency": "$", "unformatted_price": 699000, "raw_home_status_cd": "ForSale", "is_showcase_listing": true, "marketing_status_simplified_cd": "For Sale by Agent" }, { "id": "32325469", "area": 1104, "beds": 3, "list": true, "zpid": "32325469", "baths": 2, "pgapt": "ForSale", "price": "$849,900", "sgapt": "For Sale (Broker)", "address": "43 Hickory Ave, Staten Island, NY 10305", "img_src": "https://photos.zillowstatic.com/fp/3a517276d08c426dce24e27c116cac1a-p_e.jpg", "pals_id": "820001_2602944", "lat_long": { "latitude": 40.59659, "longitude": -74.073944 }, "has_image": true, "zestimate": 836200, "detail_url": "https://www.zillow.com/homedetails/43-Hickory-Ave-Staten-Island-NY-10305/32325469_zpid/", "broker_name": "Listing by: Homes R Us Realty of NY, Inc.", "status_text": "House for sale", "status_type": "FOR_SALE", "address_city": "Staten Island", "has3_d_model": true, "address_state": "NY", "address_street": "43 Hickory Ave", "address_zipcode": "10305", "country_currency": "$", "unformatted_price": 849900, "raw_home_status_cd": "ForSale", "is_showcase_listing": true, "marketing_status_simplified_cd": "For Sale by Agent" } ]}