API & MCP

Base URL & authentication

All requests go to https://api.allapi.io and carry your key in the X-AllAPI-Key header. No OAuth, no per-upstream credentials, no Terms-of-Service to accept — one key reaches every platform.

# every request: one header
X-AllAPI-Key: allapi_live_your_key_here

Call a composite — one query, merged across sources

Each composite is a single POST to /api/composite/{name}. It fans out to the relevant upstreams and returns one merged, normalized result.

# artist_omni — one query, merged across every music source
curl -X POST https://api.allapi.io/api/composite/artist_omni \
  -H "X-AllAPI-Key: allapi_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"q": "Aphex Twin"}'

# paper_omni — DOI, title, or author across scholarly indexes
curl -X POST https://api.allapi.io/api/composite/paper_omni \
  -H "X-AllAPI-Key: allapi_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"doi": "10.1038/nature12373"}'

Call a single platform directly

Every one of the 468 platforms also answers on its own path — POST /api/{platform}/{route} — when you want one source instead of a merged chain.

# a single platform, a single route
curl -X POST https://api.allapi.io/api/reddit/search \
  -H "X-AllAPI-Key: allapi_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"q": "askscience"}'

The response envelope

Every endpoint — composite or single — returns the same shape, so you write one parser for the whole catalog:

Rate limits & quotas

Requests are rate-limited per key per minute and metered against your monthly plan quota. Both limits are returned on every response as X-RateLimit-Remaining and X-Quota-Remaining headers. See Pricing for per-plan numbers.

# MCP package publishing soon — see allapi.io/docs.html for setup

{
  "mcpServers": {
    "allapi": {
      "command": "mcp-server-allapi",  # available at launch
      "env": { "ALLAPI_KEY": "allapi_live_your_key_here" }
    }
  }
}

"Use artist_omni to pull everything on Aphex Twin"
"search_caselaw for 'fair use' and summarize the top 3"
"paper_omni for DOI 10.1038/nature12373"