Superhero API · Rate Limits

Superhero Rate Limits

The Superhero API does not publish explicit rate limit values. The service is free and community-maintained; access tokens are issued per GitHub account. Limits below represent reasonable-use estimates. Clients should implement backoff on HTTP 429 or 503 responses.

Superhero Rate Limits is the machine-readable rate-limit profile for Superhero API on the APIs.io network, in the API Commons Rate Limits shape.

It captures 2 rate-limit definitions, across the free tier, measuring requests_per_minute and requests_per_day.

Limit state is signalled in the limit, remaining, reset, and retryAfter response headers, and an exhausted limit returns HTTP 429.

This profile was written by API Evangelist and has not been verified against a page the provider published; treat every limit as unconfirmed until a dated transcription replaces it.

The profile also includes 4 backoff/retry policies defined and response codes documented for throttled and serviceUnavailable.

Tagged areas include Superheroes, Comics, Characters, Entertainment, and Rate Limiting.

2 Limits Exhausted: HTTP 429 limitremainingresetretryAfter
Method: generated, dated 2026-06-13.
Written by API Evangelist on 2026-06-13 and not verified against a page the provider published. Treat every limit as unconfirmed until a dated transcription replaces it.
View Source
SuperheroesComicsCharactersEntertainmentRate Limiting

Limits

Free Tier — Requests Per Minute api-key
requests_per_minute · minute
60
Free Tier — Requests Per Day api-key
requests_per_day · day
10000

Policies

Token in URL
The access token is embedded directly in the request URL path (https://superheroapi.com/api.php/{access-token}/{id}). Keep tokens private; do not expose them in public repositories or client-side JavaScript.
GitHub Login Required
Obtain your access token by authenticating with GitHub at superheroapi.com. Tokens are personal and non-transferable.
Backoff Strategy
Implement exponential backoff with jitter when receiving 429 or 503 responses. Honor the Retry-After header when present.
Fair Use
The API is a free community resource. Sustained high-volume traffic or abusive request patterns may result in token revocation without notice.

Sources

Work with this as data

Every rate limit here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for rate limits

4 MCP tools reach this
  • find_rate_limitsBrowse and filter every rate limit in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This rate limit 
curl "https://apis.io/api/v1/rate-limits/superhero-rate-limits"
All rate limits 
curl "https://apis.io/api/v1/rate-limits?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.