API & SDK Reference

Integrate the Aevum Encyclopedia's 2.4M+ verified articles, real-time knowledge graphs, and semantic search directly into your applications. The API v2 provides RESTful access with full type safety and SDK support.

Authentication

Access to the Aevum API is secured via API keys. Include your key in the Authorization header using the Bearer scheme.

Authorization: Bearer <YOUR_API_KEY>

Generate keys from the Developer Dashboard. Keys are scoped by environment and can be rotated without downtime.

Articles API

Retrieve structured content, metadata, and revision history for encyclopedia entries.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "slug": "quantum-mechanics",
  "title": "Quantum Mechanics",
  "summary": "Quantum mechanics is a fundamental theory in physics...",
  "content": "<p>Quantum mechanics describes nature at the smallest scales...</p>",
  "categories": ["Physics", "Science"],
  "last_updated": "2025-01-14T08:30:00Z",
  "read_time_minutes": 12,
  "references_count": 47
}

Semantic Search

Our search API goes beyond keywords. It understands context, intent, and cross-domain relationships.

{
  "query": "impact of dark energy on cosmic expansion",
  "filters": {
    "categories": ["Astronomy", "Cosmology"],
    "min_accuracy_score": 0.95
  },
  "limit": 5
}

Knowledge Graph

Explore the relational structure of knowledge. Retrieve nodes and edges representing concepts and their connections.

SDK Installation & Usage

We provide official SDKs for major languages. All SDKs are automatically generated from our OpenAPI spec and support full typing.

pip install aevum-sdk

import aevum

client = aevum.Client(api_key="ae_live_...")

# Fetch an article
article = client.articles.get("renaissance-art")
print(article.title)

# Semantic Search
results = client.search.query(
    query="evolution of printing press",
    limit=3
)
for hit in results:
    print(hit.summary)

npm install @aevum/sdk

import { AevumClient } from '@aevum/sdk';

const client = new AevumClient('ae_live_...');

const article = await client.articles.get('quantum-mechanics');
console.log(article.content);

const graph = await client.graph.getNeighbors('thermodynamics');
// Returns array of connected concepts

go get github.com/aevum/enc-sdk-go

package main

import "github.com/aevum/enc-sdk-go"

func main() {
    client := aevum.New("ae_live_...")
    
    article, err := client.Articles.Get("history-of-rome")
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(article.Title)
}

Rate Limits & Errors

API access is rate-limited based on your tier. Limits are applied per key per minute.

Common Error Codes