Government Data

Census bureau

Learn how to use Census bureau with Composio

Overview

SLUG: CENSUS_BUREAU

Description

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.

Authentication Details

generic_api_key
stringRequired

Connecting to Census bureau

Create an auth config

Use the dashboard to create an auth config for the Census bureau toolkit. This allows you to connect multiple Census bureau accounts to Composio for agents to use.

1

Select App

Navigate to the [Census bureau toolkit page](https://app.composio.dev/apps/Census bureau) and click “Setup Integration”.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2from composio.types import auth_scheme
3
4# Replace these with your actual values
5census_bureau_auth_config_id = "ac_YOUR_CENSUS_BUREAU_CONFIG_ID" # Auth config ID created above
6user_id = "0000-0000-0000"  # UUID from database/app
7
8composio = Composio()
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11    # Replace this with a method to retrieve an API key from the user.
12    # Or supply your own.
13    user_api_key = input("[!] Enter API key")
14
15    connection_request = composio.connected_accounts.initiate(
16        user_id=user_id,
17        auth_config_id=auth_config_id,
18        config={"auth_scheme": "API_KEY", "val": user_api_key}
19    )
20
21    # API Key authentication is immediate - no redirect needed
22    print(f"Successfully connected Census bureau for user {user_id}")
23    print(f"Connection status: {connection_request.status}")
24    
25    return connection_request.id
26
27
28connection_id = authenticate_toolkit(user_id, census_bureau_auth_config_id)
29
30# You can verify the connection using:
31connected_account = composio.connected_accounts.get(connection_id)
32print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Census bureau toolkit’s playground](https://app.composio.dev/app/Census bureau)

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["CENSUS_BUREAU"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Get ACS 1-Year Estimates

Description

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.

Action Parameters

for
stringRequired
get
stringRequired
in
string
key
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get ACS 5-Year Estimates

Description

Tool to retrieve 5-year american community survey estimates for a specified year. use when detailed acs data by geography and variables is required.

Action Parameters

geo_for
stringRequired
geo_in
string
key
string
variables
stringRequired
year
integerRequired

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get American Business Survey

Description

Tool to retrieve annual business survey (abs) data for a specified year and endpoint.

Action Parameters

endpoint
stringRequired
geo
stringRequired
key
stringRequired
variables
arrayRequired
year
integerRequired

Action Response

data
arrayRequired
error
string
successful
booleanRequired

Tool Name: Get Community Resilience Estimates

Description

Tool to retrieve community resilience estimates for a specified year. use after selecting variables and geography to get cre data for analysis.

Action Parameters

for
stringRequired
get
stringRequired
key
string
year
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get County Business Patterns

Description

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.

Action Parameters

NAICS2017
string
for
stringRequired
get
stringRequired
in
string
key
string
year
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Decennial Census Data

Description

Tool to retrieve decennial census data for a specified vintage and dataset. use when you need census variables for a given geography.

Action Parameters

dataset
stringRequired
geography
stringRequired
get
stringRequired
key
string
nested
string
vintage
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Population Estimates

Description

Tool to retrieve population estimates program (pep) data for a specified vintage and dataset. use when you need population or demographic estimates for specific geographies.

Action Parameters

dataset
stringRequired
for
stringRequired
get
stringRequired
key
string
vintage
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Variable Details

Description

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.

Action Parameters

dataset
stringRequired
key
string
variable
stringRequired
year
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired