Piloterr

Zillow Property

Extract full property details from a Zillow homedetails URL, including specs, photos, schools, tax history, and agent attribution.

Credit cost: 3 credits per call

GET
/v2/zillow/property

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 homedetails URL.

Example:

https://www.zillow.com/homedetails/20-Kyle-Ct-Staten-Island-NY-10312/32361983_zpid/

Notes:

  • Only Zillow homedetails URLs are accepted (/homedetails/.../{zpid}_zpid/).
  • Copy the detail_url value returned by the Zillow Search endpoint.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/zillow/property?query=string"
{
  "id": "UHJvcGVydHk6MzIzNjE5ODM=",
  "city": "Staten Island",
  "zpid": 32361983,
  "mlsid": "501695",
  "price": 699000,
  "state": "NY",
  "county": "Richmond County",
  "photos": [
    {
      "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-p_d.jpg",
      "caption": null,
      "subject_type": null,
      "mixed_sources": {
        "jpeg": [
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_192.jpg",
            "width": 192
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_384.jpg",
            "width": 384
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_576.jpg",
            "width": 576
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_768.jpg",
            "width": 768
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_960.jpg",
            "width": 960
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_1152.jpg",
            "width": 1152
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_1344.jpg",
            "width": 1344
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_1536.jpg",
            "width": 1536
          }
        ],
        "webp": [
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_192.webp",
            "width": 192
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_384.webp",
            "width": 384
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_576.webp",
            "width": 576
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_768.webp",
            "width": 768
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_960.webp",
            "width": 960
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_1152.webp",
            "width": 1152
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_1344.webp",
            "width": 1344
          },
          {
            "url": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-cc_ft_1536.webp",
            "width": 1536
          }
        ]
      }
    },
    {
      "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-p_d.jpg",
      "caption": null,
      "subject_type": null,
      "mixed_sources": {
        "jpeg": [
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_192.jpg",
            "width": 192
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_384.jpg",
            "width": 384
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_576.jpg",
            "width": 576
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_768.jpg",
            "width": 768
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_960.jpg",
            "width": 960
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_1152.jpg",
            "width": 1152
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_1344.jpg",
            "width": 1344
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_1536.jpg",
            "width": 1536
          }
        ],
        "webp": [
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_192.webp",
            "width": 192
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_384.webp",
            "width": 384
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_576.webp",
            "width": 576
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_768.webp",
            "width": 768
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_960.webp",
            "width": 960
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_1152.webp",
            "width": 1152
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_1344.webp",
            "width": 1344
          },
          {
            "url": "https://photos.zillowstatic.com/fp/f0ae3c55f8feaba0c3a41b4cfe9c8c9a-cc_ft_1536.webp",
            "width": 1536
          }
        ]
      }
    }
  ],
  "address": {
    "city": "Staten Island",
    "state": "NY",
    "zipcode": "10312",
    "community": null,
    "subdivision": "Staten Island",
    "neighborhood": null,
    "street_address": "20 Kyle Ct"
  },
  "country": "USA",
  "hdp_url": "/homedetails/20-Kyle-Ct-Staten-Island-NY-10312/32361983_zpid/",
  "pals_id": "479004_501695",
  "schools": [
    {
      "link": "https://www.greatschools.org/new-york/staten-island/2036-Ps-4-Maurice-Wollin/",
      "name": "Ps 4 Maurice Wollin",
      "grades": "PK-5",
      "rating": 8,
      "distance": 0.4
    },
    {
      "link": "https://www.greatschools.org/new-york/staten-island/2919-Is-75-Frank-D-Paulo/",
      "name": "Is 75 Frank D Paulo",
      "grades": "6-8",
      "rating": 8,
      "distance": 0.9
    }
  ],
  "zipcode": "10312",
  "bedrooms": 4,
  "currency": "USD",
  "latitude": 40.557384,
  "lot_size": 2773,
  "bathrooms": 3,
  "home_type": "SINGLE_FAMILY",
  "longitude": -74.19698,
  "zestimate": 695900,
  "reso_facts": {
    "cooling": [
      "A/C Unit",
      "Central Air"
    ],
    "heating": [
      "Natural Gas",
      "Other"
    ],
    "stories": null,
    "basement": "None",
    "bedrooms": 4,
    "lot_size": "2,773 sqft",
    "bathrooms": 3,
    "has_garage": true,
    "year_built": 1975,
    "living_area": "2,500 sqft",
    "parking_features": [
      "Other",
      "Attached Garage",
      "Garage Door Opener"
    ]
  },
  "year_built": 1975,
  "description": "Tucked at the end of a quiet loop in Village Greens, this is one of the rare four-bedrooms in the community.    If you know the South Shore, you know Village Greens. It's the Levitt-built community from the early 70s, the first planned townhouse development in New York City. Curved streets, no through traffic, a 13-acre park sitting in the middle with two Olympic-sized pools, tennis courts, and trail paths that wind through the whole place. Kyle Court is one of the cul-de-sacs off Dover Green, w...",
  "home_status": "FOR_SALE",
  "living_area": 2500,
  "photo_count": 25,
  "tax_history": [
    {
      "time": 1748867492137,
      "value": 38100,
      "tax_paid": 5779,
      "tax_increase_rate": 0.03251742,
      "value_increase_rate": 0.16087751
    },
    {
      "time": 1717331492137,
      "value": 32820,
      "tax_paid": 5597,
      "tax_increase_rate": 0,
      "value_increase_rate": -0.056896552
    }
  ],
  "has_vr_model": true,
  "parent_region": {
    "name": "Huguenot"
  },
  "price_history": [
    {
      "date": "2026-05-28",
      "time": 1779926400000,
      "event": "Listed for sale",
      "price": 699000,
      "source": "BNYMLS",
      "buyer_agent": null,
      "seller_agent": null,
      "attribute_source": {
        "info_string1": "501695",
        "info_string2": "BNYMLS",
        "info_string3": "https://photos.zillowstatic.com/fp/f37ed42b0d788acca8559b8191bfb76f-zillow_web_logo_inf_11.jpg"
      },
      "show_county_link": false,
      "posting_is_rental": false,
      "price_change_rate": 0,
      "price_per_square_foot": 280
    }
  ],
  "brokerage_name": "Real Broker NY LLC",
  "days_on_zillow": 4,
  "favorite_count": 116,
  "lot_area_units": "Square Feet",
  "lot_area_value": 2773,
  "rent_zestimate": 3783,
  "street_address": "20 Kyle Ct",
  "time_on_zillow": "4 days",
  "page_view_count": 3347,
  "assigned_schools": [
    {
      "link": "https://www.greatschools.org/new-york/staten-island/2036-Ps-4-Maurice-Wollin/",
      "name": "Ps 4 Maurice Wollin",
      "type": "Public",
      "level": "Primary",
      "grades": "PK-5",
      "rating": 8,
      "distance": 0.4,
      "school_id": 49340,
      "enrollment": 862,
      "district_id": 6907,
      "district_name": "New York City Geographic District #31",
      "themed_ratings": [
        {
          "name": "Test scores rating",
          "type": "testScores",
          "rating": 8
        },
        {
          "name": "Academic progress rating",
          "type": "academicProgress",
          "rating": 8
        }
      ],
      "student_teacher_ratio": 9.25,
      "student_counselor_ratio": 375,
      "percentage_of_full_time_teachers_who_are_certified": 100
    }
  ],
  "attribution_info": {
    "mls_id": "501695",
    "mls_name": "BNYMLS",
    "agent_name": "Joseph Ranola",
    "broker_name": "Real Broker NY LLC",
    "listing_agents": [
      {
        "member_full_name": "Joseph Ranola",
        "member_state_license": null,
        "associated_agent_type": "listAgent"
      }
    ],
    "listing_offices": [
      {
        "office_name": "Real Broker NY LLC",
        "associated_office_type": "listOffice"
      }
    ],
    "attribution_title": "Listing by:"
  },
  "listing_sub_type": {
    "is_fsba": true,
    "is_fsbo": false,
    "is_pending": false,
    "is_new_home": false,
    "is_bank_owned": false,
    "is_open_house": false,
    "is_coming_soon": false,
    "is_for_auction": false,
    "is_foreclosure": false
  },
  "hi_res_image_link": "https://photos.zillowstatic.com/fp/b57fe9b7438cd7ee0a05df7753c78812-p_f.jpg",
  "living_area_units": "Square Feet",
  "living_area_value": 2500,
  "abbreviated_address": "20 Kyle Ct",
  "is_showcase_listing": true,
  "neighborhood_region": {
    "name": "Huguenot"
  },
  "listing_type_dimension": "For Sale by Agent",
  "property_type_dimension": "Single Family"
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}