Aevum Encyclopedia API

The Aevum Encyclopedia API provides programmatic access to our verified, multi-disciplinary knowledge base. Built for researchers, developers, and educational platforms, it supports real-time article retrieval, semantic querying, and dynamic knowledge graph exploration.

ℹ️ Base URL

All API requests should be made to: https://api.aevumencyclopedia.com/v2

Quickstart

Install the official SDK or make direct HTTP requests. Below is a minimal example using curl:

Copycurl -X GET "https://api.aevumencyclopedia.com/v2/articles/quantum-computing" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Authentication

All requests require a valid API key passed via the Authorization header using Bearer token authentication. Keys can be generated from the Developer Dashboard.

API Key Scopes & Permissions

read:articles — Access to article metadata and full text
read:graph — Query knowledge graph nodes and edges
write:contributions — Submit draft articles for review
admin:audit — Access moderation and usage logs

Scopes are assigned per key and can be rotated or revoked at any time.

Articles Endpoint

Retrieve structured article data, including metadata, citations, and multimedia references.

Method	Endpoint	Description
GET	`/articles/{slug}`	Fetch a single article by unique identifier
GET	`/articles`	List articles with pagination and filtering
GET	`/articles/{slug}/revisions`	Retrieve version history and edit metadata

Response Schema

{
  "id": "art_8x92k1",
  "slug": "quantum-computing",
  "title": "Quantum Computing",
  "summary": "Quantum computing leverages quantum mechanical phenomena...",
  "content": "...",
  "metadata": {
    "language": "en",
    "word_count": 2450,
    "last_verified": "2025-03-18T14:30:00Z",
    "tags": ["physics", "technology", "computing"]
  },
  "citations": ["arxiv:2103.01234", "Nature 2024", "IEEE Trans. Quantum Eng."]
}

Knowledge Graph

Explore conceptual relationships using the /graph endpoint. Supports node traversal, relationship filtering, and semantic expansion.

GET /graph/nodes?query=renaissance&depth=2&expand=art,history

⚠️ Graph Query Limits

Maximum depth is 3. Queries exceeding this limit will return a 400 Bad Request. Use pagination for large traversals.

Rate Limits

To ensure platform stability, API access is throttled based on tier:

Free Tier: 100 requests/minute, 10,000/day
Pro Tier: 1,000 requests/minute, 250,000/day
Enterprise: Custom limits with dedicated endpoints

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

Error Handling

The API uses standard HTTP status codes. Errors return a JSON body with machine-readable codes and human-readable messages.

{
  "error": {
    "code": "AUTH_TOKEN_EXPIRED",
    "message": "The provided API key has expired. Please regenerate.",
    "status": 401,
    "docs_url": "https://docs.aevumencyclopedia.com/errors/auth-token-expired"
  }
}

Contribution Guidelines

Aevum Encyclopedia thrives on expert contributions. If you wish to submit articles or corrections programmatically:

Ensure your key has the write:contributions scope
Use the POST /contributions/drafts endpoint
Include required citation fields in application/json format
Submissions enter a 48-hour expert review queue

Full editorial standards and markdown formatting rules are available in the Contributor Handbook.

Report a Documentation Issue

Found an outdated endpoint or broken example? Please submit an issue on our GitHub repository or use the feedback form. All documentation changes are versioned and tracked.