Piloterr

Zillow Search

GET
/v2/zillow/search

Search Zillow listings from a search or map URL and retrieve prices, beds, baths, coordinates, and listing status.

Credit cost: 3 credits per call

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Full 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_url with the Zillow Property endpoint.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/zillow/search?query=string"
{  "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"    }  ]}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}