LifestylePlatform secret

US Census Data

api.census.gov

US Census Bureau demographic and economic data provider.

Tier: 🥉 Bronze
Reward: ₩15,000
Auth: Platform secret
Operations: 2
Working now: 0 contributors
Status: Open

Scope

Exposes the Census Bureau data API. Callers browse available dataset vintages and query variables for geographies such as states and counties from surveys like the American Community Survey.

Expected operations

list-datasetsList census datasetsreadDifficulty: easy

Return available census datasets and vintages matching an optional keyword.

Inputs

keywordstringoptional

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Keyword to match dataset titles

american community survey

yearnumberoptional

Vintage year filter

2024

Outputs

datasetsdataset_idtitlevintagedescriptiontotal_count

Acceptance

Dataset identifiers are the canonical values used by the data query operation without further transformation.
Vintage filtering returns only datasets actually published for that year rather than nearest-year fallbacks.

Auth required for this operation.

get-census-dataGet census datareadDifficulty: hard

Return variable values for a geography level within one dataset, such as population by county in a state.

Inputs

dataset_idstringrequired
Dataset identifier returned by the list operation
acs5
variablesstringrequired
Comma-separated census variable codes
B01001_001E,B19013_001E
geography_levelstringrequired
Geography level: state, county, or place
county
state_codestringoptional
Two-digit state FIPS code to scope sub-state queries
06

Outputs

rowsgeography_namegeography_codevariable_codevaluetotal_count

Acceptance

Every value row is keyed by both the geography code and the variable code so wide requests remain unambiguous.
Sub-state geography levels require the state scope, and its absence is rejected with guidance rather than a cryptic upstream error.

Auth required for this operation.