What is the source and vintage?

The Census Bureau's American Community Survey 5-year estimates for 2019 to 2023, the latest 5-year release, which is the standard for small-area statistics.

Which geographies are covered?

70,312 in total: the nation, 52 states including DC and Puerto Rico, 3,222 counties, 939 metro areas, 32,324 cities and towns, and 33,774 ZIP code tabulation areas.

What metrics does a profile include?

32 headline figures: population and age structure, median household and per-capita income, poverty, unemployment and labour-force participation, education attainment, households and broadband, housing units, homeownership, median home value and rent, and commute.

Are ZIP codes exactly the postal ZIPs?

Nearly. The Census publishes ZIP code tabulation areas, which approximate USPS ZIP codes. A few postal ZIPs with no residents have no profile.

How often is it updated?

Annually, when the Census Bureau publishes the next 5-year vintage each December.

DataMAINTAINED1 token / call

Demographics API

32 Census ACS metrics for every US ZIP, county, metro, city and state: income, age, education, housing

Rich US demographics for every place your users ask about, from the Census Bureau's American Community Survey 5-year estimates (2019-2023, the latest vintage): 70,312 geographies — every ZIP code (33,774 ZCTAs), county, metro area, city and town (32,324 places), state and the nation — each with 32 headline metrics. Population and age structure, median household and per-capita income, poverty, unemployment and labor-force participation, education attainment, households and broadband, housing units, homeownership, median home value, rent and year built, foreign-born share, Hispanic origin and race. Ask ZIP 90210 and get $190,382 median income against $2,000,000+ home values; profile Los Angeles County or the New York metro in one call; rank states by income (DC, Maryland, Massachusetts lead) or find the priciest ZIP codes in any state. Name search resolves places the way people type them ("Austin" finds Austin city, Texas, 967,862 people). Clean conventions throughout: rates as percentages, 2023 dollars, suppressed cells as null, top-coded medians clamped and documented. Built for real estate, marketing and site selection, insurance, lending, and any product that personalizes by location. Public-domain source data, self-hosted — no third-party calls at request time.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

Start free — 500 tokens / mo →See all plans

No credit card requiredAccess to 125+ APIsCancel anytime

response.json

{
  "ok": true,
  "geography": {
    "geo_id": "860Z200US90210",
    "level": "zip",
    "name": "ZIP 90210",
    "state": null,
    "code": "90210"
  },
  "population": 19652,
  "age": {
    "median_age": 51.2,
    "under_18_pct": 18,
    "over_65_pct": 28.3,
    "male_pct": 51.1,
    "female_pct": 48.9
  },
  "income": {
    "median_household_income": 190382,
    "per_capita_income": 144533,
    "poverty_rate": 8.4
  },
  "employment": {
    "unemployment_rate": 4.2,
    "labor_force_participation": 54.2
  },
  "education": {
    "hs_or_higher_pct": 96.8,
    "bachelors_or_higher_pct": 68.4
  },
  "households": {
    "households": 8025,
    "avg_household_size": 2.45,
    "broadband_pct": 94.9
  },
  "housing": {
    "housing_units": 9714,
    "occupied_units": 8025,
    "vacant_units": 1689,
    "owner_occupied_pct": 71.6,
    "median_home_value": 2000000,
    "median_gross_rent": 3045,
    "median_year_built": 1967
  },
  "origin": {
    "foreign_born_pct": 35.7,
    "hispanic_pct": 5.8
  },
  "race": {
    "white_pct": 82.3,
    "black_pct": 2,
    "native_american_pct": 0.2,
    "asian_pct": 6.6,
    "pacific_islander_pct": 0,
    "other_race_pct": 1.3,
    "two_or_more_races_pct": 7.5
  }
}

Production Ready: Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration: Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs: Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Demographics API

Enrich a customer or lead record with the median income, population and housing profile of its ZIP code.
Rank counties or metros by income, poverty, broadband or homeownership to target a campaign or a store rollout.
Show neighbourhood statistics on real-estate listings, relocation guides or school pages.
Compare a place against its state and the nation on one card with the search and rankings endpoints.

Demographics API endpoints

Every endpoint with its parameters and a real example response.

OpenAPI definition Postman workspace

