# API League

> API League is a hub of 55 read-only HTTP APIs across twelve categories — Books, News, Humor,
> Food, Knowledge, Games, Art, Web, Text, Media, Math and Storage — behind one host, one API
> key and one OpenAPI 3.0 contract. Operated by skycraft GmbH (Dresden, Germany), which has
> been shipping developer APIs since 2015. Every operation is an HTTP GET; there are no
> webhooks, no events and no OAuth.

Generated by API Evangelist from the provider's public surface on 2026-09-02. API League does
not publish an llms.txt of its own: https://apileague.com/llms.txt returns HTTP 200 serving the
site's catch-all homepage HTML, not a text document.

## How to call it

- Base URL: https://api.apileague.com (no version segment)
- Auth: an API key, either as `?api-key=YOUR-API-KEY` or as the `x-api-key` header. Prefer the
  header — the query form puts the secret in logs, history and referrers.
- Get a key: https://apileague.com/console/ (free plan, no card)
- Errors: flat JSON `{"status","code","message"}`. 401 no/bad key · 402 daily token quota gone ·
  403 not permitted · 404 unknown id · 406 bad parameters · 429 rate or concurrency exceeded.
  Not RFC 9457.
- Budget: read `X-API-Quota-Request`, `X-API-Quota-Used` and `X-API-Quota-Left` off every
  response. Billing is per TOKEN, not per request, and a token cost varies by endpoint and by
  parameters. Quotas reset at midnight UTC.
- Throttling: there is NO `Retry-After` and no `RateLimit-*` header. On a 429 you must use your
  own backoff. Concurrency is a separate ceiling from request rate.
- Pagination: `number` + `offset` in, `total_results`/`available` + `number` + `offset` back.
- Caching: the terms of use forbid storing API League data; with written permission a cache may
  be held for at most one hour. Do not build a durable index on this API.

## APIs

- [API League Platform](https://apileague.com/apis/): 55 GET operations across 12 categories
- [OpenAPI 3.0 specification (JSON, v1.9.0)](https://raw.githubusercontent.com/ddsky/api-league-clients/master/apileague-openapi-3.json): the provider's own machine-readable contract
- [Postman collection](https://www.postman.com/spoonacular-api/workspace/api-league/collection/7431899-68556c9b-453c-4759-bd5e-4f783b0117e8): public and forkable

## Categories and operations

- Books (2): searchBooksAPI, findSimilarBooksAPI
- News (3): searchNewsAPI, topNewsAPI, extractNewsAPI
- Humor (6): searchJokesAPI, randomJokeAPI, searchMemesAPI, randomMemeAPI, searchGifsAPI, generateNonsenseWordAPI
- Food (4): searchRecipesAPI, retrieveRecipeInformationAPI, searchDrinksAPI, computeNutritionAPI
- Knowledge (5): randomTriviaAPI, randomLifeHackAPI, randomAffirmationAPI, randomQuoteAPI, randomRiddleAPI
- Games (3): searchGamesAPI, retrieveGameById, findSimilarGamesAPI
- Art (4): artSearchAPI, retrieveArtworkById, randomPoemAPI, imageToAsciiArtByURLAPI
- Web (6): searchWebAPI, extractContentFromAWebPageAPI, extractPublishDateAPI, extractAuthorsAPI, retrievePageRankAPI, verifyEmailAddressAPI
- Text (13): correctSpellingAPI, detectLanguageAPI, detectSentimentAPI, detectGenderByNameAPI, scoreTextAPI, scoreReadabilityAPI, extractDatesAPI, listWordSynonymsAPI, tagPartOfSpeechAPI, stemTextAPI, singularizeWordAPI, pluralizeWordAPI, extractEntitiesAPI
- Media (6): searchRoyaltyFreeImagesAPI, searchIconsAPI, vectorSearchAPI, screenshotAPI, rescaleImageAPI, detectMainImageColorAPI
- Math (1): convertUnitsAPI
- Storage (2): storeKeyValueGETAPI, readKeyValueFromStoreAPI

## Docs

- [Quick start](https://apileague.com/docs/quick-start/)
- [Authentication](https://apileague.com/docs/authentication/)
- [Quotas and rate limiting](https://apileague.com/docs/quotas-and-rate-limiting/)
- [API reference index](https://apileague.com/apis/)
- [SDKs — 21 languages](https://apileague.com/sdks/)
- [Pricing](https://apileague.com/pricing/) — Free $0/50 tokens per day · Rookie $7 · Pro $39 · Champion $199
- [Status](https://status.apileague.com/) — 99.9% uptime target on all plans
- [Terms and privacy](https://apileague.com/terms/)
- [Discord](https://discord.gg/QudH9DTNzx)
- [Articles](https://apileague.com/articles/)

## SDKs

- npm: `npm install apileague-js` (v1.9.0, published 2025-12-09) — the ONLY registry-published client
- The other 20 languages are generated with OpenAPI Generator and distributed only as source
  trees and zips from https://github.com/ddsky/api-league-clients — `pip install apileague`,
  `go get`, Maven, NuGet, RubyGems, Packagist and crates.io do NOT resolve.

## Specs and artifacts (API Evangelist)

- [OpenAPI, harvested verbatim](https://raw.githubusercontent.com/api-evangelist/api-league/refs/heads/main/openapi/_original/api-league-openapi.json)
- [Authentication profile](https://raw.githubusercontent.com/api-evangelist/api-league/refs/heads/main/authentication/api-league-authentication.yml)
- [Conventions, including reversibility](https://raw.githubusercontent.com/api-evangelist/api-league/refs/heads/main/conventions/api-league-conventions.yml)
- [Error catalog](https://raw.githubusercontent.com/api-evangelist/api-league/refs/heads/main/errors/api-league-problem-types.yml)
- [Rate limits](https://raw.githubusercontent.com/api-evangelist/api-league/refs/heads/main/rate-limits/api-league-rate-limits.yml)
- [Plans and pricing](https://raw.githubusercontent.com/api-evangelist/api-league/refs/heads/main/plans/api-league-plans-pricing.yml)
- [Data model](https://raw.githubusercontent.com/api-evangelist/api-league/refs/heads/main/data-model/api-league-data-model.yml)
- [Agent skills](https://raw.githubusercontent.com/api-evangelist/api-league/refs/heads/main/skills/_index.yml)

## What does not exist

Recorded so an agent stops looking: no MCP server (mcp.apileague.com does not resolve), no A2A
agent card, no `.well-known` document on any host, no webhooks or events, no AsyncAPI, no
GraphQL, no gRPC, no SOAP/WSDL, no CLI, no changelog, no deprecation policy, no OAuth, no
sandbox or test keys, no published security or trust-center page.