Market Statistics
Overview
The Market Statistics API returns summary listing data about the market in specified geographical locations for display in a table, a graph, or other uses. Note that the data returns date fields, but the day is not significant; the data is actually for the month and year, not the day, month, and year.
Supported Roles
| Role | Reads | Writes | Notes |
|---|---|---|---|
| IDX | Yes | No | |
| Public | Yes | No | |
| VOW | Yes | No | |
| Portal | Yes | No | |
| Private | Yes | No |
More information about roles may be found here.
Available Services
Parameters common to all /marketstatistics services
| Name | Required | Expected | Notes |
|---|---|---|---|
LocationField |
No | String representing the location field (e.g. City) to return market statistic data | Defaults to all locations if LocationField and LocationValue are not supplied |
LocationValue |
No | String representing the location value (e.g. Fargo) to return market statistic data | Defaults to all locations if LocationField and LocationValue are not supplied |
PropertyTypeCode |
No | One MlsCode (property type code) from the Property Types API |
Defaults to the first Residential property type |
Options |
No | Varies based on each service | See documentation for each service |
Absorption Rate
URI: /<API Version>/marketstatistics/absorption
Common parameters plus the following:
GET Request
| Name | Required | Expected | Notes |
|---|---|---|---|
Options |
No | Comma-separated string with one or many of the following options:
|
The default if no Options parameter is specified is AbsorptionRate |
GET Response
{ "Dates": ["11/1/2010","10/1/2010","9/1/2010","8/1/2010","7/1/2010",
"6/1/2010","5/1/2010","4/1/2010","3/1/2010","2/1/2010",
"1/1/2010","12/1/2009"],
"AbsorptionRate": [6.11,5.14,4.51,5.15,5.33,6.01,4.92,4.98,5.01,5.33,4.77,4.1]
}Inventory
URI: /<API Version>/marketstatistics/inventory
Common parameters plus the following:
GET Request
| Name | Required | Expected | Notes |
|---|---|---|---|
Options |
No | Comma-separated string with one or many of the following options:
|
The default if no Options parameter is specified is ActiveListings,NewListings |
GET Response
{ "Dates": ["11/1/2010","10/1/2010","9/1/2010","8/1/2010","7/1/2010",
"6/1/2010","5/1/2010","4/1/2010","3/1/2010","2/1/2010",
"1/1/2010","12/1/2009"],
"ActiveListings": [10000,10005,10010,10015,9998,10221,10125,10222,10315,10008,10009,10001],
"NewListings": [100,101,105,109,99,100,105,102,102,98,95,92],
"PendedListings": [100,101,105,109,99,100,105,102,102,98,95,92],
"SoldListings": [100,101,105,109,99,100,105,102,102,98,95,92]
}Price
URI: /<API Version>/marketstatistics/price
Common parameters plus the following:
GET Request
| Name | Required | Expected | Notes |
|---|---|---|---|
Options |
No | Comma-separated string with one or many of the following options:
|
The default if no Options parameter is specified is ActiveAverageListPrice, ActiveMedianListPrice, NewAverageListPrice, NewMedianListPrice |
GET Response
{ "Dates": ["11/1/2010","10/1/2010","9/1/2010","8/1/2010","7/1/2010",
"6/1/2010","5/1/2010","4/1/2010","3/1/2010","2/1/2010",
"1/1/2010","12/1/2009"],
"ActiveAverageListPrice": [100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000],
"NewAverageListPrice": [100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000],
"PendedAverageListPrice": [100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000],
"SoldAverageListPrice": [100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000],
"SoldAverageSoldPrice": [100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000],
"ActiveMedianListPrice": [100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000],
"NewMedianListPrice": [100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000],
"PendedMedianListPrice": [100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000],
"SoldMedianListPrice": [100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000],
"SoldMedianSoldPrice": [100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000,100000]
}Sales to List Price Ratios
URI: /<API Version>/marketstatistics/ratio
Common parameters plus the following:
GET Request
| Name | Required | Expected | Notes |
|---|---|---|---|
Options |
No | Comma-separated string with one or many of the following options:
|
The default if no Options parameter is specified is SaleToOriginalListPriceRatio |
GET Response
{ "Dates": ["11/1/2010","10/1/2010","9/1/2010","8/1/2010","7/1/2010",
"6/1/2010","5/1/2010","4/1/2010","3/1/2010","2/1/2010",
"1/1/2010","12/1/2009"],
"SaleToOriginalListPriceRatio":[0.9834,0.9941,0.9898,0.9834,0.9941,0.9898,0.9834,0.9941,0.9898,0.9834,0.9941,0.9898],
"SaleToListPriceRatio": [0.9834,0.9941,0.9898,0.9834,0.9941,0.9898,0.9834,0.9941,0.9898,0.9834,0.9941,0.9898]
}Days On Market
URI: /<API Version>/marketstatistics/dom
Common parameters plus the following:
GET Request
| Name | Required | Expected | Notes |
|---|---|---|---|
Options |
No | Comma-separated string with one or many of the following options:
|
The default if no Options parameter is specified is AverageDom |
GET Response
{ "Dates": ["11/1/2010","10/1/2010","9/1/2010","8/1/2010","7/1/2010",
"6/1/2010","5/1/2010","4/1/2010","3/1/2010","2/1/2010",
"1/1/2010","12/1/2009"],
"AverageDom": [100,99,98,97,95,91,101,112,92,88,89,90],
"AverageCdom": [100,99,98,97,95,91,101,112,92,88,89,90]
}Volume
URI: /<API Version>/marketstatistics/volume
Common parameters plus the following:
GET Request
| Name | Required | Expected | Notes |
|---|---|---|---|
Options |
No | Comma-separated string with one or many of the following options:
|
The default if no Options parameter is specified is ActiveListVolume,NewListVolume |
GET Response
{ "Dates": ["11/1/2010","10/1/2010","9/1/2010","8/1/2010","7/1/2010",
"6/1/2010","5/1/2010","4/1/2010","3/1/2010","2/1/2010",
"1/1/2010","12/1/2009"],
"ActiveListVolume": [135650975,155736691,144529581,135650975,155736691,144529581,
135650975,155736691,144529581,135650975,155736691,144529581],
"NewListVolume": [135650975,155736691,144529581,135650975,155736691,144529581,
135650975,155736691,144529581,135650975,155736691,144529581],
"PendedListVolume": [135650975,155736691,144529581,135650975,155736691,144529581,
135650975,155736691,144529581,135650975,155736691,144529581],
"SoldListVolume": [135650975,155736691,144529581,135650975,155736691,144529581,
135650975,155736691,144529581,135650975,155736691,144529581],
"SoldSaleVolume": [135650975,155736691,144529581,135650975,155736691,144529581,
135650975,155736691,144529581,135650975,155736691,144529581]
}