Census
Dated values for any Census economic-indicator series.
Series
/v1/finance:census/seriesParameters
| Name | Type | In | Description |
|---|---|---|---|
| program | string | query | Program code. `programs` lists all 21. Required. |
| category | string | query | Category code from `program` — 44X72 is retail trade and food services in MARTS. Required. |
| dataType | string | query | Data-type code from `program` — SM is sales in MARTS, MPCSM the monthly percent change. Required. |
| geoLevel | string | query | Geography level from `program`. Default US. |
| adjusted | enum | query | Seasonally adjusted. Word-valued upstream — `1` is silently read as no. Default yes. One of yes, no. |
| errorData | enum | query | Return the sampling-variability series instead of the estimate. Default no. One of yes, no. |
| includeUnreleased | enum | query | Keep the pre-allocated months past the last release, which the bureau publishes as NA. Default false. One of true, false. |
| from | string | query | First year, YYYY. Default five years ago. |
| to | string | query | Last year, YYYY. Default the current year. |
| length | number | query | 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
Programs
The Census Bureau's economic indicator programs — the vocabulary every other
/v1/finance:census/programsParameters
| Name | Type | In | Description |
|---|---|---|---|
| query | string | query | Case-insensitive filter over the program code and name. |
Example response
{"project":"finance:census", "data": {"count":3, "items": [ {"name":"Advance Monthly Sales for Retail and Food Services","bulkUrl":"https://www.census.gov/econ_getzippedfile/?programCode=MARTS","program":"MARTS" }, {"name":"Advance Retail Inventories","bulkUrl":"https://www.census.gov/econ_getzippedfile/?programCode=MRTSADV","program":"MRTSADV" }, {"name":"Monthly Retail Trade and Food Services","bulkUrl":"https://www.census.gov/econ_getzippedfile/?programCode=MRTS","program":"MRTS" } ],"query":"retail","total":21,"dataset":"programs","provider":"census" },"timestamp":"2026-08-21T02:23:03Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Program
One Census economic indicator program's whole code vocabulary — categories,
/v1/finance:census/programParameters
| Name | Type | In | Description |
|---|---|---|---|
| program | string | query | Program code — MARTS, MRTS, M3, M3ADV, RESCONST, FTD and 15 more. `programs` lists them. Required. |
| query | string | query | Case-insensitive filter over the category code and description. |
| length | number | query | Categories to return. Default 200, max 2000. |
Example response
{"project":"finance:census", "data": {"count":21, "items": [ {"indent":0,"category":"44X72","description":"44X72: Retail Trade and Food Services","categoryIndex":1 }, {"indent":0,"category":"44Y72","description":"44Y72: Retail Trade and Food Services, ex Auto","categoryIndex":2 }, {"indent":0,"category":"44Z72","description":"44Z72: Retail Trade and Food Services, ex Gas","categoryIndex":3 }, {"indent":0,"category":"44W72","description":"44W72: Retail Trade and Food Services, ex Auto and Gas","categoryIndex":4 }, {"indent":0,"category":"44000","description":"44000: Retail Trade","categoryIndex":5 }, {"indent":0,"category":"441","description":"441: Motor Vehicle and Parts Dealers","categoryIndex":6 }, {"indent":0,"category":"441X","description":"4411,4412: Auto and Other Motor Vehicles","categoryIndex":7 }, {"indent":0,"category":"442","description":"442: Furniture and Home Furnishings Stores","categoryIndex":8 } ],"query":null,"total":21,"dataset":"program","periods":420,"program":"MARTS","provider":"census", "dataTypes": [ {"unit":"MLN$","dataType":"SM","description":"Sales - Monthly","dataTypeIndex":1 }, {"unit":"PCT","dataType":"MPCSM","description":"Sales - Monthly Percent Change","dataTypeIndex":2 } ], "footnotes": [ "For the Advance Monthly Retail Trade Survey, estimates for the most recent month are advance estimates that are based on data from a subsample of firms from the larger Monthly Retail Trade Survey. The advance estimates will be superseded in following months by revised estimates derived from the larger Monthly Retail Trade Survey.", "For information on the reliability and use of the data, including important notes on estimation and sampling variance, seasonal adjustment, measures of sampling variability, and other information pertinent to this economic indicator, go to the (https://www.census.gov/retail/index.html) website.", "Estimated measures of sampling variability for totals are expressed as coefficients of variation (CV). Standard errors (SE) are provided for month-to-month change and ratio estimates.", "Estimated measures of sampling variability are based on data not adjusted for seasonal variation, and should be used when drawing inferences about both adjusted and not adjusted estimates.", "NA = Not available. Z = Estimates round to zero." ], "geoLevels": [ {"geoIndex":1,"geoLevel":"US","description":"U.S. Total" } ],"periodEnd":"Dec-2026","updatedAt":"Friday, 14-Aug-26 07:31:07 EDT", "errorTypes": [ {"unit":"PCT","errorType":"E_SM","description":"CV of Sales - Monthly","errorTypeIndex":1 }, {"unit":"PCT","errorType":"E_MPCSM","description":"SE of Sales - Monthly Percent Change","errorTypeIndex":2 } ],"periodStart":"Jan-1992","observations":58730 },"timestamp":"2026-08-21T02:23:03Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
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 });
Census
Dated values for any Census economic-indicator series.
/v1/…census/seriesTry it
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 });