zapi.
APIsPricingDocsMCP
APIsPricingDocsMCP
Sign in
zapi.
APIsPricingDocsMCP
APIsPricingDocsMCP
Sign in
Finance/Census
Logo Census

Census

Dated values for any Census economic-indicator series.

3 endpoints3 endpoints on this scraper1.0k calls1.0k calls so farupdated last monthLast updated 8/21/2026, 2:23:03 AMBusy: 10+ calls so farllms.txt
Endpoints3

3/3 passing
checked 20 hours ago · daily 01:00 WIB

Series

Dated values for any Census economic-indicator series.

GET/v1/finance:census/series6h cache10 paramschecking key…
Parameters
programstringrequired

Program code. programs lists all 21.

categorystringrequired

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

dataTypestringrequired

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

geoLevelstring

Geography level from program. Default US.

adjustedenum

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

errorDataenum

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

includeUnreleasedenum

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

fromstring

First year, YYYY. Default five years ago.

tostring

Last year, YYYY. Default the current year.

lengthnumber

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

·
Response
EXAMPLE
{
  "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"
}

Code

Series
index.ts
// npm i zpi-sdk
import { ZpiClient } from "zpi-sdk";

const client = new ZpiClient({ apiKey: "zpi_xxxxxxxxxxxxxxxxxxxxxxxx" });

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
});
console.log(data);
Recommended · typed errors, safe retries and bulk jobsSDK reference

Full reference

3 endpoints · plain text
GET
Series/v1/finance:census/series
10 params

Dated values for any Census economic-indicator series.

Parameters

programstringrequired
Program code. programs lists all 21.
categorystringrequired
Category code from program — 44X72 is retail trade and food services in MARTS.
dataTypestringrequired
Data-type code from program — SM is sales in MARTS, MPCSM the monthly percent change.
geoLevelstringoptional
Geography level from program. Default US.
adjustedenumoptional
Seasonally adjusted. Word-valued upstream — 1 is silently read as no. Default yes. Values: yes, no.
errorDataenumoptional
Return the sampling-variability series instead of the estimate. Default no. Values: yes, no.
includeUnreleasedenumoptional
Keep the pre-allocated months past the last release, which the bureau publishes as NA. Default false. Values: true, false.
fromstringoptional
First year, YYYY. Default five years ago.
tostringoptional
Last year, YYYY. Default the current year.
lengthnumberoptional
Observations to return, newest first. Default 120, max 2000.

Request

curl -X GET "https://api.zapi.ink/v1/finance:census/series?program=MARTS&category=44X72&dataType=SM&geoLevel=US&adjusted=yes&errorData=no&includeUnreleased=false&from=2020&to=2026&length=24" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
}
GET
Programs/v1/finance:census/programs
1 param

The Census Bureau's economic indicator programs — the vocabulary every other

Parameters

querystringoptional
Case-insensitive filter over the program code and name.

Request

curl -X GET "https://api.zapi.ink/v1/finance:census/programs?query=retail" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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"
}
GET
Program/v1/finance:census/program
3 params

One Census economic indicator program's whole code vocabulary — categories,

Parameters

programstringrequired
Program code — MARTS, MRTS, M3, M3ADV, RESCONST, FTD and 15 more. programs lists them.
querystringoptional
Case-insensitive filter over the category code and description.
lengthnumberoptional
Categories to return. Default 200, max 2000.

Request

curl -X GET "https://api.zapi.ink/v1/finance:census/program?program=MARTS&query=grocery&length=50" \
  -H "x-api-key: zpi_xxxxxxxxxxxxxxxxxxxxxxxx"

Example response

{
  "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
}

Related APIs

More in finance

Pluang

financepluang

Data pasar Pluang lintas aset: order book, running trade, tradebook dan ringkasan broker per saham IDX, plus saham Amerika, emas, kripto, sinyal analis dan berita.

1.7M1.7M calls so far1dResponses cached for 1d
Busy: 10+ calls so far

IDX (Bursa Efek Indonesia)

financeidx

Data Bursa Efek Indonesia: ringkasan saham & indeks, top movers, broker, emiten, laporan keuangan, berita, dan passthrough ke ratusan endpoint /primary/.

756.1K756.1K calls so far1dResponses cached for 1d
Busy: 10+ calls so far

TradingView

financetradingview

Screener, charts, technical indicators, fundamentals, news and the macro calendar across 16 markets — Indonesian equities, US equities, crypto, forex and futures.

341.4K341.4K calls so far1dResponses cached for 1d
Busy: 10+ calls so far

Stockbit

financestockbit

Data saham IDX dari Stockbit: harga, chart intraday, profil emiten, diskusi komunitas, dan kamus investasi.

115.5K115.5K calls so far1dResponses cached for 1d
Busy: 10+ calls so far

Investing

financeinvesting

Data pasar finansial lengkap — quote saham/forex/crypto/komoditas, teknikal, OHLCV historis, berita, analisis, dan kalender ekonomi.

69.6K69.6K calls so far1hResponses cached for 1h
Busy: 10+ calls so far

Binance Futures

financebinance-futures

USD-M perpetual futures market data: funding, premium index, open interest, long/short ratios, candles and depth.

40.3K40.3K calls so far10mResponses cached for 10m
Busy: 10+ calls so far
zapi.

One key, one response shape. We keep the scrapers working.

Get an API key
ProductBrowse APIsPricingDocsMCP server
DevelopersSDK on npmGitHubOpenAPI specllms.txt
SupportReport an issueDiscord
LegalTermsPrivacyCookiesAUPRefunds
© 2026 ZapiPublic web data, one API.
zapi.