Population & Housing Forecast Data

get

Returns population and housing forecast data for a given ZIP code or city/state combination.

Query parameters

zip_codestringoptional

ZIP code to query forecast data.

Example: 90210

city_namestringoptional

City name to query forecast data (requires state_code).

state_codestringoptional

Two-letter state code (required if using city_name).

Header parameters

x-api-keystringrequired

API key to authenticate the request.

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.aterio.io/v1/population-housing-forecast' \
  --header 'x-api-key: text'

200

400

401

404

200

{
  "total_results": 1,
  "zip_codes": [
    {
      "location": {
        "zip_code": "36436",
        "county_name": "Clarke County",
        "county_fips_code": "01025",
        "city": "Dickinson, AL",
        "state_code": "AL",
        "latitude": 31.7061,
        "longitude": -87.9999
      },
      "population": [
        {
          "year": 2023,
          "tot_population": 783
        }
      ],
      "housing": {
        "tot_home_available_2020": 216,
        "tot_home_available_2021": 333,
        "tot_home_available_2022": 334,
        "tot_home_available_2023": 281,
        "est_total_home_demand_2030": 467
      }
    }
  ]
}

Successful response with forecast data.

EXAMPLES

Population & Housing Forecast for ZIP Code 10009 (located in New York County, NY)

https://api.aterio.io/v1/population-housing-forecast?zip_code=10009

Population & Housing Forecast for ZIP Codes in Los Angeles city in California

https://api.aterio.io/v1/population-housing-forecast?city_name=Los%20Angeles&state_code=CA