Data dictionary and schema for the market data responses.
This page contains a data dictionary and a description of all response fields for our market data endpoint (/markets
).
Market Statistics Response Fields
The following response fields will be returned by the market statistics endpoint ( /markets
):
Response Field | Description | Example Value |
---|---|---|
| Zip Code Id The zip code id, as a 5-digit number |
|
| Zip Code Name The zip code name, as a 5-digit number |
|
| Sale Data A field containing aggregate sale market statistics and property price trends for this zip code |
|
| Sale Data - Date Last Updated The date sale market statistics were last updated for this zip code, in ISO 8601 format |
|
| Sale Data - Statistics Fields A set of sale market statistics fields for all properties in this zip code. See explanation of sale statistics fields for more information | See examples in the following section |
| Sale Data - Data by Property Type A list of sale market statistics broken down and grouped by property type |
|
| Sale Data by Property Type - Property Type The type of property for each group. See explanation of property types for possible values |
|
| Sale Data by Property Type - Statistics Fields A set of sale market statistics fields for each property type. See explanation of sale statistics fields for more information | See examples in the following section |
| Sale Data - Data by Bedroom A list of sale market statistics broken down and grouped by the number of bedrooms |
|
| Sale Data by Bedroom - Number of Bedrooms The number of bedrooms for each group, with a value of "0" indicating a studio layout |
|
| Sale Data by Bedroom - Statistics Fields A set of sale market statistics fields for each number of bedrooms. See explanation of sale statistics fields for more information | See examples in the following section |
| Sale Data - History A list of monthly historical sale market statistics entries for this zip code, with JSON keys indicating the entry year and month, in the format |
|
| Sale Data - History Entry A single historical entry, with sale market statistics for a specific past month |
|
| Sale Data History Entry - Date The date of the first day of the month for this history entry, in ISO 8601 format |
|
| Sale Data History Entry - Statistics Fields A set of historical sale market statistics fields, including statistics for all properties in this zip code, as well as statistics broken down and grouped by property type and number of bedrooms. See explanation of sale statistics fields for more information | See examples in the following section |
| Rental Data A field containing aggregate rental market statistics and property rent trends for this zip code |
|
| Rental Data - Date Last Updated The date rental market statistics were last updated for this zip code, in ISO 8601 format |
|
| Rental Data - Statistics Fields A set of rental market statistics fields for all properties in this zip code. See explanation of rental statistics fields for more information | See examples in the following section |
| Rental Data - Data by Property Type A list of rental market statistics broken down and grouped by property type |
|
| Rental Data by Property Type - Property Type The type of property for each group. See explanation of property types for possible values |
|
| Rental Data by Property Type - Statistics Fields A set of rental market statistics fields for each property type. See explanation of rental statistics fields for more information | See examples in the following section |
| Rental Data - Data by Bedroom A list of rental market statistics broken down and grouped by the number of bedrooms |
|
| Rental Data by Bedroom - Number of Bedrooms The number of bedrooms for each group, with a value of "0" indicating a studio layout |
|
| Rental Data by Bedroom - Statistics Fields A set of rental market statistics fields for each number of bedrooms. See explanation of rental statistics fields for more information | See examples in the following section |
| Rental Data - History A list of monthly historical rental market statistics entries for this zip code, with JSON keys indicating the entry year and month, in the format |
|
| Rental Data - History Entry A single historical entry, with rental market statistics for a specific past month |
|
| Rental Data History Entry - Date The date of the first day of the month for this history entry, in ISO 8601 format |
|
| Rental Data History Entry - Statistics Fields A set of historical rental market statistics fields, including statistics for all properties in this zip code, as well as statistics broken down and grouped by property type and number of bedrooms. See explanation of rental statistics fields for more information | See examples in the following section |
Sale Statistics Fields
The following is a standard set of sale market statistics fields returned within the saleData
field of the market data responses.
These statistical fields are calculated based on active sale listings in a given zip code. Each response will provide these fields for the following group types:
- No grouping: statistics fields at the top level of the
saleData
field are calculated based on all sale listings in the zip code - Grouped by property type: statistics fields within the
dataByPropertyType
field are broken down and grouped by the property type of each listing. A separate set of statistics will be returned for each unique property type in the zip code - Grouped by property size: statistics fields within the
dataByBedrooms
field are broken down and grouped by the number of bedrooms of each listing. A separate set of statistics will be provided for each unique bedroom count in the zip code
In addition to sale market statistics for the current month, returned at the top level of the saleData
field, the response will contain historical market statistics at monthly intervals in the saleData.history
field.
Historical data will include sale market statistics for all properties in the zip code, as well as statistics broken down and grouped by property type and the number of bedrooms.
Historical sale market statistics are available from January 2024. Note, there may be gaps in the historical data when there were not enough listings to generate statistically significant averages.
Response Field | Description | Example Value |
---|---|---|
| Average Price The average sale price of all sale listings in the current group |
|
| Median Price The median sale price of all sale listings in the current group |
|
| Minimum Price The minimum sale price of all sale listings in the current group |
|
| Maximum Price The maximum sale price of all sale listings in the current group |
|
| Average Price Per Sq.Ft. The average sale price per square foot of living area of all sale listings in the current group |
|
| Median Price Per Sq.Ft. The median sale price per square foot of living area of all sale listings in the current group |
|
| Minimum Price Per Sq.Ft. The minimum sale price per square foot of living area of all sale listings in the current group |
|
| Maximum Price Per Sq.Ft. The maximum sale price per square foot of living area of all sale listings in the current group |
|
| Average Living Area (Sq.Ft.) The average indoor living area of all sale listings in the current group, in square feet |
|
| Median Living Area (Sq.Ft.) The median indoor living area of all sale listings in the current group, in square feet |
|
| Minimum Living Area (Sq.Ft.) The minimum indoor living area of all sale listings in the current group, in square feet |
|
| Maximum Living Area (Sq.Ft.) The maximum indoor living area of all sale listings in the current group, in square feet |
|
| Average Days on Market The average number of days sale listings in the current group have been active |
|
| Median Days on Market The median number of days sale listings in the current group have been active |
|
| Minimum Days on Market The minimum number of days sale listings in the current group have been active |
|
| Maximum Days on Market The maximum number of days sale listings in the current group have been active |
|
| Number of New Listings The number of active sale listings in the current group that have been added in a given month |
|
| Number of Total Listings The total number of sale listings in the current group that have been active at any point in a given month |
|
Rental Statistics Fields
The following is a standard set of rental market statistics fields returned within the rentalData
field of the market data responses.
These statistical fields are calculated based on active rental listings in a given zip code. Each response will provide these fields for the following group types:
- No grouping: statistics fields at the top level of the
rentalData
field are calculated based on all rental listings in the zip code - Grouped by property type: statistics fields within the
dataByPropertyType
field are broken down and grouped by the property type of each listing. A separate set of statistics will be returned for each unique property type in the zip code - Grouped by property size: statistics fields within the
dataByBedrooms
field are broken down and grouped by the number of bedrooms of each listing. A separate set of statistics will be provided for each unique bedroom count in the zip code
In addition to rental market statistics for the current month, returned at the top level of the rentalData
field, the response will contain historical market statistics at monthly intervals in the rentalData.history
field.
Historical data will include rental market statistics for all properties in the zip code, as well as statistics broken down and grouped by property type and the number of bedrooms.
Historical rental market statistics are available from April 2020. Note, there may be gaps in the historical data when there were not enough listings to generate statistically significant averages.
Response Field | Description | Example Value |
---|---|---|
| Average Rent The average rental rate of all rental listings in the current group |
|
| Median Rent The median rental rate of all rental listings in the current group |
|
| Minimum Rent The minimum rental rate of all rental listings in the current group |
|
| Maximum Rent The maximum rental rate of all rental listings in the current group |
|
| Average Rent Per Sq.Ft. The average rental rate per square foot of living area of all rental listings in the current group |
|
| Median Rent Per Sq.Ft. The median rental rate per square foot of living area of all rental listings in the current group |
|
| Minimum Rent Per Sq.Ft. The minimum rental rate per square foot of living area of all rental listings in the current group |
|
| Maximum Rent Per Sq.Ft. The maximum rental rate per square foot of living area of all rental listings in the current group |
|
| Average Living Area (Sq.Ft.) The average indoor living area of all rental listings in the current group, in square feet |
|
| Median Living Area (Sq.Ft.) The median indoor living area of all rental listings in the current group, in square feet |
|
| Minimum Living Area (Sq.Ft.) The minimum indoor living area of all rental listings in the current group, in square feet |
|
| Maximum Living Area (Sq.Ft.) The maximum indoor living area of all rental listings in the current group, in square feet |
|
| Average Days on Market The average number of days rental listings in the current group have been active |
|
| Median Days on Market The median number of days rental listings in the current group have been active |
|
| Minimum Days on Market The minimum number of days rental listings in the current group have been active |
|
| Maximum Days on Market The maximum number of days rental listings in the current group have been active |
|
| Number of New Listings The number of active rental listings in the current group that have been added in a given month |
|
| Number of Total Listings The total number of rental listings in the current group that have been active at any point in a given month |
|