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. No authentication key required for basic usage. Variables include total population, housing units, age groups, and race/ethnicity breakdowns. Useful for demographic research, urban planning, and social science analysis.

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), ‘county:001&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 results to return

Example Usage:

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