v1.4.2 • Stable

Aevum Encyclopedia API

Access millions of verified, AI-enhanced encyclopedia articles programmatically. Built for researchers, educators, and developers.

Overview

The Aevum Encyclopedia API provides RESTful access to our comprehensive knowledge graph. All requests and responses use application/json. The API is versioned via the /v1/ prefix and supports cross-origin requests (CORS) for browser-based applications.

💡

Sandbox Mode: Append ?mode=sandbox to any endpoint to test against isolated, sample data without consuming rate limits.

Base URL

Production

https://api.aevum-encyclopedia.com/v1

Authentication

Authenticate your requests by including your API key in the X-Aevum-API-Key header. Keys can be generated from your developer dashboard.

cURL

curl -X GET https://api.aevum-encyclopedia.com/v1/articles/quantum-physics \
  -H "X-Aevum-API-Key: aev_sk_live_4f8a..." \
  -H "Accept: application/json"

⚠️

Never expose your secret API keys in client-side code. Use environment variables or a backend proxy for production applications.

Endpoints

Retrieve Article

Fetch a specific article by its unique identifier.

GET /v1/articles/{id}

GET /v1/articles/renaissance-art-history

Path Parameters

Parameter	Type	Description
idrequired	string	Unique article slug or UUID

Response

200 OK

{
  "id": "renaissance-art-history",
  "title": "Renaissance Art",
  "excerpt": "A cultural movement that profoundly influenced European intellectual life...",
  "content": "The Renaissance marked a transition from medieval to modern...",
  "category": "Arts",
  "updated_at": "2025-03-14T09:30:00Z",
  "metadata": {
    "word_count": 4820,
    "read_time_min": 12,
    "verified": true,
    "languages": ["en", "es", "fr"]
  }
}

Search Knowledge Base

Perform semantic and keyword searches across the encyclopedia. Supports filtering by category, language, and date range.

POST /v1/search

{
  "query": "behavioral economics decision making",
  "limit": 10,
  "offset": 0,
  "filters": {
    "categories": ["Economics", "Psychology"],
    "min_verified": true
  }
}

Rate Limits

API requests are throttled to ensure fair usage and system stability. Limits are applied per API key on a rolling hourly window.

Plan	Requests/Hour	Burst Limit
Free	100	10/s
Developer	2,000	50/s
Enterprise	Custom	Unlimited

Rate limit status is returned in response headers:

Response Headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 842
X-RateLimit-Reset: 1678896000

Error Handling

The API uses standard HTTP status codes and returns detailed error payloads in JSON format.

400

Bad Request. Invalid parameters or malformed JSON.

401

Unauthorized. Missing or invalid API key.

403

Forbidden. Insufficient permissions for this resource.

404

Not Found. Article or endpoint does not exist.

429

Too Many Requests. Rate limit exceeded. Retry after header value.

500

Internal Server Error. Something went wrong on our end.

Error Response Format

401 Unauthorized

{
  "error": {
    "code": 401,
    "message": "Invalid or expired API key",
    "details": null,
    "request_id": "req_8f3a2b1c9d"
  }
}

Pagination

List endpoints support cursor-based pagination to optimize performance for large datasets. Use the next_cursor value from the previous response to fetch subsequent pages.

Pagination Response Wrapper

{
  "data": [ ... ],
  "meta": {
    "total": 14250,
    "limit": 25,
    "offset": 0,
    "has_more": true,
    "next_cursor": "eyJpZCI6MTQyNTB9"
  }
}