Population & Housing Forecast API

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

200

Successful response with forecast data.

application/json

400

Invalid request (missing required parameters).

application/json

401

Missing or invalid API key.

application/json

404

No matching records found in the database

application/json

get

HTTPcURLJavaScriptPython

GET /v1/population-housing-forecast HTTP/1.1
Host: api.aterio.io
x-api-key: text
Accept: */*

{
  "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
      }
    }
  ]
}

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