Census Bureau

Integrate Census Bureau with your AI workspace

The Census Bureau Data API provides developers with access to a wide range of statistical data collected by the U.S. Census Bureau, facilitating integration into applications and data visualizations.

Explore Triggers and Actions

Batch Geocode Addresses with Geographies

Batch geocode multiple addresses from a CSV file and return Census geography codes. Tool to geocode up to 10,000 addresses at once from a CSV file. Use when you need to convert addresses to geographic coordinates (latitude/longitude) and retrieve associated Census geography identifiers (state, county, tract, block FIPS codes). Input CSV format: Unique ID, Street address, City, State, ZIP Returns: Original data plus match status, coordinates, and geographic codes.

ActionTry it

Geocode Address

Tool to geocode a single address to get latitude/longitude coordinates. Use when you need to convert a street address into geographic coordinates.

ActionTry it

Geocode Address for Census Geographies

Geocode an address and return Census geography identifiers including state, county, tract, block group, and block FIPS codes. This tool converts a physical address into geographic coordinates and returns detailed Census geography information including FIPS codes for various geographic levels (state, county, census tract, block group, block) plus additional geographies like congressional districts, places, and statistical areas. Use this when you need to link an address to Census geographic identifiers for data analysis or geographic queries.

ActionTry it

Geocode Address Parts

Tool to geocode an address using separate components (street, city, state, ZIP) to get latitude/longitude coordinates. Use when you have address data in separate fields rather than a single line.

ActionTry it

Geocode Address with Geography

Tool to geocode an address and return both coordinates and Census geography information. Use when you need geographic coordinates plus Census geographic identifiers like state FIPS, county FIPS, census tract, and block codes.

ActionTry it

Geocode Coordinates

Reverse geocode latitude/longitude coordinates to Census geographic areas. Takes decimal degree coordinates and returns associated Census geographies including states, counties, tracts, blocks, congressional districts, and other Census-defined geographic boundaries. Use this tool to identify what Census geographic areas a specific location falls within. Note: This uses the Census Geocoding Services API, which has a different base URL than the standard Census data API (uses geocoding.geo.census.gov).

ActionTry it

Geocode Puerto Rico Address

Tool to geocode a Puerto Rico address with urbanization to latitude/longitude coordinates. Use when geocoding addresses in Puerto Rico that include urbanization or municipio components.

ActionTry it

Geocode Puerto Rico Address with Geography

Tool to geocode a Puerto Rico address and return coordinates plus Census geography data. Use for Puerto Rico addresses when you need geographic coordinates and Census identifiers like state, county, tract, and block codes. Supports urbanization names specific to Puerto Rico addressing.

ActionTry it

Get ACS 1-Year Estimates

Tool to retrieve 1-year American Community Survey (ACS) estimates for a specified geography. Use when you need the most recent annual ACS data for a given area.

ActionTry it

Get ACS 5-Year Estimates

Retrieve 5-year American Community Survey (ACS) estimates from the U.S. Census Bureau. The ACS 5-year estimates provide reliable data for all geographic areas by combining 5 years of survey data. Use this tool to get population demographics, income statistics, housing characteristics, and other socioeconomic data at various geographic levels (nation, state, county, tract, place, metro area, etc.). Returns data as a list of rows where the first row contains column headers (variable names and geography identifiers) and subsequent rows contain the data values.

ActionTry it

Get Community Resilience Estimates

Retrieve U.S. Census Bureau Community Resilience Estimates (CRE) data. The CRE measures social vulnerability to disasters by estimating the number of individuals with risk factors (e.g., income, disability, housing) that may limit their capacity to absorb, recover from, and respond to the impacts of disasters. Key variables: - PRED0_E: Estimated persons with 0 risk factors (most resilient) - PRED12_E: Estimated persons with 1-2 risk factors - PRED3_E: Estimated persons with 3+ risk factors (most vulnerable) - POPUNI: Total population universe - Variables ending in _M are margins of error for the corresponding estimates Available for years 2019, 2021, 2022, 2023 at state and county levels.

ActionTry it

Get County Business Patterns

Tool to retrieve County Business Patterns (CBP) data for a specified year. Use when you need county-level business establishment and employment statistics filtered by industry and geography.

ActionTry it

Get Dataset Examples (XML)

Tool to retrieve example queries for a Census Bureau dataset in XML format. Use when you need to understand how to query a specific dataset or see sample API calls.

ActionTry it

Get Dataset Examples HTML

