examples.json: Get example queries

API: census.gov:census-data-api
Endpoint: /data/{year}/{dataset}/examples.json
Response format: application/json
Auth: unknown
Method: GET
Last Status: 404
Latency: 468ms

Description

Returns working API query examples with valid parameter combinations for the specified dataset. Use this endpoint to understand the required and optional parameters for querying actual data, including geography specifications and available variables.

From spec: Returns example API queries and valid geography combinations for the dataset, useful for understanding how to construct requests.

Usage Tips

- The 'get' parameter lists variables that can be retrieved - The 'fips' section shows available geographic levels and their required parent levels - Example values use FIPS codes (e.g., '06' for California) - Use wildcard '*' to retrieve all values for a geographic level

Parameters (2)

dataset (string, path, required)

Dataset path. Common values: 'acs/acs5' (ACS 5-year), 'acs/acs1' (ACS 1-year), 'dec/sf1' (Decennial Summary File 1), 'cbp' (County Business Patterns)

year (string, path, required)

Vintage (year) of the dataset. Examples: 2022, 2020, 2010

Constraints: {'pattern': '^\\d{4}$'}

Examples (2)

Get example queries for 2022 ACS 5-Year data probe-gate

Demonstrates retrieving example API calls showing valid parameter combinations for the 2022 American Community Survey 5-year estimates dataset.

curl 'https://api.census.gov/data/2022/acs/acs5/examples.json'

import requests

resp = requests.get("https://api.census.gov/data/2022/acs/acs5/examples.json")
data = resp.json()

import zingu_apis

api = zingu_apis.api("census-data")
result = api.fetch("data/{year}/{dataset}/examples.json")

for item in result:
    print(item)

const resp = await fetch("https://api.census.gov/data/2022/acs/acs5/examples.json");
const data = await resp.json();

Truncate

Auto Table Raw

Get example queries for 2020 Decennial Census data probe-gate

Shows example queries for the 2020 Decennial Census Data Population and Housing Characteristics dataset.

curl 'https://api.census.gov/data/2020/dec/dpsx/examples.json'

import requests

resp = requests.get("https://api.census.gov/data/2020/dec/dpsx/examples.json")
data = resp.json()

import zingu_apis

api = zingu_apis.api("census-data")
result = api.fetch("data/{year}/{dataset}/examples.json")

for item in result:
    print(item)

const resp = await fetch("https://api.census.gov/data/2020/dec/dpsx/examples.json");
const data = await resp.json();

Truncate

Auto Table Raw

Probe History

Latency

Status Codes

Time	Status	Latency
2026-04-16 17:10:52.860292	404	468ms
2026-04-16 01:19:37.680427	404	867ms
2026-04-16 00:10:27.257485	200	470ms
2026-04-15 02:58:00.512213	200	483ms
2026-04-15 01:07:28.130699	404	478ms
2026-04-14 02:39:29.256855	200	1073ms
2026-04-14 02:27:35.830341	404	485ms
2026-04-12 13:57:38.553325	404	481ms
2026-04-12 13:50:13.866019	200	459ms
2026-04-10 03:17:00.371467	404	779ms
2026-04-10 02:58:33.329435	200	436ms