Yes. The Free tier is 600 requests a month at 100 requests a minute, across every endpoint in the catalog, with no credit card. Nothing about it expires.

What happens when I hit the quota?

Requests return 429 with the limit, what you have used, and which window you tripped — nothing is queued, and nothing is charged. The monthly quota resets on the 1st (UTC). There is no rollover: unused requests do not carry into the next month.

Do failed requests use up my quota?

A 5xx does not. If a source breaks on our side, the request is excluded from your monthly count. A 4xx does count — a wrong parameter is still a request we answered. Per-minute throttling counts everything, so a retry loop is still throttled.

Which tier do I need?

Start on Free. Every response carries the remaining quota in its headers, and the dashboard reads the same number enforcement uses, so you will see the ceiling coming rather than discovering it.

How is Zapi different from RapidAPI or Apify?

Zapi focuses on a consistent REST contract — one API key, one response format, one error pattern for every source. No need to learn per-provider quirks like on traditional marketplaces, and no need to set up scraping workflows like on Apify.

What about the legality of accessing public data?

Zapi only accesses data that is publicly available without a login. Responsibility for how it is ultimately used stays with the developer — make sure your use case complies with the original source's ToS and the regulations in your operating region.

Is there an official SDK?

One: zpi-sdk, for TypeScript and JavaScript. It carries a typed error hierarchy, retries only what is safe to retry, submits bulk jobs, and verifies webhook signatures. Everything else is plain REST — cURL or any HTTP client works.

Can I request a source that isn't in the catalog yet?

Yes, through the community Discord, on any tier.

Why are Pro and Ultra marked Soon?

Checkout is not open yet. The limits and features listed on those tiers are already built and enforced — what is pending is billing, not the product.

Census

Dated values for any Census economic-indicator series.

Endpoints: 3
Requests: 1.0k
Updated: 5 hours ago
For LLMs: llms.txt

Endpoint healthnot yet measured

seriesnot measured
programsnot measured
programnot measured

no measurements yetdaily 01:00 WIB

Playground

3 endpoints

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 examples

Series

zpi-sdkrecommended

// 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);

Full SDK reference →

cURL

request.sh

curl -X GET "https://api.zpi.web.id/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"

Full reference

3 endpoints · plain text

GETSeries/v1/finance:census/seriesDated 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.zpi.web.id/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"
}

GETPrograms/v1/finance:census/programsThe 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.zpi.web.id/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"
}

GETProgram/v1/finance:census/programOne 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.zpi.web.id/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
}

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

// 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);

curl -X GET "https://api.zpi.web.id/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"

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

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

Playground

Code examples

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

Pluang

Binance Vision

TradingView

Stockbit

Mempool Space

Etherscan

Playground

Code examples

Full reference

Parameters

Request

Example response

Parameters

Request

Example response

Parameters

Request

Example response

Related APIs

Pluang

Binance Vision

TradingView

Stockbit

Mempool Space

Etherscan