Tool to retrieve example queries for a Census dataset in HTML format. Use when you need to see example API queries for different geographic levels and hierarchies within a specific dataset. The response contains an HTML table with example queries showing how to request data at various geographic levels (nation, state, county, tract, place, metropolitan areas, etc.). Each example includes the geography hierarchy, level, and a working example URL.

ActionTry it

Get Dataset Examples JSON

Tool to retrieve example API query patterns for a specific Census dataset and vintage. Use when you need to understand available geography levels, example variable names, and how to structure queries for a dataset.

ActionTry it

Get Dataset Geography HTML

Tool to retrieve available geographies for a Census dataset in HTML format. Use when you need to see which geographic levels (state, county, tract, etc.) and hierarchies are available for a specific Census dataset and year. The response is an HTML page containing a table with geography level codes, hierarchies, and reference dates.

ActionTry it

Get Dataset Geography JSON

Tool to get the list of supported geography levels for a specific Census dataset with their hierarchy and required predicates. Use when you need to discover which geographic areas are available for querying a dataset and what predicates are required.

ActionTry it

Get Dataset Geography XML

Tool to retrieve available geographies for a Census Bureau dataset in XML format. Use when you need to discover which geographic levels (state, county, tract, etc.) are supported for a specific dataset vintage.

ActionTry it

Get Dataset Groups

Tool to retrieve the list of table groups for a Census dataset and vintage. Use when you need to discover available data tables or before querying all variables in a table using group() syntax.

ActionTry it

Get Dataset Sorts

Tool to list available sort options for a specific Census dataset and vintage. Use when you need to determine which fields can be used to sort query results.

ActionTry it

Get Dataset Tags

Tool to list available tags/keywords for a specific Census dataset and vintage. Use when you need to discover topic categories, demographic dimensions, or searchable keywords available in a dataset.

ActionTry it

Get Dataset Variables JSON

Tool to retrieve the complete list of available variables for a specific Census dataset. Use when you need to discover what variables are available in a dataset, their names, labels, data types, and valid values.

ActionTry it

Get Decennial Census Data

Retrieve Decennial Census data (population, demographics, housing) from the U.S. Census Bureau API. Use this tool to get census statistics for states, counties, tracts, and other geographic units. The Decennial Census is conducted every 10 years (2020, 2010, 2000). Different datasets contain different variables - use 'dhc' for 2020 demographic data, 'sf1' for 2010/2000 summary data, 'pl' for redistricting data across all vintages.

ActionTry it

Get Planning Database Data

Get Planning Database (PDB) data containing Census tract and block group level data useful for planning. Use this tool to retrieve demographic and operational data from the Planning Database including population estimates, ACS statistics, and 2020 Census operational variables at tract, block group, or state-county levels.

ActionTry it

Get Population Estimates

Retrieves Population Estimates Program (PEP) data from the US Census Bureau API. Use this tool when you need: - Total population estimates for states, counties, or the nation - Components of population change (births, deaths, migration) - Population by demographic characteristics (age, sex, race, Hispanic origin) Response is a 2D array where index 0 is the header row (e.g., [['POP','NAME','state'],['39512223','California','06'],...]); always use row 0 as column keys when parsing. Important notes: - Available datasets and variables vary significantly by vintage year - For broadest compatibility, use vintage=2019 with dataset='population' - Variable names may include year suffixes in newer vintages (e.g., POP_2021 instead of POP) - Check Census API documentation for valid variable names per vintage/dataset

ActionTry it

Get TIGERweb ACS Generalized Boundaries

Tool to access generalized ACS (American Community Survey) boundary services from TIGERweb for specific survey years (2012-2024). Use when you need to retrieve geographic boundary information and metadata for various Census geographies like states, counties, tracts, places, or other administrative areas.

ActionTry it

Get TIGERweb Map Service Metadata

Tool to retrieve TIGERweb MapServer service metadata including available layers, capabilities, and spatial reference information. Use when you need to discover available geographic layers before querying specific data.

ActionTry it

Get Timeseries Examples HTML

Tool to retrieve HTML-formatted example queries for a Census Bureau timeseries dataset. Use when you need to discover valid API query patterns and parameters for a specific timeseries dataset.

ActionTry it

Get Timeseries Examples JSON

Tool to get example queries for a timeseries dataset in JSON format. Use when you need to discover example query patterns and available parameters for a specific Census Bureau timeseries dataset.

ActionTry it

Get Timeseries Examples XML

Tool to retrieve example queries for a Census Bureau timeseries dataset in XML format. Use when you need to understand available variables, predicates, and geography options for a specific timeseries dataset.

ActionTry it

Get Timeseries Geography HTML

