Authentication

The API is read-only, and the free tier works with no key at all. Keys exist only to raise limits.

Tiers

Using an API key

If you've been issued a key, send it in the x-api-key header:

Code
curl "https://api.apievangelist.com/v1/search?q=governance" \
  -H "x-api-key: YOUR_API_KEY"

Code
const res = await fetch("https://api.apievangelist.com/v1/posts?limit=50", {
  headers: { "x-api-key": process.env.APIEVANGELIST_API_KEY },
});

Internal tier

Browser requests originating from apievangelist.com network sites (any *.apievangelist.com origin) get the internal tier automatically — no key or configuration needed. This is how the network's own sites consume the API.

Requesting higher limits

If the free tier's 1,000 requests/day doesn't cover your use case, email [email protected] with a short description of what you're building. Keys are issued per consumer with limits matched to the use case.

And if you'd rather skip rate limits entirely for bulk consumption, the static feeds remain free, keyless, and unmetered.