Market Data Schema

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

id

Zip Code Id
Data type: String

The zip code id, as a 5-digit number

"29611"

zipCode

Zip Code Name
Data type: String

The zip code name, as a 5-digit number

"29611"

saleData

Sale Data
Data type: Object

A field containing aggregate sale market statistics and property price trends for this zip code

{ ... }

saleData
.lastUpdatedDate

Sale Data - Date Last Updated
Data type: Date

The date sale market statistics were last updated for this zip code, in ISO 8601 format

"2024-10-14T00:00:00.000Z"

saleData[...]

Sale Data - Statistics Fields
Data type: Number

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

saleData
.dataByPropertyType

Sale Data - Data by Property Type
Data type: Array

A list of sale market statistics broken down and grouped by property type

[ ... ]

saleData
.dataByPropertyType[]
.propertyType

Sale Data by Property Type - Property Type
Data type: String (Enum)

The type of property for each group. See explanation of property types for possible values

"Condo"

saleData
.dataByPropertyType[]
[...]

Sale Data by Property Type - Statistics Fields
Data type: Number

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

saleData
.dataByBedrooms

Sale Data - Data by Bedroom
Data type: Array

A list of sale market statistics broken down and grouped by the number of bedrooms

[ ... ]

saleData
.dataByBedrooms[]
.bedrooms

Sale Data by Bedroom - Number of Bedrooms
Data type: Number

The number of bedrooms for each group, with a value of "0" indicating a studio layout

1

saleData
.dataByBedrooms[]
[...]

Sale Data by Bedroom - Statistics Fields
Data type: Number

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

saleData.history

Sale Data - History
Data type: Object

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 YYYY-MM

{ "2024-08": { ... } }

saleData
.history[YYYY-MM]

Sale Data - History Entry
Data type: Object

A single historical entry, with sale market statistics for a specific past month

{ ... }

saleData
.history[YYYY-MM]
.date

Sale Data History Entry - Date
Data type: Date

The date of the first day of the month for this history entry, in ISO 8601 format

"2024-08-01T00:00:00.000Z"

saleData
.history[YYYY-MM]
[...]

Sale Data History Entry - Statistics Fields
Data type: Varies

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

rentalData

Rental Data
Data type: Object

A field containing aggregate rental market statistics and property rent trends for this zip code

{ ... }

rentalData
.lastUpdatedDate

Rental Data - Date Last Updated
Data type: Date

The date rental market statistics were last updated for this zip code, in ISO 8601 format

"2024-10-14T00:00:00.000Z"

rentalData[...]

Rental Data - Statistics Fields
Data type: Number

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

rentalData
.dataByPropertyType

Rental Data - Data by Property Type
Data type: Array

A list of rental market statistics broken down and grouped by property type

[ ... ]

rentalData
.dataByPropertyType[]
.propertyType

Rental Data by Property Type - Property Type
Data type: String (Enum)

The type of property for each group. See explanation of property types for possible values

"Apartment"

rentalData
.dataByPropertyType[]
[...]

Rental Data by Property Type - Statistics Fields
Data type: Number

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

rentalData
.dataByBedrooms

Rental Data - Data by Bedroom
Data type: Array

A list of rental market statistics broken down and grouped by the number of bedrooms

[ ... ]

rentalData
.dataByBedrooms[]
.bedrooms

Rental Data by Bedroom - Number of Bedrooms
Data type: Number

The number of bedrooms for each group, with a value of "0" indicating a studio layout

1

rentalData
.dataByBedrooms[]
[...]

Rental Data by Bedroom - Statistics Fields
Data type: Number

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

rentalData.history

Rental Data - History
Data type: Object

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 YYYY-MM

{ "2024-08": { ... } }

rentalData
.history[YYYY-MM]

Rental Data - History Entry
Data type: Object

A single historical entry, with rental market statistics for a specific past month

{ ... }

rentalData
.history[YYYY-MM]
.date

Rental Data History Entry - Date
Data type: Date

The date of the first day of the month for this history entry, in ISO 8601 format

"2024-08-01T00:00:00.000Z"

rentalData
.history[YYYY-MM]
[...]

Rental Data History Entry - Statistics Fields
Data type: Varies

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

averagePrice

Average Price
Data type: Number

The average sale price of all sale listings in the current group

291933

medianPrice

Median Price
Data type: Number

The median sale price of all sale listings in the current group

276990

minPrice

Minimum Price
Data type: Number

