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, conforming to the API Commons Rate Limits specification.

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

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 Throttle: 429
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