curl --request POST \
--url https://data.apartmentiq.io/apartmentiq/api/v1/explore_markets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"account_id": 9919347,
"filters": {
"geo_boundary_id": [
"94121",
"94012"
],
"geo_type": "MSA"
},
"property_filters": {
"year_built_gte": 2015,
"total_units_gte": 200
},
"sort_by": "population_total",
"sort_order": "desc",
"limit": 50
}
'{
"data": [
{
"id": "94012",
"type": "compare_market",
"attributes": {
"id": 94012,
"name": "Los Angeles-Long Beach-Anaheim, CA Metro Area",
"short_name": "Los Angeles-Long Beach-Anaheim, CA Metro Area",
"description": "Los Angeles-Long Beach-Anaheim, CA",
"geo_type": "MSA",
"geo_states": [
"CA"
],
"place_type": "<string>",
"centroid": [
34.1087033,
-118.1827533
],
"property_count_total": 392,
"rent_avg_t30": 3261.04,
"rent_0_bed_avg_t30": 2514.37,
"rent_1_bed_avg_t30": 2937.87,
"rent_2_bed_avg_t30": 3891.46,
"rent_3_bed_avg_t30": 5318.09,
"ner_avg_t30": 3038.13,
"ner_0_bed_avg_t30": 2330.1,
"ner_1_bed_avg_t30": 2738.23,
"ner_2_bed_avg_t30": 3623.31,
"ner_3_bed_avg_t30": 4891.74,
"rent_psf_avg_t30": 3.85,
"rent_0_bed_psf_avg_t30": 4.48,
"rent_1_bed_psf_avg_t30": 3.95,
"rent_2_bed_psf_avg_t30": 3.51,
"rent_3_bed_psf_avg_t30": 3.54,
"ner_psf_avg_t30": 3.59,
"ner_0_bed_psf_avg_t30": 4.14,
"ner_1_bed_psf_avg_t30": 3.68,
"ner_2_bed_psf_avg_t30": 3.28,
"ner_3_bed_psf_avg_t30": 3.26,
"ner_psf_p88_t30": 4.31,
"ner_psf_p68_t30": 3.76,
"ner_psf_p18_t30": 3.02,
"rent_growth_rate_yoy_avg": -0.0073,
"ner_growth_rate_yoy_avg": -0.0101,
"forecasted_rent_growth_rate_yoy": 0.0257,
"rent_growth_rate_yoy_by_quarter_avg": -0.0064,
"ner_growth_rate_yoy_by_quarter_avg": -0.0061,
"rent_growth_rate_t90_avg": -0.0185,
"ner_growth_rate_t90_avg": -0.0277,
"concession_value_avg_t30": 4175.48,
"concession_percent_avg_t30": 0.1036,
"exposure_percent_avg_t30": 0.0749,
"leased_percent_avg_t30": 0.9325,
"advertised_occupancy_percent_avg_t30": 0.9274,
"days_on_market_avg_t30": 50.64,
"total_unit_count": 142374,
"existing_unit_count_total": 125696,
"new_supply_unit_count_total": 16678,
"under_construction_unit_count_total": 7308,
"planned_unit_count_total": 2403,
"delivered_unit_count_total_mtd": 0,
"delivered_unit_count_total_t365": 8777,
"available_unit_count_new_to_market_total_mtd": 3066,
"leased_unit_count_total_mtd": 2707,
"available_unit_count_total_t30": 14176,
"leased_unit_count_total_t30": 3308,
"absorption_rate_avg_t30": 123,
"unit_sq_ft_avg": 879,
"amenity_count_p50": 30,
"year_built_p50": 2021,
"year_renovated_p50": 2020,
"building_square_feet_avg": 123,
"rentable_building_area_sq_ft_avg": 333893,
"rentable_building_area_sq_ft_per_floor_avg": 55864,
"land_area_sq_ft_avg": 213385,
"land_area_acres_avg": 4.9,
"units_per_acre_avg": 157.78,
"units_per_building_avg": 291.74,
"units_per_floor_avg": 66.5,
"number_of_stories_avg": 8.71,
"building_count_avg": 1.77,
"walk_score_avg": 74,
"transit_score_avg": 61,
"bike_score_avg": 64,
"population_growth_last_5_years_total": -0.0353,
"population_growth_last_5_years_20_29": -0.1159,
"population_growth_last_5_years_30_39": -0.0074,
"population_growth_last_5_years_40_54": -0.0319,
"population_growth_last_5_years_55_up": 0.039,
"population_total": 12866598,
"population_20_29": 1741263,
"population_30_39": 1950682,
"population_40_54": 2553323,
"population_55_up": 3689869,
"median_income": 94295,
"median_income_growth_yoy": -0.0125,
"employed_labor_force_percent": 0.9392,
"employed_labor_force_growth_rate_yoy": 0.006,
"sold_property_count_total_t365": 12,
"sold_unit_count_total_t365": 4101,
"sold_unit_count_avg_t365": 341,
"sale_price_avg_t365": 135230561.33,
"sale_price_total_t365": 1622766736,
"sale_price_avg_t365_per_unit": 396925.04,
"sale_cap_rate_avg_t365": 0.0476,
"sale_price_per_unit_growth_yoy": -0.0141,
"cap_rate_avg": 123,
"asset_value_total": 45284183238,
"asset_value_per_unit_avg": 123
}
}
]
}Retrieve aggregated market-level metrics for geographic areas such as MSAs and Submarkets. This endpoint returns comprehensive market data including rent averages, occupancy rates, inventory counts, population demographics, and sales transaction data. Use market-level filters to narrow results by geography or performance metrics, and property-level filters to control which properties contribute to the aggregations.
curl --request POST \
--url https://data.apartmentiq.io/apartmentiq/api/v1/explore_markets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"account_id": 9919347,
"filters": {
"geo_boundary_id": [
"94121",
"94012"
],
"geo_type": "MSA"
},
"property_filters": {
"year_built_gte": 2015,
"total_units_gte": 200
},
"sort_by": "population_total",
"sort_order": "desc",
"limit": 50
}
'{
"data": [
{
"id": "94012",
"type": "compare_market",
"attributes": {
"id": 94012,
"name": "Los Angeles-Long Beach-Anaheim, CA Metro Area",
"short_name": "Los Angeles-Long Beach-Anaheim, CA Metro Area",
"description": "Los Angeles-Long Beach-Anaheim, CA",
"geo_type": "MSA",
"geo_states": [
"CA"
],
"place_type": "<string>",
"centroid": [
34.1087033,
-118.1827533
],
"property_count_total": 392,
"rent_avg_t30": 3261.04,
"rent_0_bed_avg_t30": 2514.37,
"rent_1_bed_avg_t30": 2937.87,
"rent_2_bed_avg_t30": 3891.46,
"rent_3_bed_avg_t30": 5318.09,
"ner_avg_t30": 3038.13,
"ner_0_bed_avg_t30": 2330.1,
"ner_1_bed_avg_t30": 2738.23,
"ner_2_bed_avg_t30": 3623.31,
"ner_3_bed_avg_t30": 4891.74,
"rent_psf_avg_t30": 3.85,
"rent_0_bed_psf_avg_t30": 4.48,
"rent_1_bed_psf_avg_t30": 3.95,
"rent_2_bed_psf_avg_t30": 3.51,
"rent_3_bed_psf_avg_t30": 3.54,
"ner_psf_avg_t30": 3.59,
"ner_0_bed_psf_avg_t30": 4.14,
"ner_1_bed_psf_avg_t30": 3.68,
"ner_2_bed_psf_avg_t30": 3.28,
"ner_3_bed_psf_avg_t30": 3.26,
"ner_psf_p88_t30": 4.31,
"ner_psf_p68_t30": 3.76,
"ner_psf_p18_t30": 3.02,
"rent_growth_rate_yoy_avg": -0.0073,
"ner_growth_rate_yoy_avg": -0.0101,
"forecasted_rent_growth_rate_yoy": 0.0257,
"rent_growth_rate_yoy_by_quarter_avg": -0.0064,
"ner_growth_rate_yoy_by_quarter_avg": -0.0061,
"rent_growth_rate_t90_avg": -0.0185,
"ner_growth_rate_t90_avg": -0.0277,
"concession_value_avg_t30": 4175.48,
"concession_percent_avg_t30": 0.1036,
"exposure_percent_avg_t30": 0.0749,
"leased_percent_avg_t30": 0.9325,
"advertised_occupancy_percent_avg_t30": 0.9274,
"days_on_market_avg_t30": 50.64,
"total_unit_count": 142374,
"existing_unit_count_total": 125696,
"new_supply_unit_count_total": 16678,
"under_construction_unit_count_total": 7308,
"planned_unit_count_total": 2403,
"delivered_unit_count_total_mtd": 0,
"delivered_unit_count_total_t365": 8777,
"available_unit_count_new_to_market_total_mtd": 3066,
"leased_unit_count_total_mtd": 2707,
"available_unit_count_total_t30": 14176,
"leased_unit_count_total_t30": 3308,
"absorption_rate_avg_t30": 123,
"unit_sq_ft_avg": 879,
"amenity_count_p50": 30,
"year_built_p50": 2021,
"year_renovated_p50": 2020,
"building_square_feet_avg": 123,
"rentable_building_area_sq_ft_avg": 333893,
"rentable_building_area_sq_ft_per_floor_avg": 55864,
"land_area_sq_ft_avg": 213385,
"land_area_acres_avg": 4.9,
"units_per_acre_avg": 157.78,
"units_per_building_avg": 291.74,
"units_per_floor_avg": 66.5,
"number_of_stories_avg": 8.71,
"building_count_avg": 1.77,
"walk_score_avg": 74,
"transit_score_avg": 61,
"bike_score_avg": 64,
"population_growth_last_5_years_total": -0.0353,
"population_growth_last_5_years_20_29": -0.1159,
"population_growth_last_5_years_30_39": -0.0074,
"population_growth_last_5_years_40_54": -0.0319,
"population_growth_last_5_years_55_up": 0.039,
"population_total": 12866598,
"population_20_29": 1741263,
"population_30_39": 1950682,
"population_40_54": 2553323,
"population_55_up": 3689869,
"median_income": 94295,
"median_income_growth_yoy": -0.0125,
"employed_labor_force_percent": 0.9392,
"employed_labor_force_growth_rate_yoy": 0.006,
"sold_property_count_total_t365": 12,
"sold_unit_count_total_t365": 4101,
"sold_unit_count_avg_t365": 341,
"sale_price_avg_t365": 135230561.33,
"sale_price_total_t365": 1622766736,
"sale_price_avg_t365_per_unit": 396925.04,
"sale_cap_rate_avg_t365": 0.0476,
"sale_price_per_unit_growth_yoy": -0.0141,
"cap_rate_avg": 123,
"asset_value_total": 45284183238,
"asset_value_per_unit_avg": 123
}
}
]
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
The ID of the account you're requesting data for.
9919347
Market-level filters to narrow results by geography or market performance metrics.
Show child attributes
Array of geo boundary IDs to retrieve market data for. Find these IDs using the Search Geo Boundaries endpoint.
["94121", "94012"]Filter results by geo boundary type. Use in combination with geo_states to retrieve all markets of a given type.
MSA, BespokeSubmarket "MSA"
Filter by US state(s). Use two-letter state abbreviations.
["CA", "NY"]Minimum 30-day average rent.
2000
Maximum 30-day average rent.
5000
Minimum 30-day average net effective rent.
1800
Maximum 30-day average net effective rent.
4500
Minimum year-over-year rent growth rate (decimal, e.g., 0.05 for 5%).
-0.05
Maximum year-over-year rent growth rate (decimal, e.g., 0.10 for 10%).
0.1
Minimum total population in the market.
1000000
Maximum total population in the market.
20000000
Minimum number of properties in the market.
100
Maximum number of properties in the market.
1000
Minimum 30-day average advertised occupancy percentage (decimal, e.g., 0.90 for 90%).
0.85
Maximum 30-day average advertised occupancy percentage (decimal, e.g., 0.99 for 99%).
0.99
Filters applied to properties before aggregating market metrics. Only properties matching these filters will contribute to the market-level calculations.
Show child attributes
Minimum year the property was built.
2015
Maximum year the property was built.
2024
Minimum total number of units in the property.
200
Maximum total number of units in the property.
1000
Only include data collected on or after this date. ISO 8601 format.
"2025-11-01T00:00:00.000Z"
Only include data collected on or before this date. ISO 8601 format.
"2025-11-25T00:00:00.000Z"
Minimum number of stories/floors in the property buildings.
3
Maximum number of stories/floors in the property buildings.
50
Filter by property classification grade.
A, B, C ["A", "B"]Filter by property type/category.
conventional, income_restricted, section8, senior_living, student_housing, build_to_rent ["conventional"]Filter by current construction state/status.
existing, new_supply ["existing"]Field to sort results by. Can be any numeric response attribute.
"population_total"
Sort direction.
asc, desc "desc"
Maximum number of markets to return.
1 <= x <= 10050
Successfully retrieved market data. Returns markets in JSON:API format with comprehensive market-level metrics.
Array of market data in JSON:API format.
Show child attributes
The geo boundary ID as a string
"94012"
Resource type, always 'compare_market'
compare_market "compare_market"
Market attributes including geographic info, performance metrics, inventory, demographics, and sales data
Show child attributes
Unique geo boundary identifier
94012
Full name of the market
"Los Angeles-Long Beach-Anaheim, CA Metro Area"
Shortened name of the market
"Los Angeles-Long Beach-Anaheim, CA Metro Area"
Description of the market geography
"Los Angeles-Long Beach-Anaheim, CA"
Type of geographic boundary
MSA, BespokeSubmarket "MSA"
US states that the market spans
["CA"]Type of place (if applicable)
Geographic center of the market as [latitude, longitude]
[34.1087033, -118.1827533]Total number of properties in the market matching filters
392
Average asking rent across all unit types (last 30 days)
3261.04
Average asking rent for studio units (last 30 days)
2514.37
Average asking rent for 1-bedroom units (last 30 days)
2937.87
Average asking rent for 2-bedroom units (last 30 days)
3891.46
Average asking rent for 3-bedroom units (last 30 days)
5318.09
Average net effective rent across all unit types (last 30 days)
3038.13
Average net effective rent for studio units (last 30 days)
2330.1
Average net effective rent for 1-bedroom units (last 30 days)
2738.23
Average net effective rent for 2-bedroom units (last 30 days)
3623.31
Average net effective rent for 3-bedroom units (last 30 days)
4891.74
Average asking rent per square foot across all unit types (last 30 days)
3.85
Average asking rent per square foot for studio units (last 30 days)
4.48
Average asking rent per square foot for 1-bedroom units (last 30 days)
3.95
Average asking rent per square foot for 2-bedroom units (last 30 days)
3.51
Average asking rent per square foot for 3-bedroom units (last 30 days)
3.54
Average net effective rent per square foot across all unit types (last 30 days)
3.59
Average net effective rent per square foot for studio units (last 30 days)
4.14
Average net effective rent per square foot for 1-bedroom units (last 30 days)
3.68
Average net effective rent per square foot for 2-bedroom units (last 30 days)
3.28
Average net effective rent per square foot for 3-bedroom units (last 30 days)
3.26
88th percentile net effective rent per square foot (last 30 days)
4.31
68th percentile net effective rent per square foot (last 30 days)
3.76
18th percentile net effective rent per square foot (last 30 days)
3.02
Average year-over-year rent growth rate (decimal)
-0.0073
Average year-over-year net effective rent growth rate (decimal)
-0.0101
Forecasted year-over-year rent growth rate (decimal)
0.0257
Average year-over-year rent growth rate by quarter (decimal)
-0.0064
Average year-over-year net effective rent growth rate by quarter (decimal)
-0.0061
Average rent growth rate over the last 90 days (decimal)
-0.0185
Average net effective rent growth rate over the last 90 days (decimal)
-0.0277
Average concession value in dollars (last 30 days)
4175.48
Average concession as percentage of rent (last 30 days, decimal)
0.1036
Average exposure percentage - units available for lease (last 30 days, decimal)
0.0749
Average percentage of units leased (last 30 days, decimal)
0.9325
Average advertised occupancy percentage (last 30 days, decimal)
0.9274
Average days on market (last 30 days)
50.64
Total number of units across all properties in the market
142374
Total units in existing (non-new supply) properties
125696
Total units in new supply properties
16678
Total units currently under construction
7308
Total units in planned developments
2403
Units delivered month-to-date
0
Units delivered in the last 365 days
8777
New-to-market available units month-to-date
3066
Units leased month-to-date
2707
Total available units (last 30 days)
14176
Total units leased (last 30 days)
3308
Average absorption rate (last 30 days)
Average unit square footage
879
Median amenity count across properties
30
Median year built across properties
2021
Median year renovated across properties
2020
Average building square footage
Average rentable building area in square feet
333893
Average rentable area per floor in square feet
55864
Average land area in square feet
213385
Average land area in acres
4.9
Average units per acre
157.78
Average units per building
291.74
Average units per floor
66.5
Average number of stories
8.71
Average number of buildings per property
1.77
Average Walk Score across properties
74
Average Transit Score across properties
61
Average Bike Score across properties
64
Total population growth rate over the last 5 years (decimal)
-0.0353
Population growth rate for ages 20-29 over the last 5 years (decimal)
-0.1159
Population growth rate for ages 30-39 over the last 5 years (decimal)
-0.0074
Population growth rate for ages 40-54 over the last 5 years (decimal)
-0.0319
Population growth rate for ages 55+ over the last 5 years (decimal)
0.039
Total population in the market
12866598
Population aged 20-29
1741263
Population aged 30-39
1950682
Population aged 40-54
2553323
Population aged 55 and older
3689869
Median household income in dollars
94295
Year-over-year median income growth rate (decimal)
-0.0125
Percentage of labor force that is employed (decimal)
0.9392
Year-over-year employment growth rate (decimal)
0.006
Number of properties sold in the last 365 days
12
Total units in properties sold in the last 365 days
4101
Average units per property sold in the last 365 days
341
Average sale price in the last 365 days
135230561.33
Total sales volume in the last 365 days
1622766736
Average sale price per unit in the last 365 days
396925.04
Average cap rate for sales in the last 365 days (decimal)
0.0476
Year-over-year sale price per unit growth rate (decimal)
-0.0141
Average cap rate
Total estimated asset value in the market
45284183238
Average asset value per unit