Census Bureau

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.,

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.

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.

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.

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.

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.

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.

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

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.

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.

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.

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).

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.

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.

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

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.

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.

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.

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.

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.

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.

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.

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).

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.

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.

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.

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.

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).

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.

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.

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

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.

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.

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.

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.

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).

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.

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.

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.

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.

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).

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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.

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.

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.

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.