Skip to content
OmicIDX

Rate limits

import Wip from ”../../../components/Wip.astro”;

Default limit

Section titled “Default limit”

The API enforces a default rate limit of 1000 requests per minute per IP. Reasonable interactive use stays well below this. Bulk pipelines should respect the response headers.

Headers

Section titled “Headers”

Every response includes:

  • X-RateLimit-Limit — your current limit (requests per window).
  • X-RateLimit-Remaining — how many requests you have left in the current window.
  • X-RateLimit-Reset — UNIX timestamp at which the window resets.

Hitting the limit

Section titled “Hitting the limit”

When you exceed the limit, the API returns 429 Too Many Requests with a Retry-After header (in seconds). Wait for that interval and retry.

HTTP/1.1 429 Too Many Requests
Retry-After: 30

Bulk pipelines

Section titled “Bulk pipelines”

If you’re scraping the entire index, prefer the downloadable DuckDB snapshot (omicidx.duckdb on R2) over hitting the API for every record. It’s faster, doesn’t consume rate budget, and is the same data.