Tool to retrieve available FIPS geographies for a timeseries dataset in HTML format. Use when you need to understand which geography levels, hierarchies, and FIPS codes are available for querying a specific timeseries dataset. Returns an HTML document with a table showing reference dates, geography levels, hierarchies, and record limits.

ActionTry it

Get Timeseries Geography JSON

Tool to get available geographies for a timeseries dataset in JSON format. Returns FIPS geography levels, display codes, and reference dates for the specified dataset. Use this when you need to determine which geography levels can be queried for a given timeseries dataset.

ActionTry it

Get Timeseries Geography XML

Tool to retrieve available geographies for a Census Bureau timeseries dataset in XML format. Use when you need to discover which geographic levels are supported for a specific timeseries dataset and understand the hierarchical dependencies between geography types.

ActionTry it

Get Timeseries Variables HTML

Tool to retrieve a list of available variables for a Census timeseries dataset in HTML format. Use when you need to discover what data fields are available for a specific timeseries dataset.

ActionTry it

Get Timeseries Variables JSON

Tool to get a list of variables available for a timeseries dataset in JSON format. Use when you need to discover which variables are available for querying in a specific Census Bureau timeseries dataset.

ActionTry it

Get Timeseries Variables XML

Tool to get a list of variables available for a timeseries dataset in XML format. Use when you need the variable definitions, data types, and valid values for a specific timeseries dataset.

ActionTry it

Get Variable Details

Tool to retrieve metadata for a specific variable in a Census dataset for a given year. Use when you need the label, concept, data type, attribute codes, and valid-value constraints.

ActionTry it

List Available Datasets

Lists all available Census Bureau datasets with their metadata, vintages, and API endpoints. Use this as the discovery tool to find available datasets before querying specific data.

ActionTry it

List Datasets HTML

Tool to retrieve a complete HTML listing of all available (non-timeseries) Census Bureau datasets. Use when you need to discover available datasets with links to their Geographies, Variables, Examples, and API base URLs.

ActionTry it

List Datasets XML

Tool to retrieve a list of all available Census Bureau datasets in XML format. Use when you need to discover available datasets, their paths, descriptions, and time periods. The XML contains comprehensive metadata about each dataset including identifiers, titles, and temporal coverage.

ActionTry it

List Geocoder Benchmarks

List all available benchmark versions for the Census Bureau geocoding service. Use this to discover valid benchmark options before geocoding addresses.

ActionTry it

List Geocoder Vintages

Tool to list available geography vintages for a given Census geocoder benchmark. Use when you need to see what geography versions are available for geocoding operations.

ActionTry it

List TIGERweb Services

Tool to discover all available TIGERweb map services for Census geographic boundaries. Use when you need to find which TIGERweb services are available (Current, ACS years, Census years) before accessing specific service metadata or querying geographic boundary data.

ActionTry it

List Timeseries Datasets (HTML)

Tool to retrieve a list of all available timeseries datasets from the US Census Bureau API in HTML format. Use when you need to discover available timeseries datasets and their endpoints.

ActionTry it

List Timeseries Datasets (JSON)

Tool to list all available timeseries datasets from the US Census Bureau API. Use when you need to discover what timeseries data is available. This endpoint returns a DCAT Catalog containing metadata for all timeseries datasets, including their titles, descriptions, available variables, geography links, and API endpoints. The response follows the Project Open Data v1.1 schema.

ActionTry it

List Timeseries Datasets (XML)

Tool to retrieve a list of all available Census Bureau timeseries datasets in XML format. Use when you need to discover available timeseries datasets, their endpoints, or metadata. This is a discovery endpoint that returns the complete catalog of timeseries datasets.

ActionTry it

Query ACS Comparison Profiles

Query ACS Comparison Profiles data by variables and geography. Use when you need to compare demographic, social, economic, or housing characteristics across different time periods within the same dataset. Available for both 1-year and 5-year ACS estimates.

ActionTry it

Query ACS Data Profile

Tool to query ACS Data Profiles by variables and geography. Use when you need demographic, social, economic, or housing profile data from the American Community Survey for specific geographic areas.

ActionTry it

Query ACS Migration Flows

Tool to query American Community Survey (ACS) Migration Flows data by variables and geography. Use when you need migration flow statistics between geographic areas (inbound/outbound migration patterns).

ActionTry it

Query ACS Selected Population Profiles

Tool to query ACS Selected Population Profiles (SPP) data by variables and geography for specific population groups. Use when you need demographic data filtered by race, ethnicity, ancestry, or other population subgroups.

ActionTry it

Query ACS Subject Tables

