API Reference

Overview

The Aevum API is a RESTful JSON interface designed for scalability and precision. All responses are wrapped in a consistent envelope, and every endpoint supports structured filtering, semantic querying, and real-time knowledge graph traversal.

Base URL: https://api.aevum.com/v2

Authentication

Authenticate using a Bearer token in the Authorization header. Tokens are obtained via the OAuth 2.0 client credentials flow or by generating API keys in your dashboard.

GET /articles

Retrieve verified encyclopedia articles. Supports filtering by category, language, expertise level, and recency.

curl -X GET "https://api.aevum.com/v2/articles?limit=10&lang=en&category=science" \\
  -H "Authorization: Bearer $AEVUM_TOKEN"

const response = await fetch('https://api.aevum.com/v2/articles?limit=10&lang=en', {
  headers: { 'Authorization': `Bearer ${process.env.AEVUM_TOKEN}` }
});
const data = await response.json();

import requests

resp = requests.get(
    "https://api.aevum.com/v2/articles?limit=10&lang=en",
    headers={"Authorization": f"Bearer {AEVUM_TOKEN}"}
)
data = resp.json()

{
  "data": [
    {
      "id": "art_8x9k2m",
      "title": "Quantum Entanglement",
      "category": "physics",
      "verified": true,
      "updated_at": "2025-03-14T09:22:00Z"
    }
  ],
  "meta": { "total": 14230, "page": 1, "per_page": 10 }
}

POST /search

Execute semantic, AI-enhanced searches across the entire knowledge base. Returns ranked results with confidence scores and source tracing.

Error Handling

The API uses standard HTTP status codes. Errors return a consistent JSON structure with a machine-readable code and human-readable message.

Rate Limits & Pagination

All list endpoints support cursor-based pagination. Use the next_cursor value from the response meta object to fetch subsequent pages.