API Documentation v1

Programmatically access 2.4M+ verified encyclopedia articles, knowledge graphs, and semantic search capabilities. Built for researchers, educators, and developers.

Quick Example

curl https://api.aevumencyclopedia.com/v1/articles/quantum-computing \n  -H Authorization: Bearer YOUR_API_KEY \n  -H Accept: application/json

import requests

response = requests.get(
    "https://api.aevumencyclopedia.com/v1/articles/quantum-computing",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

const response = await fetch('https://api.aevumencyclopedia.com/v1/articles/quantum-computing', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});
const data = await response.json();

Authentication

Access to the Aevum Encyclopedia API requires a valid API key. Include it in the Authorization header using the Bearer scheme. Keys are scoped to your account tier and can be rotated in the dashboard.

Authorization: Bearer sk_live_7x9m2k4p8q1w3e5r7t9y0u2i4o6p8a1s3d5f7g9h

Base URL

All API requests must be made to the following endpoint:

https://api.aevumencyclopedia.com/v1

Versioning is URL-based. Breaking changes will trigger a new major version (v2, v3). Deprecated versions are supported for 12 months after sunset.

Articles

{
  "id": "qc_9f82a1b4",
  "title": "Quantum Computing",
  "slug": "quantum-computing",
  "language": "en",
  "excerpt": "Quantum computing leverages quantum mechanical phenomena...",
  "content": "# Quantum Computing\n\nLeverages superposition...",
  "tags": ["physics", "technology", "computing"],
  "verified": true,
  "last_updated": "2025-03-14T09:22:00Z"
}

Semantic Search

Categories

Knowledge Graph

Submit Contributions

{
  "title": "CRISPR-Cas9 Gene Editing",
  "content_md": "# CRISPR-Cas9\n\nA revolutionary gene-editing tool...",
  "category": "biology",
  "sources": [
    "https://doi.org/10.1126/science.120...",
    "https://www.nature.com/articles/s41..."
  ],
  "tags": ["genetics", "biotech", "medicine"]
}

Rate Limits

API access is governed by tiered rate limits. Exceeding limits returns 429 Too Many Requests. Limits reset per rolling window.

Error Handling

The API uses standard HTTP status codes and returns structured JSON error payloads for debugging.

Error Response Format

{
  "error": {
    "code": "AUTH_INVALID",
    "message": "The provided API key is invalid or revoked.",
    "status": 401,
    "request_id": "req_8x2m9k4p1q"
  }
}

SDKs & Libraries

Official client libraries are available for rapid integration. All are open-source and maintained by the Aevum team.

Changelog