Census

Dated values for any Census economic-indicator series.

3 endpoints1k calls3/3 passing
Get API key
GET/v1/…census/series
passing · 1.7s6h cache

Try it

Checking your keys…

Parameters

program

string · query · required

Program code. `programs` lists all 21.

category

string · query · required

Category code from `program` — 44X72 is retail trade and food services in MARTS.

dataType

string · query · required

Data-type code from `program` — SM is sales in MARTS, MPCSM the monthly percent change.

geoLevel

string · query · optional

Geography level from `program`. Default US.

adjusted

enum · query · optional

Seasonally adjusted. Word-valued upstream — `1` is silently read as no. Default yes.

errorData

enum · query · optional

Return the sampling-variability series instead of the estimate. Default no.

includeUnreleased

enum · query · optional

Keep the pre-allocated months past the last release, which the bureau publishes as NA. Default false.

from

string · query · optional

First year, YYYY. Default five years ago.

to

string · query · optional

Last year, YYYY. Default the current year.

length

number · query · optional

Observations to return, newest first. Default 120, max 2000.

Example response

{"project":"finance:census",  "data": {"to":"2026","from":"2021","unit":"Millions of Dollars","count":67,    "items": [      {"label":"Jul-2026","value":763602,"period":"2026-07"      },      {"label":"Jun-2026","value":768072,"period":"2026-06"      },      {"label":"May-2026","value":766192,"period":"2026-05"      },      {"label":"Apr-2026","value":759097,"period":"2026-04"      },      {"label":"Mar-2026","value":754013,"period":"2026-03"      },      {"label":"Feb-2026","value":741278,"period":"2026-02"      },      {"label":"Jan-2026","value":734503,"period":"2026-01"      },      {"label":"Dec-2025","value":734717,"period":"2025-12"      }    ],"total":67,"source":"Advance Monthly Sales for Retail and Food Services","dataset":"series","program":"MARTS","adjusted":"yes","category":"44X72","dataType":"SM","geoLevel":"US","provider":"census","errorData":"no","seriesName":"Seasonally Adjusted Sales - Monthly","unreleased":5,"extractedAt":"August 20, 2026 (10:23 pm)","latestValue":763602,"categoryName":"44X72: Retail Trade and Food Services: U.S. Total","latestPeriod":"2026-07"  },"timestamp":"2026-08-21T02:23:03Z"}

Errors

  • 401Missing or invalid x-api-key
  • 404Not found or private
  • 429Rate limit or monthly quota reached

Code

const data = await client.run(  "finance:census",  "series",  { program: "MARTS", category: "44X72", dataType: "SM", geoLevel: "US", adjusted: "yes", errorData: "no", includeUnreleased: "false", from: "2020", to: "2026", length: 24 });