Tool to query ACS Subject Tables data by variables and geography. Use when you need subject table data (S-tables like S0101 for Age and Sex, S1701 for Poverty Status) from the American Community Survey. Available for both 1-year (acs1) and 5-year (acs5) estimates.

ActionTry it

Query ACS Supplemental Estimates

Query ACS Supplemental Estimates data by variables and geography. Use when you need supplemental ACS estimates for specific geographic areas and variables.

ActionTry it

Query Annual Business Survey

Tool to query Annual Business Survey Company Summary (abscs) data with demographic filters. Use when you need business ownership demographics, employment, payroll, or industry statistics filtered by sex, race, ethnicity, veteran status, or firm size for specific geographic areas.

ActionTry it

Query Business Dynamics Statistics

Query Business Dynamics Statistics (BDS) time series data from the Census Bureau. Use when you need data on business formation, job creation, establishment dynamics, and employment statistics by industry and geography over time.

ActionTry it

Query Commodity Flow Survey

Query Commodity Flow Survey data on freight shipments by origin, destination, mode, and commodity. Use when you need freight transportation statistics including shipment values, tonnage, and ton-miles for analyzing goods movement patterns in the United States.

ActionTry it

Query CPS Survey Data

Tool to query Current Population Survey (CPS) microdata including basic monthly employment data and supplemental surveys. Use when you need individual-level labor force, employment, earnings, or demographic data from the CPS.

ActionTry it

Query Decennial Census Demographic Profile

Tool to query Decennial Census Demographic Profile data by variables and geography. Use when you need comprehensive demographic and housing profile data from the 2020 Decennial Census for specific geographic areas.

ActionTry it

Query Decennial Census P.L. Redistricting Data

Tool to query Decennial Census P.L. 94-171 Redistricting Data. Use when you need official population counts used for congressional and state legislative redistricting for census years 2000, 2010, or 2020.

ActionTry it

Query Decennial DHC

Tool to query Decennial Census Demographic and Housing Characteristics (DHC) data by variables and geography. Use when you need detailed 2020 Census demographic and housing data for states, counties, or other geographic areas.

ActionTry it

Query Economic Census Data

Tool to query Economic Census data including establishments, employment, payroll, and receipts by geography and industry (NAICS). Use when you need comprehensive business statistics from the 5-year Economic Census surveys (2002, 2007, 2012, 2017, 2022).

ActionTry it

Query Economic Indicators Time Series

Tool to query Economic Indicators Time Series (EITS) data from the US Census Bureau. Use when you need retail sales, manufacturing, housing, trade, or other economic indicator time series data. The API returns tabular data with headers and rows matching your requested variables.

ActionTry it

Query Health Insurance Estimates

Query Small Area Health Insurance Estimates (SAHIE) from the Census Bureau timeseries API. Use this tool to retrieve annual health insurance coverage estimates for U.S. counties and states. SAHIE provides model-based estimates of health insurance coverage by age, sex, race/ethnicity, and income categories. Data is available for states and counties, with estimates going back to 2008. Returns data as a structured response with headers and rows, where the first element contains column names and subsequent elements contain the data values for each geography and time period.

ActionTry it

Query Household Pulse Survey Timeseries

Tool to query Household Pulse Survey (HPS) timeseries data measuring household experiences during the COVID-19 pandemic. Use when you need household-level statistics on topics like employment, housing, education, health, food security, and economic impacts.

ActionTry it

Query International Database

Query International Database (IDB) demographic data for 227 countries and areas worldwide. Use this tool to retrieve demographic indicators including population, fertility rates, mortality rates, life expectancy, and other demographic measures from the U.S. Census Bureau's International Database. The IDB provides historical data and projections for countries globally. Choose '1year' product for annual data with single-year age groups, or '5year' for quinquennial data with five-year age groups.

ActionTry it

Query International Trade Timeseries

Tool to query International Trade timeseries data from Census Bureau API. Provides monthly and annual import/export statistics by commodity, country, and port. Use when you need US trade statistics organized by various classification systems (end-use, Harmonized System, NAICS, state, or port).

ActionTry it

Query Nonemployer Statistics

Tool to query Nonemployer Statistics data covering businesses with no paid employees. Use when you need statistics on self-employed individuals, sole proprietorships, and businesses without payroll filtered by industry and geography.

ActionTry it

Query PEP CharAgeGroups

Query population estimates by age groups, sex, race, and Hispanic origin from the Census Bureau PEP CharAgeGroups dataset. Use this tool when you need population estimates broken down by demographic characteristics such as age groups, sex, race, and Hispanic origin for states, counties, or other geographic areas. Available for vintages 2015-2019.

