Skip to content
Skills Library
Data & analytics · Research

census-data

/census-data

US Census Bureau data via API. Use when: user asks about US demographics, population, housing, or economic data by geography. NOT for: non-US data or real-time statistics.

Repository
scienceclaw ↗
Licence
MIT
Last repository change
07.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
8
Deprecation

No signals detected. Repository changed on 07.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

US Census Bureau data via API. Use when: user asks about US demographics, population, housing, or economic data by geography. NOT for: non-US data or real-time statistics.

Original author description

US Census Bureau data via API. Use when: user asks about US demographics, population, housing, or economic data by geography. NOT for: non-US data or real-time statistics.

How it works

  1. When to Use
  2. When NOT to Use
  3. Setup
  4. API Base
  5. Common Commands
  6. Notes
Original SKILL.md headings · 76 lines, 240 words
SKILL.md preview
---
name: census-data
description: "US Census Bureau data via API. Use when: user asks about US demographics, population, housing, or economic data by geography. NOT for: non-US data or real-time statistics."
metadata: { "openclaw": { "emoji": "📋", "requires": { "bins": ["curl"], "env": ["CENSUS_API_KEY"] } } }
---

# US Census Data Skill

Query the US Census Bureau API for demographics, population, and economic data.

## When to Use

- "What's the population of Texas?"
- "Show demographic breakdown by county"
- "Get median household income for California"
- "Compare poverty rates across states"

## When NOT to Use

- Non-US data (use world-bank-data)
- Real-time economic data (use financial APIs)
- Historical pre-1790 data

## Setup

Get a free API key at https://api.census.gov/data/key_signup.html

```bash
export CENSUS_API_KEY=your_key_here
```

## API Base

```
https://api.census.gov/data/
```

## Common Commands

### ACS 5-Year Estimates (Most Used)

```bash
# Total population by state
curl -s "https://api.census.gov/data/2022/acs/acs5?get=NAME,B01001_001E&for=state:*&key=$CENSUS_API_KEY"

# Median household income by state
curl -s "https://api.census.gov/data/2022/acs/acs5?get=NAME,B19013_001E&for=state:*&key=$CENSUS_API_KEY"

# Population by county in California (state FIPS=06)
curl -s "https://api.census.gov/data/2022/acs/acs5?get=NAME,B01001_001E&for=county:*&in=state:06&key=$CENSUS_API_KEY"

# Poverty rate by state
curl -s "https://api.census.gov/data/2022/acs/acs5?get=NAME,B17001_001E,B17001_002E&for=state:*&key=$CENSUS_API_KEY"
```

### Decennial Census

```bash
# 2020 total population by state
curl -s "https://api.census.gov/data/2020/dec/pl?get=NAME,P1_001N&for=state:*&key=$CENSUS_API_KEY"
```

### Common Variables

| Variable | Description |
|----------|-------------|
| B01001_001E | Total population |
| B19013_001E | Median household income |
| B17001_002E | Population below poverty |
| B25077_001E | Median home value |
| B15003_022E | Bachelor's degree holders |
| B02001_002E | White alone population |

## Notes

- Free API key required for most queries
- ACS 5-year estimates are most reliable for small geographies
- FIPS codes identify states (e.g., 06=CA, 36=NY, 48=TX)
- Rate limit: 500 requests/day without key, more with key
- Variables list: https://api.census.gov/data/2022/acs/acs5/variables.html

Versions

The database has no other skills named census-data.

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version b2487c0627c6 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100demographics-analysis
    Research population, income, age, housing, and employment around a site. Use for census, demographic, or local-market questions tied to a location.
  • 100market-research
    Industry statistics and market sizing via free government APIs (BLS, FRED, Census Bureau). Query employment data, economic time series, establishment counts, and build market sizing reports by NAICS industry code. Use for any industry research or market analysis question.
  • 95USMetrics
    Analyze and update 68 US economic and social indicators from five government APIs (FRED, EIA, Treasury, BLS, Census) across 10 categories: GDP, Inflation, Employment, Housing, Consumer Finance, Markets, Trade, Government/Fiscal, Demographics, Health. Two workflows: UpdateData,…
  • 100fred-economic-data
    Query FRED (Federal Reserve Economic Data) API for 800,000+ economic time series from 100+ sources. Access GDP, unemployment, inflation, interest rates, exchange rates, housing, and regional data. Use for macroeconomic analysis, financial research, policy studies, economic…
  • 90bls-query
    Queries U.S. Bureau of Labor Statistics data using the BLS MCP server. Use when user asks about CPI, inflation, unemployment, employment, wages, jobs, labor statistics, producer prices, or any economic indicator tracked by BLS. Maps natural language to correct series IDs and…
  • 100fred-economic-data
    Query FRED (Federal Reserve Economic Data) API for 800,000+ economic time series from 100+ sources. Access GDP, unemployment, inflation, interest rates, exchange rates, housing, and regional data. Use for macroeconomic analysis, financial research, policy studies, economic…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.