US Census Bureau · Capability

Census Data API — Dataset Query

Census Data API — Dataset Query. 6 operations covering ACS, Decennial, CBP, NES, PEP, and Pulse. Lead operation: Get ACS 5-Year Detailed Tables. Self-contained Naftiko capability.

Census Data API — Dataset Query is a Naftiko capability published by US Census Bureau, one of 8 capabilities the APIs.io network indexes for this provider. It bundles 6 operations across the GET method.

The capability includes 6 read-only operations. Lead operation: Get ACS 5-Year Detailed Tables. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include US Census Bureau, ACS, Decennial, Economic, and Population.

Run with Naftiko US Census BureauACSDecennialEconomicPopulation

What You Can Do

GET

Getacs5 —

/v1/acs5

GET

Getacs1 —

/v1/acs1

GET

Getdecennialpl —

/v1/dec/pl

GET

Getcbp —

/v1/cbp

GET

Getpeppopulation —

/v1/pep/population

GET

Gethouseholdpulse —

/v1/pulse

MCP Tools

census-get-acs5

Get ACS 5-Year Detailed Tables

read-only idempotent

census-get-acs1

Get ACS 1-Year Detailed Tables

read-only idempotent

census-get-decennial-pl

Get Decennial Census Public Law 94-171 Redistricting File

read-only idempotent

census-get-cbp

Get County Business Patterns

read-only idempotent

census-get-pep-population

Get Population Estimates

read-only idempotent

census-get-household-pulse

Get Household Pulse Survey

read-only idempotent

Capability Spec

naftiko: 1.0.0-alpha2
info:
  label: Census Data API — Dataset Query
  description: 'Census Data API — Dataset Query. 6 operations covering ACS, Decennial, CBP, NES, PEP, and Pulse.
    Lead operation: Get ACS 5-Year Detailed Tables. Self-contained Naftiko capability.'
  tags:
  - US Census Bureau
  - ACS
  - Decennial
  - Economic
  - Population
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    CENSUS_API_KEY: CENSUS_API_KEY
capability:
  consumes:
  - type: http
    namespace: census-data-api-query
    baseUri: https://api.census.gov/data
    description: Dataset query surface for the Census Data API.
    resources:
    - name: acs5
      path: /{vintage}/acs/acs5
      operations:
      - name: getacs5
        method: GET
        description: Get ACS 5-Year Detailed Tables
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: acs1
      path: /{vintage}/acs/acs1
      operations:
      - name: getacs1
        method: GET
        description: Get ACS 1-Year Detailed Tables
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: decennial-pl
      path: /{vintage}/dec/pl
      operations:
      - name: getdecennialpl
        method: GET
        description: Get Decennial Census Public Law 94-171 Redistricting File
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: cbp
      path: /{vintage}/cbp
      operations:
      - name: getcbp
        method: GET
        description: Get County Business Patterns
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pep-population
      path: /{vintage}/pep/population
      operations:
      - name: getpeppopulation
        method: GET
        description: Get Population Estimates
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pulse
      path: /{vintage}/pulse
      operations:
      - name: gethouseholdpulse
        method: GET
        description: Get Household Pulse Survey
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: key
      value: '{{env.CENSUS_API_KEY}}'
      placement: query
  exposes:
  - type: rest
    namespace: census-data-api-query-rest
    port: 8080
    description: REST adapter for Census Data API dataset queries.
    resources:
    - path: /v1/acs5
      name: acs5
      operations:
      - method: GET
        name: getacs5
        call: census-data-api-query.getacs5
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/acs1
      name: acs1
      operations:
      - method: GET
        name: getacs1
        call: census-data-api-query.getacs1
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/dec/pl
      name: decennial-pl
      operations:
      - method: GET
        name: getdecennialpl
        call: census-data-api-query.getdecennialpl
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cbp
      name: cbp
      operations:
      - method: GET
        name: getcbp
        call: census-data-api-query.getcbp
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/pep/population
      name: pep-population
      operations:
      - method: GET
        name: getpeppopulation
        call: census-data-api-query.getpeppopulation
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/pulse
      name: pulse
      operations:
      - method: GET
        name: gethouseholdpulse
        call: census-data-api-query.gethouseholdpulse
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: census-data-api-query-mcp
    port: 9090
    transport: http
    description: MCP adapter exposing Census Data API queries to AI assistants.
    tools:
    - name: census-get-acs5
      description: Get ACS 5-Year Detailed Tables
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: census-data-api-query.getacs5
      outputParameters:
      - type: object
        mapping: $.
    - name: census-get-acs1
      description: Get ACS 1-Year Detailed Tables
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: census-data-api-query.getacs1
      outputParameters:
      - type: object
        mapping: $.
    - name: census-get-decennial-pl
      description: Get Decennial Census Public Law 94-171 Redistricting File
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: census-data-api-query.getdecennialpl
      outputParameters:
      - type: object
        mapping: $.
    - name: census-get-cbp
      description: Get County Business Patterns
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: census-data-api-query.getcbp
      outputParameters:
      - type: object
        mapping: $.
    - name: census-get-pep-population
      description: Get Population Estimates
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: census-data-api-query.getpeppopulation
      outputParameters:
      - type: object
        mapping: $.
    - name: census-get-household-pulse
      description: Get Household Pulse Survey
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: census-data-api-query.gethouseholdpulse
      outputParameters:
      - type: object
        mapping: $.