> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Property Detail
> Maximal detail for a single Zillow property — home facts, price/tax/Zestimate history, schools, agent, and mortgage rates.
## Path Parameters
The Zillow property id (`zpid`). You can find it in search results (`zpid`) or extract it from a `/homedetails/...` URL (the `NNNNN_zpid` segment).
You can also fetch a property by full URL: `GET /v1/zillow/property?url=`.
## Response
The response wraps a single `Property` object under a `property` key. It carries \~99 top-level fields plus the nested blocks below.
Zillow property id.
Internal id (nullable).
Full listing URL (nullable).
Home status, e.g. `FOR_SALE`, `SOLD`, `PENDING` (nullable).
Home type, e.g. `SINGLE_FAMILY`, `CONDO` (nullable).
Property type (nullable).
Listing type (nullable).
Posting product type (nullable).
Listing data source (nullable).
MLS number (nullable).
Parcel id (nullable).
County FIPS code (nullable).
Provider listing id (nullable).
Broker id (nullable).
Contingency type (nullable).
Listing sub-type flags: `is_fsba`, `is_fsbo`, `is_foreclosure`, `is_bank_owned`, `is_for_auction`, `is_coming_soon`, `is_new_home`, `is_pending` (nullable).
Current price in USD (nullable).
ISO 4217 currency code (nullable).
Lower bound of a price range (nullable).
Monthly HOA fee (nullable).
Property tax rate (nullable).
Annual homeowners insurance estimate (nullable).
Last sold price (nullable).
Last sold date as a Unix timestamp (nullable).
Last sold date as an ISO-8601 string (nullable).
Signed price change amount (nullable).
Price-change date as a Unix timestamp (nullable).
Price-change date as an ISO-8601 string (nullable).
Current Zestimate value (nullable).
Current Rent Zestimate (nullable).
Zestimate low bound as a percent (nullable).
Zestimate high bound as a percent (nullable).
Rent Zestimate low bound as a percent (nullable).
Rent Zestimate high bound as a percent (nullable).
Zestimate 30 days ago (nullable).
Rent Zestimate 30 days ago (nullable).
Tax-assessed value (nullable).
Zestimate value-history series.
Raw date label (nullable).
Date as a Unix timestamp (nullable).
Date as an ISO-8601 string (nullable).
Zestimate value at the point (nullable).
Number of bedrooms (nullable).
Number of bathrooms (nullable).
Interior area (nullable).
Interior area units (nullable).
Lot size (nullable).
Lot area value (nullable).
Lot area units (nullable).
Year built (nullable).
Move-in-ready flag (nullable).
Move-in completion date (nullable).
Latitude (nullable).
Longitude (nullable).
Street line (nullable).
Abbreviated address (nullable).
City (nullable).
State code (nullable).
ZIP code (nullable).
County (nullable).
Country code (nullable).
IANA time zone (nullable).
Neighborhood (nullable).
Whether the address is withheld (nullable).
Income-restricted flag (nullable).
Days on Zillow (nullable).
Human time-on-Zillow string (nullable).
Page view count (nullable).
Favorite/save count (nullable).
Tour view count (nullable).
Number of photos (nullable).
Listing description (nullable).
Owner's "what I love" note (nullable).
Editorial insight tags (list of strings).
Marketing name (nullable).
Brokerage name (nullable).
Showcase listing flag (nullable).
VR model flag (nullable).
3D model flag (nullable).
Virtual tour URL (nullable).
Interactive floor plan URL (nullable).
Street View image URL (nullable).
Static map image URL (nullable).
New-construction type (nullable).
Builder name (nullable).
Promotion headline (nullable).
Promotion description (nullable).
Whether a promotion is present (nullable).
Structured address: `street_address`, `city`, `state`, `zipcode`, `community`, `subdivision`, `neighborhood` (nullable).
High-value subset of Zillow's `resoFacts` MLS block (\~125 fields), grouped below (nullable).
`bathrooms_full`, `bathrooms_half`, `bathrooms_three_quarter`, `bathrooms_one_quarter`.
`stories`, `stories_decimal`, `levels`, `property_condition`, `architectural_style`, `structure_type`, `building_name`, `construction_materials[]`, `foundation_details[]`, `roof_type`, `year_built_effective`.
`above_grade_finished_area`, `below_grade_finished_area`, `lot_size_dimensions`, `main_level_bedrooms`, `main_level_bathrooms`, `basement`, `has_basement`, `attic`.
`heating[]`, `cooling[]`, `appliances[]`, `flooring[]`, `utilities[]`, `electric[]`, `gas[]`, `sewer[]`, `water_source[]`.
`green_building_verification_type[]`, `green_energy_efficient[]`, `green_energy_generation[]`, `green_sustainability[]`, `green_water_conservation[]`.
`interior_features[]`, `exterior_features[]`, `lot_features[]`, `community_features[]`, `accessibility_features[]`, `door_features[]`, `window_features[]`, `laundry_features[]`, `patio_and_porch_features[]`, `fencing[]`, `other_structures[]`, `view[]`, `has_view`, `waterfront_features[]`, `water_view`, `water_body_name`, `security_features[]`.
`parking_features[]`, `parking_capacity`, `garage_parking_capacity`, `carport_parking_capacity`, `covered_parking_capacity`, `open_parking_capacity`, `has_attached_garage`, `has_garage`, `has_carport`, `has_open_parking`.
`pool_features[]`, `has_private_pool`, `spa_features[]`, `fireplaces`, `fireplace_features[]`, `has_fireplace`.
`association_name`, `association_name2`, `association_fee`, `association_fee2`, `association_fee_includes[]`, `association_amenities[]`, `association_phone`, `has_association`, `hoa_fee`, `hoa_fee_total`, `tax_annual_amount`, `price_per_square_foot`.
`has_land_lease`, `land_lease_amount`, `land_lease_expiration_date`, `can_raise_horses`, `additional_parcels_description`, `road_surface_type[]`.
`on_market_date`, `cumulative_days_on_market`, `offer_review_date`.
`number_of_units_in_community`, `availability_date`, `lease_term`, `tenant_pays[]`, `has_pets_allowed`, `pets_max_weight`, `has_rent_control`.
`elementary_school`, `middle_school`, `high_school`, `elementary_school_district`, `middle_school_district`, `high_school_district`.
`parcel_number`, `subdivision_name`, `municipality`, `city_region`, `zoning`, `zoning_description`, `ownership`, `ownership_type`, `property_sub_type[]`, `special_listing_conditions`, `listing_terms`, `inclusions`, `exclusions`.
`is_new_construction`, `is_senior_community`, `has_home_warranty`, `furnished`, `development_status`, `park_name`.
`at_a_glance_facts[]`, `rooms[]` — label/value pairs Zillow ships verbatim.
Listing-agent / broker attribution (from `attributionInfo`).
Listing agent name (nullable).
Listing agent phone (nullable).
Listing agent email (nullable).
Listing agent license number (nullable).
Co-agent name (nullable).
Co-agent phone (nullable).
Co-agent license number (nullable).
Broker name (nullable).
Broker phone (nullable).
Buyer agent name (nullable).
Buyer brokerage name (nullable).
MLS id (nullable).
MLS name (nullable).
MLS disclaimer text (nullable).
Listing agreement type (nullable).
Attribution contact (nullable).
Provider logo URL (nullable).
True listing status (nullable).
Last-checked timestamp (nullable).
Last-updated timestamp (nullable).
Raw listing-agent records.
Raw listing-office records.
Current mortgage rates: `fifteen_year_fixed`, `thirty_year_fixed`, `arm_5`, each `{ rate, rate_source, last_updated_utc, last_updated_at }` (nullable).
Price / listing events over time.
Raw date label (nullable).
Event date as a Unix timestamp (nullable).
Event date as an ISO-8601 string (nullable).
Event type, e.g. `Listed for sale`, `Price change`, `Sold` (nullable).
Price at the event (nullable).
Price per sqft at the event (nullable).
Price change rate (nullable).
Event source (nullable).
Buyer agent (nullable).
Seller agent (nullable).
Whether the event was a rental posting (nullable).
Yearly tax records.
Tax year as a Unix timestamp (nullable).
Tax year as an ISO-8601 string (nullable).
Assessed value (nullable).
Assessed-value increase rate (nullable).
Tax paid (nullable).
Tax increase rate (nullable).
Nearby schools.
School name (nullable).
GreatSchools rating (nullable).
Grade range, e.g. `K-5` (nullable).
Level, e.g. `Elementary`, `Middle`, `High`, `Primary` (nullable).
Type, e.g. `Public`, `Private`, `Charter` (nullable).
Distance from the property in miles (nullable).
School profile URL (nullable).
Student count (nullable).
Whether the school is assigned to this home (nullable).
Photo objects: `url`, `caption`, `subject_type`, and responsive `sources[]` (`{ url, width, format }`).
Open-house objects: `start_utc`, `start_at`, `end_utc`, `end_at`, `note`.
Linked nearby cities: `name`, `region_type`, `url`.
Linked nearby neighborhoods: `name`, `region_type`, `url`.
Linked nearby ZIP codes: `name`, `region_type`, `url`.
Nearby homes (usually empty in server-rendered JSON; same shape as a search `Listing`).
Scrape time as a Unix timestamp (nullable).
Scrape time as an ISO-8601 string (nullable).
### Example Response
```json theme={null}
{
"property": {
"zpid": "29499726",
"url": "https://www.zillow.com/homedetails/123-Main-St-Austin-TX-78701/29499726_zpid/",
"home_status": "FOR_SALE",
"home_type": "SINGLE_FAMILY",
"price": 460000,
"currency": "USD",
"monthly_hoa_fee": 45,
"zestimate": 468000,
"rent_zestimate": 2600,
"tax_assessed_value": 420000,
"bedrooms": 3,
"bathrooms": 2,
"living_area": 1800,
"lot_size": 6500,
"year_built": 2015,
"street_address": "123 Main St",
"city": "Austin",
"state": "TX",
"zipcode": "78701",
"county": "Travis",
"latitude": 30.2672,
"longitude": -97.7431,
"photo_count": 32,
"description": "Charming single-family home in the heart of downtown...",
"home_insights": ["Hardwood floors", "Updated kitchen"],
"home_facts": {
"bathrooms_full": 2,
"stories": 2,
"architectural_style": "Traditional",
"heating": ["Central"],
"cooling": ["Central Air"],
"appliances": ["Dishwasher", "Refrigerator"],
"has_garage": true,
"parcel_number": "0203040506",
"tax_annual_amount": 6200
},
"agent": {
"agent_name": "Jane Doe",
"agent_phone": "512-555-0100",
"broker_name": "Downtown Realty Group",
"mls_id": "ACT1234567",
"mls_name": "ACTRIS"
},
"mortgage_rates": {
"thirty_year_fixed": { "rate": 6.8, "rate_source": "Zillow" }
},
"price_history": [
{ "date_at": "2026-06-01T00:00:00Z", "event": "Listed for sale", "price": 460000, "price_per_square_foot": 256 }
],
"tax_history": [
{ "year_at": "2024-01-01T00:00:00Z", "value": 420000, "tax_paid": 6200 }
],
"zestimate_history": [
{ "date_at": "2026-05-01T00:00:00Z", "value": 465000 }
],
"schools": [
{ "name": "Austin Elementary", "rating": 8, "grades": "K-5", "level": "Elementary", "type": "Public", "distance": 0.4, "assigned": true }
],
"photos": [
{ "url": "https://photos.zillowstatic.com/fp/abc-p_f.jpg", "caption": "Front", "sources": [{ "url": "https://photos.zillowstatic.com/fp/abc-p_e.webp", "width": 768, "format": "webp" }] }
],
"scraped_at": "2026-07-07T12:00:00Z"
}
}
```
Each property-detail request costs **5 credits**. Failed requests are not charged.
## OpenAPI
````yaml GET /v1/zillow/property/{zpid}
openapi: 3.1.0
info:
title: ScrapeBadger Zillow API
version: 1.0.0
description: >-
Dedicated Zillow scraping API for searching for-sale / for-rent / sold
listings, fetching maximal property detail (resoFacts home facts,
price/tax/Zestimate history, schools, agent attribution, mortgage rates,
photos), agent profiles (reviews, past sales, licenses), region/address
autocomplete, and coverage reference data.
servers:
- url: https://scrapebadger.com
description: Production
security:
- apiKeyAuth: []
paths:
/v1/zillow/property/{zpid}:
get:
tags:
- Zillow Property
summary: Get Property Detail
description: Get a single Zillow property's full detail by its zpid.
operationId: getZillowProperty
parameters:
- name: zpid
in: path
required: true
schema:
type: string
description: The Zillow property id (zpid).
responses:
'200':
description: Property detail
content:
application/json:
schema:
type: object
properties:
property:
$ref: '#/components/schemas/Property'
components:
schemas:
Property:
description: Full Zillow property detail (from `gdpClientCache[...].property`).
properties:
zpid:
type: string
id:
anyOf:
- type: string
- type: 'null'
url:
anyOf:
- type: string
- type: 'null'
home_status:
anyOf:
- type: string
- type: 'null'
home_type:
anyOf:
- type: string
- type: 'null'
property_type:
anyOf:
- type: string
- type: 'null'
listing_type:
anyOf:
- type: string
- type: 'null'
posting_product_type:
anyOf:
- type: string
- type: 'null'
listing_data_source:
anyOf:
- type: string
- type: 'null'
mls_id:
anyOf:
- type: string
- type: 'null'
parcel_id:
anyOf:
- type: string
- type: 'null'
county_fips:
anyOf:
- type: string
- type: 'null'
provider_listing_id:
anyOf:
- type: string
- type: 'null'
broker_id:
anyOf:
- type: string
- type: 'null'
contingent_listing_type:
anyOf:
- type: string
- type: 'null'
listing_sub_type:
anyOf:
- $ref: '#/components/schemas/ListingSubType'
- type: 'null'
price:
anyOf:
- type: integer
- type: 'null'
currency:
anyOf:
- type: string
- type: 'null'
list_price_low:
anyOf:
- type: integer
- type: 'null'
monthly_hoa_fee:
anyOf:
- type: integer
- type: 'null'
property_tax_rate:
anyOf:
- type: number
- type: 'null'
annual_homeowners_insurance:
anyOf:
- type: integer
- type: 'null'
last_sold_price:
anyOf:
- type: integer
- type: 'null'
date_sold_utc:
anyOf:
- type: number
- type: 'null'
date_sold_at:
anyOf:
- type: string
- type: 'null'
price_change:
anyOf:
- type: integer
- type: 'null'
price_change_date_utc:
anyOf:
- type: number
- type: 'null'
price_change_date_at:
anyOf:
- type: string
- type: 'null'
zestimate:
anyOf:
- type: integer
- type: 'null'
rent_zestimate:
anyOf:
- type: integer
- type: 'null'
zestimate_low_percent:
anyOf:
- type: string
- type: 'null'
zestimate_high_percent:
anyOf:
- type: string
- type: 'null'
rent_zestimate_low_percent:
anyOf:
- type: string
- type: 'null'
rent_zestimate_high_percent:
anyOf:
- type: string
- type: 'null'
zestimate_30_days_ago:
anyOf:
- type: integer
- type: 'null'
rent_zestimate_30_days_ago:
anyOf:
- type: integer
- type: 'null'
tax_assessed_value:
anyOf:
- type: integer
- type: 'null'
zestimate_history:
items:
$ref: '#/components/schemas/ZestimateHistoryPoint'
type: array
bedrooms:
anyOf:
- type: number
- type: 'null'
bathrooms:
anyOf:
- type: number
- type: 'null'
living_area:
anyOf:
- type: integer
- type: 'null'
living_area_units:
anyOf:
- type: string
- type: 'null'
lot_size:
anyOf:
- type: integer
- type: 'null'
lot_area_value:
anyOf:
- type: number
- type: 'null'
lot_area_units:
anyOf:
- type: string
- type: 'null'
year_built:
anyOf:
- type: integer
- type: 'null'
move_in_ready:
anyOf:
- type: boolean
- type: 'null'
move_in_completion_date:
anyOf:
- type: string
- type: 'null'
latitude:
anyOf:
- type: number
- type: 'null'
longitude:
anyOf:
- type: number
- type: 'null'
street_address:
anyOf:
- type: string
- type: 'null'
abbreviated_address:
anyOf:
- type: string
- type: 'null'
city:
anyOf:
- type: string
- type: 'null'
state:
anyOf:
- type: string
- type: 'null'
zipcode:
anyOf:
- type: string
- type: 'null'
county:
anyOf:
- type: string
- type: 'null'
country:
anyOf:
- type: string
- type: 'null'
time_zone:
anyOf:
- type: string
- type: 'null'
neighborhood:
anyOf:
- type: string
- type: 'null'
is_undisclosed_address:
anyOf:
- type: boolean
- type: 'null'
is_income_restricted:
anyOf:
- type: boolean
- type: 'null'
days_on_zillow:
anyOf:
- type: integer
- type: 'null'
time_on_zillow:
anyOf:
- type: string
- type: 'null'
page_view_count:
anyOf:
- type: integer
- type: 'null'
favorite_count:
anyOf:
- type: integer
- type: 'null'
tour_view_count:
anyOf:
- type: integer
- type: 'null'
photo_count:
anyOf:
- type: integer
- type: 'null'
description:
anyOf:
- type: string
- type: 'null'
what_i_love:
anyOf:
- type: string
- type: 'null'
home_insights:
items:
type: string
type: array
marketing_name:
anyOf:
- type: string
- type: 'null'
brokerage_name:
anyOf:
- type: string
- type: 'null'
is_showcase_listing:
anyOf:
- type: boolean
- type: 'null'
has_vr_model:
anyOf:
- type: boolean
- type: 'null'
has_3d_model:
anyOf:
- type: boolean
- type: 'null'
virtual_tour_url:
anyOf:
- type: string
- type: 'null'
interactive_floor_plan_url:
anyOf:
- type: string
- type: 'null'
street_view_image_url:
anyOf:
- type: string
- type: 'null'
static_map_url:
anyOf:
- type: string
- type: 'null'
new_construction_type:
anyOf:
- type: string
- type: 'null'
builder_name:
anyOf:
- type: string
- type: 'null'
promotion_headline:
anyOf:
- type: string
- type: 'null'
promotion_description:
anyOf:
- type: string
- type: 'null'
has_promotion:
anyOf:
- type: boolean
- type: 'null'
address:
anyOf:
- $ref: '#/components/schemas/Address'
- type: 'null'
home_facts:
anyOf:
- $ref: '#/components/schemas/HomeFacts'
- type: 'null'
agent:
anyOf:
- $ref: '#/components/schemas/AgentAttribution'
- type: 'null'
mortgage_rates:
anyOf:
- $ref: '#/components/schemas/MortgageRates'
- type: 'null'
price_history:
items:
$ref: '#/components/schemas/PriceHistoryEvent'
type: array
tax_history:
items:
$ref: '#/components/schemas/TaxHistoryEvent'
type: array
schools:
items:
$ref: '#/components/schemas/School'
type: array
photos:
items:
$ref: '#/components/schemas/Photo'
type: array
open_house_schedule:
items:
$ref: '#/components/schemas/OpenHouse'
type: array
nearby_cities:
items:
$ref: '#/components/schemas/NearbyRegion'
type: array
nearby_neighborhoods:
items:
$ref: '#/components/schemas/NearbyRegion'
type: array
nearby_zipcodes:
items:
$ref: '#/components/schemas/NearbyRegion'
type: array
nearby_homes:
items:
$ref: '#/components/schemas/Listing'
type: array
scraped_utc:
anyOf:
- type: number
- type: 'null'
scraped_at:
anyOf:
- type: string
- type: 'null'
required:
- zpid
type: object
ListingSubType:
description: '`listingSubType` flags — the for-sale / foreclosure / auction taxonomy.'
properties:
is_fsba:
anyOf:
- type: boolean
- type: 'null'
is_fsbo:
anyOf:
- type: boolean
- type: 'null'
is_foreclosure:
anyOf:
- type: boolean
- type: 'null'
is_bank_owned:
anyOf:
- type: boolean
- type: 'null'
is_for_auction:
anyOf:
- type: boolean
- type: 'null'
is_coming_soon:
anyOf:
- type: boolean
- type: 'null'
is_new_home:
anyOf:
- type: boolean
- type: 'null'
is_pending:
anyOf:
- type: boolean
- type: 'null'
type: object
ZestimateHistoryPoint:
description: One point in the Zestimate value history series (`homeValueChartData`).
properties:
date:
anyOf:
- type: string
- type: 'null'
date_utc:
anyOf:
- type: number
- type: 'null'
date_at:
anyOf:
- type: string
- type: 'null'
value:
anyOf:
- type: integer
- type: 'null'
type: object
Address:
properties:
street_address:
anyOf:
- type: string
- type: 'null'
city:
anyOf:
- type: string
- type: 'null'
state:
anyOf:
- type: string
- type: 'null'
zipcode:
anyOf:
- type: string
- type: 'null'
community:
anyOf:
- type: string
- type: 'null'
subdivision:
anyOf:
- type: string
- type: 'null'
neighborhood:
anyOf:
- type: string
- type: 'null'
type: object
HomeFacts:
description: >-
High-value subset of Zillow's `resoFacts` MLS block.
ponytail: resoFacts carries ~187 keys; these are the ones competitors
surface and callers actually query. Add more from resoFacts when a
concrete
use-case demands it.
properties:
bathrooms_full:
anyOf:
- type: integer
- type: 'null'
bathrooms_half:
anyOf:
- type: integer
- type: 'null'
bathrooms_three_quarter:
anyOf:
- type: integer
- type: 'null'
bathrooms_one_quarter:
anyOf:
- type: integer
- type: 'null'
stories:
anyOf:
- type: integer
- type: 'null'
stories_decimal:
anyOf:
- type: number
- type: 'null'
levels:
anyOf:
- type: string
- type: 'null'
property_condition:
anyOf:
- type: string
- type: 'null'
architectural_style:
anyOf:
- type: string
- type: 'null'
structure_type:
anyOf:
- type: string
- type: 'null'
building_name:
anyOf:
- type: string
- type: 'null'
construction_materials:
items:
type: string
type: array
foundation_details:
items:
type: string
type: array
roof_type:
anyOf:
- type: string
- type: 'null'
year_built_effective:
anyOf:
- type: integer
- type: 'null'
above_grade_finished_area:
anyOf:
- type: string
- type: 'null'
below_grade_finished_area:
anyOf:
- type: string
- type: 'null'
lot_size_dimensions:
anyOf:
- type: string
- type: 'null'
main_level_bedrooms:
anyOf:
- type: integer
- type: 'null'
main_level_bathrooms:
anyOf:
- type: integer
- type: 'null'
basement:
anyOf:
- type: string
- type: 'null'
has_basement:
anyOf:
- type: boolean
- type: 'null'
attic:
anyOf:
- type: string
- type: 'null'
heating:
items:
type: string
type: array
cooling:
items:
type: string
type: array
appliances:
items:
type: string
type: array
flooring:
items:
type: string
type: array
utilities:
items:
type: string
type: array
electric:
items:
type: string
type: array
gas:
items:
type: string
type: array
sewer:
items:
type: string
type: array
water_source:
items:
type: string
type: array
green_building_verification_type:
items:
type: string
type: array
green_energy_efficient:
items:
type: string
type: array
green_energy_generation:
items:
type: string
type: array
green_sustainability:
items:
type: string
type: array
green_water_conservation:
items:
type: string
type: array
interior_features:
items:
type: string
type: array
exterior_features:
items:
type: string
type: array
lot_features:
items:
type: string
type: array
community_features:
items:
type: string
type: array
accessibility_features:
items:
type: string
type: array
door_features:
items:
type: string
type: array
window_features:
items:
type: string
type: array
laundry_features:
items:
type: string
type: array
patio_and_porch_features:
items:
type: string
type: array
fencing:
items:
type: string
type: array
other_structures:
items:
type: string
type: array
view:
items:
type: string
type: array
has_view:
anyOf:
- type: boolean
- type: 'null'
waterfront_features:
items:
type: string
type: array
water_view:
anyOf:
- type: string
- type: 'null'
water_body_name:
anyOf:
- type: string
- type: 'null'
security_features:
items:
type: string
type: array
parking_features:
items:
type: string
type: array
parking_capacity:
anyOf:
- type: integer
- type: 'null'
garage_parking_capacity:
anyOf:
- type: integer
- type: 'null'
carport_parking_capacity:
anyOf:
- type: integer
- type: 'null'
covered_parking_capacity:
anyOf:
- type: integer
- type: 'null'
open_parking_capacity:
anyOf:
- type: integer
- type: 'null'
has_attached_garage:
anyOf:
- type: boolean
- type: 'null'
has_garage:
anyOf:
- type: boolean
- type: 'null'
has_carport:
anyOf:
- type: boolean
- type: 'null'
has_open_parking:
anyOf:
- type: boolean
- type: 'null'
pool_features:
items:
type: string
type: array
has_private_pool:
anyOf:
- type: boolean
- type: 'null'
spa_features:
items:
type: string
type: array
fireplaces:
anyOf:
- type: integer
- type: 'null'
fireplace_features:
items:
type: string
type: array
has_fireplace:
anyOf:
- type: boolean
- type: 'null'
association_name:
anyOf:
- type: string
- type: 'null'
association_name2:
anyOf:
- type: string
- type: 'null'
association_fee:
anyOf:
- type: string
- type: 'null'
association_fee2:
anyOf:
- type: string
- type: 'null'
association_fee_includes:
items:
type: string
type: array
association_amenities:
items:
type: string
type: array
association_phone:
anyOf:
- type: string
- type: 'null'
has_association:
anyOf:
- type: boolean
- type: 'null'
hoa_fee:
anyOf:
- type: string
- type: 'null'
hoa_fee_total:
anyOf:
- type: string
- type: 'null'
tax_annual_amount:
anyOf:
- type: number
- type: 'null'
price_per_square_foot:
anyOf:
- type: integer
- type: 'null'
has_land_lease:
anyOf:
- type: boolean
- type: 'null'
land_lease_amount:
anyOf:
- type: string
- type: 'null'
land_lease_expiration_date:
anyOf:
- type: string
- type: 'null'
can_raise_horses:
anyOf:
- type: boolean
- type: 'null'
additional_parcels_description:
anyOf:
- type: string
- type: 'null'
road_surface_type:
items:
type: string
type: array
on_market_date:
anyOf:
- type: string
- type: 'null'
cumulative_days_on_market:
anyOf:
- type: integer
- type: 'null'
offer_review_date:
anyOf:
- type: string
- type: 'null'
number_of_units_in_community:
anyOf:
- type: integer
- type: 'null'
availability_date:
anyOf:
- type: string
- type: 'null'
lease_term:
anyOf:
- type: string
- type: 'null'
tenant_pays:
items:
type: string
type: array
has_pets_allowed:
anyOf:
- type: boolean
- type: 'null'
pets_max_weight:
anyOf:
- type: integer
- type: 'null'
has_rent_control:
anyOf:
- type: boolean
- type: 'null'
elementary_school:
anyOf:
- type: string
- type: 'null'
middle_school:
anyOf:
- type: string
- type: 'null'
high_school:
anyOf:
- type: string
- type: 'null'
elementary_school_district:
anyOf:
- type: string
- type: 'null'
middle_school_district:
anyOf:
- type: string
- type: 'null'
high_school_district:
anyOf:
- type: string
- type: 'null'
parcel_number:
anyOf:
- type: string
- type: 'null'
subdivision_name:
anyOf:
- type: string
- type: 'null'
municipality:
anyOf:
- type: string
- type: 'null'
city_region:
anyOf:
- type: string
- type: 'null'
zoning:
anyOf:
- type: string
- type: 'null'
zoning_description:
anyOf:
- type: string
- type: 'null'
ownership:
anyOf:
- type: string
- type: 'null'
ownership_type:
anyOf:
- type: string
- type: 'null'
property_sub_type:
items:
type: string
type: array
special_listing_conditions:
anyOf:
- type: string
- type: 'null'
listing_terms:
anyOf:
- type: string
- type: 'null'
inclusions:
anyOf:
- type: string
- type: 'null'
exclusions:
anyOf:
- type: string
- type: 'null'
is_new_construction:
anyOf:
- type: boolean
- type: 'null'
is_senior_community:
anyOf:
- type: boolean
- type: 'null'
has_home_warranty:
anyOf:
- type: boolean
- type: 'null'
furnished:
anyOf:
- type: boolean
- type: 'null'
development_status:
anyOf:
- type: string
- type: 'null'
park_name:
anyOf:
- type: string
- type: 'null'
at_a_glance_facts:
items:
additionalProperties: true
type: object
type: array
rooms:
items:
additionalProperties: true
type: object
type: array
type: object
AgentAttribution:
description: Listing agent / broker attribution (from `attributionInfo`).
properties:
agent_name:
anyOf:
- type: string
- type: 'null'
agent_phone:
anyOf:
- type: string
- type: 'null'
agent_email:
anyOf:
- type: string
- type: 'null'
agent_license_number:
anyOf:
- type: string
- type: 'null'
co_agent_name:
anyOf:
- type: string
- type: 'null'
co_agent_number:
anyOf:
- type: string
- type: 'null'
co_agent_license_number:
anyOf:
- type: string
- type: 'null'
broker_name:
anyOf:
- type: string
- type: 'null'
broker_phone:
anyOf:
- type: string
- type: 'null'
buyer_agent_name:
anyOf:
- type: string
- type: 'null'
buyer_brokerage_name:
anyOf:
- type: string
- type: 'null'
mls_id:
anyOf:
- type: string
- type: 'null'
mls_name:
anyOf:
- type: string
- type: 'null'
mls_disclaimer:
anyOf:
- type: string
- type: 'null'
listing_agreement:
anyOf:
- type: string
- type: 'null'
listing_attribution_contact:
anyOf:
- type: string
- type: 'null'
provider_logo:
anyOf:
- type: string
- type: 'null'
true_status:
anyOf:
- type: string
- type: 'null'
last_checked:
anyOf:
- type: string
- type: 'null'
last_updated:
anyOf:
- type: string
- type: 'null'
listing_agents:
items:
additionalProperties: true
type: object
type: array
listing_offices:
items:
additionalProperties: true
type: object
type: array
type: object
MortgageRates:
properties:
fifteen_year_fixed:
anyOf:
- $ref: '#/components/schemas/MortgageRate'
- type: 'null'
thirty_year_fixed:
anyOf:
- $ref: '#/components/schemas/MortgageRate'
- type: 'null'
arm_5:
anyOf:
- $ref: '#/components/schemas/MortgageRate'
- type: 'null'
type: object
PriceHistoryEvent:
properties:
date:
anyOf:
- type: string
- type: 'null'
date_utc:
anyOf:
- type: number
- type: 'null'
date_at:
anyOf:
- type: string
- type: 'null'
event:
anyOf:
- type: string
- type: 'null'
price:
anyOf:
- type: integer
- type: 'null'
price_per_square_foot:
anyOf:
- type: integer
- type: 'null'
price_change_rate:
anyOf:
- type: number
- type: 'null'
source:
anyOf:
- type: string
- type: 'null'
buyer_agent:
anyOf:
- type: string
- type: 'null'
seller_agent:
anyOf:
- type: string
- type: 'null'
posting_is_rental:
anyOf:
- type: boolean
- type: 'null'
type: object
TaxHistoryEvent:
properties:
year_utc:
anyOf:
- type: number
- type: 'null'
year_at:
anyOf:
- type: string
- type: 'null'
value:
anyOf:
- type: integer
- type: 'null'
value_increase_rate:
anyOf:
- type: number
- type: 'null'
tax_paid:
anyOf:
- type: number
- type: 'null'
tax_increase_rate:
anyOf:
- type: number
- type: 'null'
type: object
School:
properties:
name:
anyOf:
- type: string
- type: 'null'
rating:
anyOf:
- type: integer
- type: 'null'
grades:
anyOf:
- type: string
- type: 'null'
level:
anyOf:
- type: string
- type: 'null'
type:
anyOf:
- type: string
- type: 'null'
distance:
anyOf:
- type: number
- type: 'null'
link:
anyOf:
- type: string
- type: 'null'
student_count:
anyOf:
- type: integer
- type: 'null'
assigned:
anyOf:
- type: boolean
- type: 'null'
type: object
Photo:
description: A single listing photo with its responsive source variants.
properties:
url:
anyOf:
- type: string
- type: 'null'
caption:
anyOf:
- type: string
- type: 'null'
subject_type:
anyOf:
- type: string
- type: 'null'
sources:
items:
additionalProperties: true
type: object
type: array
type: object
OpenHouse:
properties:
start_utc:
anyOf:
- type: number
- type: 'null'
start_at:
anyOf:
- type: string
- type: 'null'
end_utc:
anyOf:
- type: number
- type: 'null'
end_at:
anyOf:
- type: string
- type: 'null'
note:
anyOf:
- type: string
- type: 'null'
type: object
NearbyRegion:
description: A linked nearby region (city / neighborhood / zip) on a property page.
properties:
name:
anyOf:
- type: string
- type: 'null'
region_type:
anyOf:
- type: string
- type: 'null'
url:
anyOf:
- type: string
- type: 'null'
type: object
Listing:
description: |-
One Zillow search card (search / agent listings).
Merges the search `listResult` top-level with its richer
`hdpData.homeInfo` sub-object.
properties:
position:
type: integer
zpid:
anyOf:
- type: string
- type: 'null'
id:
anyOf:
- type: string
- type: 'null'
detail_url:
anyOf:
- type: string
- type: 'null'
home_type:
anyOf:
- type: string
- type: 'null'
home_status:
anyOf:
- type: string
- type: 'null'
status_text:
anyOf:
- type: string
- type: 'null'
status_type:
anyOf:
- type: string
- type: 'null'
marketing_status:
anyOf:
- type: string
- type: 'null'
contingent_listing_type:
anyOf:
- type: string
- type: 'null'
price:
anyOf:
- type: integer
- type: 'null'
price_raw:
anyOf:
- type: string
- type: 'null'
currency:
anyOf:
- type: string
- type: 'null'
price_change:
anyOf:
- type: integer
- type: 'null'
date_price_changed_utc:
anyOf:
- type: number
- type: 'null'
date_price_changed_at:
anyOf:
- type: string
- type: 'null'
price_reduction:
anyOf:
- type: string
- type: 'null'
flex_field_text:
anyOf:
- type: string
- type: 'null'
zestimate:
anyOf:
- type: integer
- type: 'null'
rent_zestimate:
anyOf:
- type: integer
- type: 'null'
tax_assessed_value:
anyOf:
- type: integer
- type: 'null'
beds:
anyOf:
- type: number
- type: 'null'
baths:
anyOf:
- type: number
- type: 'null'
living_area:
anyOf:
- type: integer
- type: 'null'
lot_area_value:
anyOf:
- type: number
- type: 'null'
lot_area_unit:
anyOf:
- type: string
- type: 'null'
address:
anyOf:
- type: string
- type: 'null'
street_address:
anyOf:
- type: string
- type: 'null'
unit:
anyOf:
- type: string
- type: 'null'
city:
anyOf:
- type: string
- type: 'null'
state:
anyOf:
- type: string
- type: 'null'
zipcode:
anyOf:
- type: string
- type: 'null'
country:
anyOf:
- type: string
- type: 'null'
is_undisclosed_address:
anyOf:
- type: boolean
- type: 'null'
latitude:
anyOf:
- type: number
- type: 'null'
longitude:
anyOf:
- type: number
- type: 'null'
broker_name:
anyOf:
- type: string
- type: 'null'
provider_listing_id:
anyOf:
- type: string
- type: 'null'
days_on_zillow:
anyOf:
- type: integer
- type: 'null'
is_zillow_owned:
anyOf:
- type: boolean
- type: 'null'
is_featured:
anyOf:
- type: boolean
- type: 'null'
is_showcase:
anyOf:
- type: boolean
- type: 'null'
is_fsba:
anyOf:
- type: boolean
- type: 'null'
is_new_construction:
anyOf:
- type: boolean
- type: 'null'
is_premier_builder:
anyOf:
- type: boolean
- type: 'null'
is_preforeclosure_auction:
anyOf:
- type: boolean
- type: 'null'
is_non_owner_occupied:
anyOf:
- type: boolean
- type: 'null'
img_src:
anyOf:
- type: string
- type: 'null'
has_image:
anyOf:
- type: boolean
- type: 'null'
has_video:
anyOf:
- type: boolean
- type: 'null'
has_3d_model:
anyOf:
- type: boolean
- type: 'null'
has_open_house:
anyOf:
- type: boolean
- type: 'null'
open_house_start:
anyOf:
- type: string
- type: 'null'
open_house_end:
anyOf:
- type: string
- type: 'null'
photos:
items:
type: string
type: array
required:
- position
type: object
MortgageRate:
properties:
rate:
anyOf:
- type: number
- type: 'null'
rate_source:
anyOf:
- type: string
- type: 'null'
last_updated_utc:
anyOf:
- type: number
- type: 'null'
last_updated_at:
anyOf:
- type: string
- type: 'null'
type: object
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-api-key
````