GETCounty Demographics
GETData Sources
GETGet By GEO ID
GETNational Demographics
GETRankings
GETSearch Geographies
GETState Demographics
GETZIP Demographics

GETCounty Demographics

https://api-demographics.dataandapis.com/v1/demographics/county/{fips}

Path parameters

Parameter	Example
fips	06037	Required

Example request

curl "https://api-demographics.dataandapis.com/v1/demographics/county/06037" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "geography": {
    "geo_id": "0500000US06037",
    "level": "county",
    "name": "Los Angeles County, California",
    "state": "CA",
    "code": "06037"
  },
  "population": 9848406,
  "age": {
    "median_age": 37.9,
    "under_18_pct": 20.9,
    "over_65_pct": 14.7,
    "male_pct": 49.5,
    "female_pct": 50.5
  },
  "income": {
    "median_household_income": 87760,
    "per_capita_income": 44319,
    "poverty_rate": 13.6
  },
  "employment": {
    "unemployment_rate": 7,
    "labor_force_participation": 64.8
  },
  "education": {
    "hs_or_higher_pct": 80.7,
…

Show full response

{
  "ok": true,
  "geography": {
    "geo_id": "0500000US06037",
    "level": "county",
    "name": "Los Angeles County, California",
    "state": "CA",
    "code": "06037"
  },
  "population": 9848406,
  "age": {
    "median_age": 37.9,
    "under_18_pct": 20.9,
    "over_65_pct": 14.7,
    "male_pct": 49.5,
    "female_pct": 50.5
  },
  "income": {
    "median_household_income": 87760,
    "per_capita_income": 44319,
    "poverty_rate": 13.6
  },
  "employment": {
    "unemployment_rate": 7,
    "labor_force_participation": 64.8
  },
  "education": {
    "hs_or_higher_pct": 80.7,
    "bachelors_or_higher_pct": 35.5
  },
  "households": {
    "households": 3390254,
    "avg_household_size": 2.85,
    "broadband_pct": 91.7
  },
  "housing": {
    "housing_units": 3624084,
    "occupied_units": 3390254,
    "vacant_units": 233830,
    "owner_occupied_pct": 46.1,
    "median_home_value": 783300,
    "median_gross_rent": 1893,
    "median_year_built": 1965
  },
  "origin": {
    "foreign_born_pct": 33.4,
    "hispanic_pct": 48.3
  },
  "race": {
    "white_pct": 35.4,
    "black_pct": 7.8,
    "native_american_pct": 1.3,
    "asian_pct": 15,
    "pacific_islander_pct": 0.2,
    "other_race_pct": 23.6,
    "two_or_more_races_pct": 16.7
  }
}

GETData Sources

https://api-demographics.dataandapis.com/v1/sources

This endpoint takes no parameters.

Example request

curl "https://api-demographics.dataandapis.com/v1/sources" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "vintage": "ACS 5-year estimates, 2019-2023",
  "count": 1,
  "sources": [
    {
      "slug": "acs5",
      "name": "American Community Survey 5-Year Estimates 2019-2023",
      "publisher": "US Census Bureau",
      "licence": "US Government work - public domain",
      "source_url": "https://www.census.gov/programs-surveys/acs",
      "file_url": "https://www2.census.gov/programs-surveys/acs/summary_file/2023/table-based-SF/data/5YRData/",
      "cadence": "annual (December release)",
      "record_count": 70312,
      "retrieved_at": "2026-09-05"
    }
  ]
}

GETGet By GEO ID

https://api-demographics.dataandapis.com/v1/demographics/{geo_id}

Path parameters

Parameter	Example
geo_id	310M700US35620	Required

Example request

