Piloterr

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

GET
/v2/zillow/search

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://api.piloterr.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"
}