Question 1

Is Zapi really free?

Accepted Answer

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

Question 2

What happens when I hit the quota?

Accepted Answer

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.

Question 3

Do failed requests use up my quota?

Accepted Answer

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.

Question 4

Which tier do I need?

Accepted Answer

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.

Question 5

How is Zapi different from RapidAPI or Apify?

Accepted Answer

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.

Question 6

What about the legality of accessing public data?

Accepted Answer

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.

Question 7

Is there an official SDK?

Accepted Answer

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.

Question 8

Can I request a source that isn’t in the catalogue yet?

Accepted Answer

Yes, through the community Discord, on any tier.

Option	Type	Default	Purpose
apiKey	string	— (required)	Your Zapi key; sent as x-api-key. Constructor throws if missing.
baseURL	string	https://api.zapi.ink	API origin override (staging, self-hosted).
defaultHeaders	Record<string, string>	{}	Extra headers merged into every request.
fetch	typeof fetch	global fetch	Injectable fetch implementation (polyfill, instrumentation).
timeoutMs	number	30000	Per-request timeout.
maxRetries	number	2	Max retry attempts for retryable failures.
baseRetryDelayMs	number	200	Exponential-backoff base delay.

Configuration