The minimum sale price of all sale listings in the current group

20000

maxPrice

Maximum Price
Data type: Number

The maximum sale price of all sale listings in the current group

1500000

averagePricePerSquareFoot

Average Price Per Sq.Ft.
Data type: Number

The average sale price per square foot of living area of all sale listings in the current group

186.53

medianPricePerSquareFoot

Median Price Per Sq.Ft.
Data type: Number

The median sale price per square foot of living area of all sale listings in the current group

178

minPricePerSquareFoot

Minimum Price Per Sq.Ft.
Data type: Number

The minimum sale price per square foot of living area of all sale listings in the current group

64.9

maxPricePerSquareFoot

Maximum Price Per Sq.Ft.
Data type: Number

The maximum sale price per square foot of living area of all sale listings in the current group

500

averageSquareFootage

Average Living Area (Sq.Ft.)
Data type: Number

The average indoor living area of all sale listings in the current group, in square feet

1698

medianSquareFootage

Median Living Area (Sq.Ft.)
Data type: Number

The median indoor living area of all sale listings in the current group, in square feet

1600

minSquareFootage

Minimum Living Area (Sq.Ft.)
Data type: Number

The minimum indoor living area of all sale listings in the current group, in square feet

610

maxSquareFootage

Maximum Living Area (Sq.Ft.)
Data type: Number

The maximum indoor living area of all sale listings in the current group, in square feet

4588

averageDaysOnMarket

Average Days on Market
Data type: Number

The average number of days sale listings in the current group have been active

67.21

medianDaysOnMarket

Median Days on Market
Data type: Number

The median number of days sale listings in the current group have been active

45

minDaysOnMarket

Minimum Days on Market
Data type: Number

The minimum number of days sale listings in the current group have been active

2

maxDaysOnMarket

Maximum Days on Market
Data type: Number

The maximum number of days sale listings in the current group have been active

348

newListings

Number of New Listings
Data type: Number

The number of active sale listings in the current group that have been added in a given month

21

totalListings

Number of Total Listings
Data type: Number

The total number of sale listings in the current group that have been active at any point in a given month

265

 

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

averageRent

Average Rent
Data type: Number

The average rental rate of all rental listings in the current group

1521

medianRent

Median Rent
Data type: Number

The median rental rate of all rental listings in the current group

1495

minRent

Minimum Rent
Data type: Number

The minimum rental rate of all rental listings in the current group

750

maxRent

Maximum Rent
Data type: Number

The maximum rental rate of all rental listings in the current group

2700

averageRentPerSquareFoot

Average Rent Per Sq.Ft.
Data type: Number

The average rental rate per square foot of living area of all rental listings in the current group

1.38

medianRentPerSquareFoot

Median Rent Per Sq.Ft.
Data type: Number

The median rental rate per square foot of living area of all rental listings in the current group

1.3

minRentPerSquareFoot

Minimum Rent Per Sq.Ft.
Data type: Number

The minimum rental rate per square foot of living area of all rental listings in the current group

0.86

maxRentPerSquareFoot

Maximum Rent Per Sq.Ft.
Data type: Number

The maximum rental rate per square foot of living area of all rental listings in the current group

2.59

averageSquareFootage

Average Living Area (Sq.Ft.)
Data type: Number

The average indoor living area of all rental listings in the current group, in square feet

1175

medianSquareFootage

Median Living Area (Sq.Ft.)
Data type: Number

The median indoor living area of all rental listings in the current group, in square feet

1100

minSquareFootage

Minimum Living Area (Sq.Ft.)
Data type: Number

The minimum indoor living area of all rental listings in the current group, in square feet

590

maxSquareFootage

Maximum Living Area (Sq.Ft.)
Data type: Number

The maximum indoor living area of all rental listings in the current group, in square feet

2100

averageDaysOnMarket

Average Days on Market
Data type: Number

The average number of days rental listings in the current group have been active

25

medianDaysOnMarket

Median Days on Market
Data type: Number

The median number of days rental listings in the current group have been active

8

minDaysOnMarket

Minimum Days on Market
Data type: Number

The minimum number of days rental listings in the current group have been active

1

maxDaysOnMarket

Maximum Days on Market
Data type: Number

The maximum number of days rental listings in the current group have been active

304

newListings

Number of New Listings
Data type: Number

The number of active rental listings in the current group that have been added in a given month

18

totalListings

Number of Total Listings
Data type: Number

The total number of rental listings in the current group that have been active at any point in a given month

76