Uscensus Tools#

Configuration File: uscensus_tools.json Tool Type: Local Tools Count: 1

This page contains all tools defined in the uscensus_tools.json configuration file.

Available Tools#

USCensus_get_population (Type: BaseRESTTool)#

Get population and demographic data from the US Census Bureau API. Access decennial census and Am…

USCensus_get_population tool specification

Tool Information:

  • Name: USCensus_get_population

  • Type: BaseRESTTool

  • Description: Get population and demographic data from the US Census Bureau API. Access decennial census and American Community Survey (ACS) data at national, state, county, and city levels. A free CENSUS_API_KEY is required. Variables include total population, housing units, age groups, and race/ethnicity breakdowns. Useful for demographic research, urban planning, and social science analysis. Register at https://api.census.gov/data/key_signup.html.

Parameters:

  • get (string) (required) Comma-separated variable codes to retrieve plus NAME. For 2020 decennial: ‘P1_001N,NAME’ (total pop). For ACS 5-year (B01003_001E=total pop, B19013_001E=median income, B01002_001E=median age). Example: ‘NAME,B01003_001E,B19013_001E’

  • for (string) (required) Geographic unit. Examples: ‘state:’ (all states), ‘county:’ (all counties), ‘state:06’ (California), or ‘county:001’ together with in=’state:06’ (Alameda County CA)

  • dataset ([‘string’, ‘null’]) (optional) Dataset to query. Values: ‘2020/dec/pl’ (2020 decennial), ‘2022/acs/acs5’ (ACS 5-year 2022), ‘2021/acs/acs1’ (ACS 1-year 2021). Default: 2022/acs/acs5

  • in ([‘string’, ‘null’]) (optional) Geographic filter for sub-national queries. Examples: ‘state:06’ (within California)

  • limit ([‘integer’, ‘null’]) (optional) Maximum number of data rows to return (the header row is preserved and is not counted)

Example Usage:

query = {
    "name": "USCensus_get_population",
    "arguments": {
        "get": "example_value",
        "for": "example_value"
    }
}
result = tu.run(query)