# Zillow Property ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/zillow/property` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 3 credits per call | | **Documentation** | https://www.piloterr.com/library/zillow-property | ## Description Extract full property details from a Zillow homedetails URL, including specs, photos, schools, tax history, and agent attribution. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/zillow/property' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Lookup 20 Kyle Ct, Staten Island ```json { "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" } ``` ## Documentation ## Overview Extract comprehensive property details from a Zillow listing page. Returns pricing, specs, photos, schools, tax history, agent attribution, RESO facts, and neighborhood metadata in structured JSON. ## Quickstart ``` GET https://api.piloterr.com/v2/zillow/property?query=https://www.zillow.com/homedetails/20-Kyle-Ct-Staten-Island-NY-10312/32361983_zpid/ ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Full Zillow homedetails URL | ## Response fields | Field | Type | Description | |---|---|---| | `zpid` | integer | Zillow property ID | | `id` | string | Internal property identifier | | `price` | integer | List price | | `currency` | string | Price currency (USD) | | `street_address` | string | Street address | | `city` | string | City | | `state` | string | State code | | `zipcode` | string | ZIP code | | `county` | string | County name | | `bedrooms` | integer | Number of bedrooms | | `bathrooms` | integer | Number of bathrooms | | `living_area` | integer | Living area in sqft | | `lot_size` | integer | Lot size in sqft | | `year_built` | integer | Year built | | `home_type` | string | Home type code (e.g. SINGLE_FAMILY) | | `home_status` | string | Listing status (e.g. FOR_SALE) | | `description` | string | Property description | | `zestimate` | integer | Zillow Zestimate | | `rent_zestimate` | integer | Rent Zestimate | | `days_on_zillow` | integer | Days on market | | `brokerage_name` | string | Listing brokerage | | `hdp_url` | string | Relative homedetails path | | `latitude` | number | Latitude | | `longitude` | number | Longitude | | `photos` | array | Listing photos with URLs and captions | | `schools` | array | Nearby schools with ratings | | `price_history` | array | Price change history | | `tax_history` | array | Property tax history | | `attribution_info` | object | MLS and agent attribution | | `listing_sub_type` | object | Listing flags (FSBA, pending, etc.) | | `reso_facts` | object | RESO-standard property facts | | `neighborhood_region` | object | Neighborhood name | | `has_vr_model` | boolean | 3D / VR tour available | ## Notes - Only full Zillow homedetails URLs are accepted as `query`. - Use the `detail_url` field from Zillow Search results as the Property `query` value. - The response includes many optional fields depending on listing type and data availability. ## Main use cases - Enrich CRM records with full property specs and photos - Analyze tax history, price history, and days-on-market trends - Extract agent and brokerage attribution for lead routing - Power comp tools with beds, baths, lot size, and RESO facts