curl "https://api-demographics.dataandapis.com/v1/demographics/310M700US35620" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "geography": {
    "geo_id": "310M700US35620",
    "level": "metro",
    "name": "New York-Newark-Jersey City, NY-NJ Metro Area",
    "state": null,
    "code": "35620"
  },
  "population": 19756722,
  "age": {
    "median_age": 39.4,
    "under_18_pct": 21.3,
    "over_65_pct": 16.6,
    "male_pct": 48.7,
    "female_pct": 51.3
  },
  "income": {
    "median_household_income": 97334,
    "per_capita_income": 54510,
    "poverty_rate": 12.4
  },
  "employment": {
    "unemployment_rate": 6.5,
    "labor_force_participation": 65
  },
  "education": {
    "hs_or_higher_pct": 87.6,
…

Show full response

{
  "ok": true,
  "geography": {
    "geo_id": "310M700US35620",
    "level": "metro",
    "name": "New York-Newark-Jersey City, NY-NJ Metro Area",
    "state": null,
    "code": "35620"
  },
  "population": 19756722,
  "age": {
    "median_age": 39.4,
    "under_18_pct": 21.3,
    "over_65_pct": 16.6,
    "male_pct": 48.7,
    "female_pct": 51.3
  },
  "income": {
    "median_household_income": 97334,
    "per_capita_income": 54510,
    "poverty_rate": 12.4
  },
  "employment": {
    "unemployment_rate": 6.5,
    "labor_force_participation": 65
  },
  "education": {
    "hs_or_higher_pct": 87.6,
    "bachelors_or_higher_pct": 43.5
  },
  "households": {
    "households": 7362500,
    "avg_household_size": 2.63,
    "broadband_pct": 90.8
  },
  "housing": {
    "housing_units": 7991914,
    "occupied_units": 7362500,
    "vacant_units": 629414,
    "owner_occupied_pct": 51.5,
    "median_home_value": 587400,
    "median_gross_rent": 1780,
    "median_year_built": 1959
  },
  "origin": {
    "foreign_born_pct": 29.8,
    "hispanic_pct": 25.4
  },
  "race": {
    "white_pct": 48.4,
    "black_pct": 16.3,
    "native_american_pct": 0.5,
    "asian_pct": 11.8,
    "pacific_islander_pct": 0,
    "other_race_pct": 12.3,
    "two_or_more_races_pct": 10.6
  }
}

GETNational Demographics

https://api-demographics.dataandapis.com/v1/demographics/us

This endpoint takes no parameters.

Example request

curl "https://api-demographics.dataandapis.com/v1/demographics/us" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "geography": {
    "geo_id": "0100000US",
    "level": "us",
    "name": "United States",
    "state": null,
    "code": "US"
  },
  "population": 332387540,
  "age": {
    "median_age": 38.7,
    "under_18_pct": 22.2,
    "over_65_pct": 16.8,
    "male_pct": 49.5,
    "female_pct": 50.5
  },
  "income": {
    "median_household_income": 78538,
    "per_capita_income": 43289,
    "poverty_rate": 12.4
  },
  "employment": {
    "unemployment_rate": 5.2,
    "labor_force_participation": 63.5
  },
  "education": {
    "hs_or_higher_pct": 89.4,
…

Show full response

{
  "ok": true,
  "geography": {
    "geo_id": "0100000US",
    "level": "us",
    "name": "United States",
    "state": null,
    "code": "US"
  },
  "population": 332387540,
  "age": {
    "median_age": 38.7,
    "under_18_pct": 22.2,
    "over_65_pct": 16.8,
    "male_pct": 49.5,
    "female_pct": 50.5
  },
  "income": {
    "median_household_income": 78538,
    "per_capita_income": 43289,
    "poverty_rate": 12.4
  },
  "employment": {
    "unemployment_rate": 5.2,
    "labor_force_participation": 63.5
  },
  "education": {
    "hs_or_higher_pct": 89.4,
    "bachelors_or_higher_pct": 35
  },
  "households": {
    "households": 127482865,
    "avg_household_size": 2.54,
    "broadband_pct": 89.7
  },
  "housing": {
    "housing_units": 142332876,
    "occupied_units": 127482865,
    "vacant_units": 14850011,
    "owner_occupied_pct": 65,
    "median_home_value": 303400,
    "median_gross_rent": 1348,
    "median_year_built": 1980
  },
  "origin": {
    "foreign_born_pct": 13.9,
    "hispanic_pct": 19
  },
  "race": {
    "white_pct": 63.4,
    "black_pct": 12.4,
    "native_american_pct": 0.9,
    "asian_pct": 5.8,
    "pacific_islander_pct": 0.2,
    "other_race_pct": 6.6,
    "two_or_more_races_pct": 10.7
  }
}

GETRankings

https://api-demographics.dataandapis.com/v1/rankings

Query parameters

Parameter	Example
level	county	Optional
limit	25	Optional
metric	median_household_income	Optional
min_population	10000	Optional
order	desc	Optional
page	1	Optional
state	TX	Optional

Example request

curl "https://api-demographics.dataandapis.com/v1/rankings?level=county&limit=25&metric=median_household_income&min_population=10000&order=desc&page=1&state=TX" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "metric": "median_household_income",
  "level": "county",
  "order": "desc",
  "page": 1,
  "limit": 25,
  "count": 5,
  "results": [
    {
      "geo_id": "0500000US48397",
      "name": "Rockwall County, Texas",
      "state": "TX",
      "code": "48397",
      "population": 116931,
      "value": 124917
    },
    {
      "geo_id": "0500000US48085",
      "name": "Collin County, Texas",
      "state": "TX",
      "code": "48085",
      "population": 1116601,
      "value": 117588
    },
    {
      "geo_id": "0500000US48157",
      "name": "Fort Bend County, Texas",
…

Show full response

{
  "ok": true,
  "metric": "median_household_income",
  "level": "county",
  "order": "desc",
  "page": 1,
  "limit": 25,
  "count": 5,
  "results": [
    {
      "geo_id": "0500000US48397",
      "name": "Rockwall County, Texas",
      "state": "TX",
      "code": "48397",
      "population": 116931,
      "value": 124917
    },
    {
      "geo_id": "0500000US48085",
      "name": "Collin County, Texas",
      "state": "TX",
      "code": "48085",
      "population": 1116601,
      "value": 117588
    },
    {
      "geo_id": "0500000US48157",
      "name": "Fort Bend County, Texas",
      "state": "TX",
      "code": "48157",
      "population": 859721,
      "value": 113409
    },
    {
      "geo_id": "0500000US48259",
      "name": "Kendall County, Texas",
      "state": "TX",
      "code": "48259",
      "population": 46971,
      "value": 110498
    },
    {
      "geo_id": "0500000US48491",
      "name": "Williamson County, Texas",
      "state": "TX",
      "code": "48491",
      "population": 643889,
      "value": 108309
    }
  ]
}

GETSearch Geographies

https://api-demographics.dataandapis.com/v1/search

Query parameters

Parameter	Example
level	place	Optional
limit	20	Optional
q	Austin	Required
state	TX	Optional

Example request

curl "https://api-demographics.dataandapis.com/v1/search?level=place&limit=20&q=Austin&state=TX" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "count": 1,
  "results": [
    {
      "geo_id": "1600000US4805000",
      "level": "place",
      "name": "Austin city, Texas",
      "state": "TX",
      "code": "4805000",
      "population": 967862
    }
  ]
}

GETState Demographics

https://api-demographics.dataandapis.com/v1/demographics/state/{code}

Path parameters

Parameter	Example
code	TX	Required

Example request

curl "https://api-demographics.dataandapis.com/v1/demographics/state/TX" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "geography": {
    "geo_id": "0400000US48",
    "level": "state",
    "name": "Texas",
    "state": "TX",
    "code": "TX"
  },
  "population": 29640343,
  "age": {
    "median_age": 35.5,
    "under_18_pct": 25.2,
    "over_65_pct": 13.2,
    "male_pct": 49.9,
    "female_pct": 50.1
  },
  "income": {
    "median_household_income": 76292,
    "per_capita_income": 39446,
    "poverty_rate": 13.8
  },
  "employment": {
    "unemployment_rate": 5.1,
    "labor_force_participation": 65.3
  },
  "education": {
    "hs_or_higher_pct": 85.7,
…

Show full response

{
  "ok": true,
  "geography": {
    "geo_id": "0400000US48",
    "level": "state",
    "name": "Texas",
    "state": "TX",
    "code": "TX"
  },
  "population": 29640343,
  "age": {
    "median_age": 35.5,
    "under_18_pct": 25.2,
    "over_65_pct": 13.2,
    "male_pct": 49.9,
    "female_pct": 50.1
  },
  "income": {
    "median_household_income": 76292,
    "per_capita_income": 39446,
    "poverty_rate": 13.8
  },
  "employment": {
    "unemployment_rate": 5.1,
    "labor_force_participation": 65.3
  },
  "education": {
    "hs_or_higher_pct": 85.7,
    "bachelors_or_higher_pct": 33.1
  },
  "households": {
    "households": 10747240,
    "avg_household_size": 2.7,
    "broadband_pct": 90
  },
  "housing": {
    "housing_units": 11890808,
    "occupied_units": 10747240,
    "vacant_units": 1143568,
    "owner_occupied_pct": 62.6,
    "median_home_value": 260400,
    "median_gross_rent": 1339,
    "median_year_built": 1990
  },
  "origin": {
    "foreign_born_pct": 17.2,
    "hispanic_pct": 39.5
  },
  "race": {
    "white_pct": 53.9,
    "black_pct": 12.2,
    "native_american_pct": 0.6,
    "asian_pct": 5.3,
    "pacific_islander_pct": 0.1,
    "other_race_pct": 8.6,
    "two_or_more_races_pct": 19.2
  }
}

GETZIP Demographics

https://api-demographics.dataandapis.com/v1/demographics/zip/{zip}

Path parameters

Parameter	Example
zip	90210	Required

Example request

curl "https://api-demographics.dataandapis.com/v1/demographics/zip/90210" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "geography": {
    "geo_id": "860Z200US90210",
    "level": "zip",
    "name": "ZIP 90210",
    "state": null,
    "code": "90210"
  },
  "population": 19652,
  "age": {
    "median_age": 51.2,
    "under_18_pct": 18,
    "over_65_pct": 28.3,
    "male_pct": 51.1,
    "female_pct": 48.9
  },
  "income": {
    "median_household_income": 190382,
    "per_capita_income": 144533,
    "poverty_rate": 8.4
  },
  "employment": {
    "unemployment_rate": 4.2,
    "labor_force_participation": 54.2
  },
  "education": {
    "hs_or_higher_pct": 96.8,
…

Show full response

{
  "ok": true,
  "geography": {
    "geo_id": "860Z200US90210",
    "level": "zip",
    "name": "ZIP 90210",
    "state": null,
    "code": "90210"
  },
  "population": 19652,
  "age": {
    "median_age": 51.2,
    "under_18_pct": 18,
    "over_65_pct": 28.3,
    "male_pct": 51.1,
    "female_pct": 48.9
  },
  "income": {
    "median_household_income": 190382,
    "per_capita_income": 144533,
    "poverty_rate": 8.4
  },
  "employment": {
    "unemployment_rate": 4.2,
    "labor_force_participation": 54.2
  },
  "education": {
    "hs_or_higher_pct": 96.8,
    "bachelors_or_higher_pct": 68.4
  },
  "households": {
    "households": 8025,
    "avg_household_size": 2.45,
    "broadband_pct": 94.9
  },
  "housing": {
    "housing_units": 9714,
    "occupied_units": 8025,
    "vacant_units": 1689,
    "owner_occupied_pct": 71.6,
    "median_home_value": 2000000,
    "median_gross_rent": 3045,
    "median_year_built": 1967
  },
  "origin": {
    "foreign_born_pct": 35.7,
    "hispanic_pct": 5.8
  },
  "race": {
    "white_pct": 82.3,
    "black_pct": 2,
    "native_american_pct": 0.2,
    "asian_pct": 6.6,
    "pacific_islander_pct": 0,
    "other_race_pct": 1.3,
    "two_or_more_races_pct": 7.5
  }
}

Where the data comes from

Source: US Census Bureau American Community Survey 5-year estimates, 2019 to 2023 (public domain).
Freshness: Annual reload with each ACS 5-year release.

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages

8endpoints

RESTarchitecture

1key for all APIs

Fully typed responses — auto-completion in your IDE
Tracks the API in lockstep — new endpoints land same day
One key works across 125+ APIs on the platform

import axios from 'axios';

const { data } = await axios.get(
  'https://api-demographics.dataandapis.com/v1/demographics/county/{fips}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Demographics API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key

Path Parameters

fips

Target:

Client:

import axios from 'axios';

const url = 'https://api-demographics.dataandapis.com/v1/demographics/county/{fips}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});