ActionTry it

Query PEP Components

Query components of population change from the Census Bureau Population Estimates Program (PEP). This tool retrieves data on births, deaths, natural increase, and migration components (domestic, international, and net migration) for states, counties, or other geographic areas. Data is available for vintages 2015-2019. Use this tool when you need to analyze: - Birth and death statistics by geographic area - Natural population increase (births minus deaths) - Migration patterns (domestic, international, or net migration) - Population change components over specific time periods

ActionTry it

Query PEP Housing Estimates

Query housing unit estimates from the US Census Bureau Population Estimates Program (PEP). Use this tool to retrieve housing unit estimates for different geographic levels (national, state, county) for years 2013-2019. Returns data including housing unit counts, date descriptions, and geographic identifiers. Available vintages: 2013-2019

ActionTry it

Query Population Projections

Query population projections from the Census Bureau API. Use this tool to retrieve projected population data for specific years (vintages 2012-2017) at various demographic breakdowns including age, sex, race, and Hispanic origin. The projections provide future population estimates based on different scenarios.

ActionTry it

Query QWI Timeseries Data

Query Quarterly Workforce Indicators (QWI) timeseries data on employment, earnings, and job flows. Use when you need detailed labor market statistics segmented by worker demographics (age, sex, education, race/ethnicity) and firm characteristics (age, size, industry) for specific geographic areas and time periods.

ActionTry it

Query Residential Construction Stats

Tool to query Residential Construction statistics from Census Bureau Economic Indicators Time Series (EITS). Use when you need housing starts, permits, completions, or under-construction data. Returns time series data including housing units (single-family, multi-family, total), construction categories (permits, starts, completions, under construction), and seasonally adjusted/non-adjusted values. Data is provided in a structured format with headers and rows, where each row contains metrics for a specific time period.

ActionTry it

Query Residential Sales Data

Query Residential Sales statistics from Census Bureau's Economic Indicator Time Series (EITS). Use this tool to retrieve residential real estate sales data including prices, volumes, and inventory metrics over time. The API provides time-series data with seasonal adjustment options and supports filtering by time periods and geography.

ActionTry it

Query Surname Data

Query surname frequency data from the U.S. Census Bureau Decennial Census (2000 or 2010). Use this tool to retrieve surname statistics including frequency counts, national rankings, and race/ethnicity distributions. Data is aggregated at the national level and includes surnames reported 100 or more times in the decennial census.

ActionTry it

Query TIGERweb Layer

Tool to query TIGERweb GeoServices for Census geographic boundaries and features. Use when you need to retrieve geographic shapes, FIPS codes, or spatial data for states, counties, tracts, blocks, or other Census geographies.

ActionTry it

Query Timeseries Data

Query Census timeseries datasets containing longitudinal data for multiple time periods. Use this tool to retrieve economic indicators (EITS), international trade data, Quarterly Workforce Indicators (QWI), poverty statistics (SAIPE), and other time-varying datasets from the U.S. Census Bureau. Timeseries datasets store data for multiple points in time within a single dataset, allowing you to track changes over time using the time predicate. Returns data as a structured response with headers and rows, where the first element contains column names and subsequent elements contain the data values for each geography and time period.

ActionTry it

Query Timeseries International Trade Exports by HS

Tool to query international trade exports by Harmonized System code from Census Bureau time series API. Use when you need export statistics filtered by time period, country, commodity, or customs district.

ActionTry it

Query Timeseries International Trade Imports by End Use

Query international trade imports by end-use category from Census Bureau timeseries data. Use when you need monthly US import statistics categorized by product end-use (e.g., foods, industrial supplies, capital goods, automotive, consumer goods).

ActionTry it

Query Timeseries Poverty

Query poverty statistics from the Census Bureau's timeseries poverty datasets. Use this tool to retrieve Small Area Income and Poverty Estimates (SAIPE) and historical poverty data for states, counties, and school districts. SAIPE provides annual estimates of income and poverty for all counties and school districts.

ActionTry it

Query Timeseries QWI State/Area

Query Quarterly Workforce Indicators (QWI) State/Area characteristics from the Census Bureau's time series API. Use when you need employment, payroll, job creation/destruction, or workforce turnover statistics by state or county for specific quarters.

ActionTry it

Query ZIP Business Patterns

Tool to query ZIP Code Business Patterns (ZBP) data including establishments and employment by ZIP code and industry. Use when you need business statistics at the ZIP code level, filtered by NAICS industry codes.

ActionTry it