Functional Integration

Connect your applications to Aevum Encyclopedia's knowledge graph, semantic search, and verified content APIs. Designed for developers, researchers, and enterprise systems.

Quick Start

💡 New? Generate your API key in the Developer Console before proceeding.

Install the official SDK for your language
Configure authentication credentials
Make your first search or article request

Authentication

All API requests require a Bearer token in the Authorization header. Tokens are scoped per environment (sandbox/production).

POST /v1/auth/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}

Response includes a access_token valid for 1 hour. Implement automatic refresh in production.

Client SDKs

Choose your preferred language. All SDKs include auto-retry, pagination helpers, and type definitions.

pip install aevum-encyclopedia

from aevum import AevumClient

client = AevumClient(api_key="ae_live_...")

# Search the knowledge base
results = client.search.query("quantum entanglement", limit=10)
for article in results:
    print(f"{article.title} → {article.summary[:80]}...")

npm install @aevum/encyclopedia-sdk

import { Aevum } from "@aevum/encyclopedia-sdk";

const client = new Aevum({ apiKey: "ae_live_..." });

async function main() {
  const results = await client.search.query("climate models", { limit: 5 });
  results.forEach(a => console.log(`${a.id} | ${a.title}`));
}
main();

curl -X GET "https://api.aevum.io/v1/search?q=renaissance+art&limit=3" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

Core Endpoints

Base URL: https://api.aevum.io/v1

Method	Endpoint	Description
`GET`	`/search`	Semantic search across articles, citations, and entities
`GET`	`/articles/:id`	Retrieve full article content with revision history
`GET`	`/graph/nodes`	Query the knowledge graph for related concepts
`POST`	/validate`	Fact-check a claim against verified sources
`GET`	/export/:id`	Download citations in BibTeX, APA, or CSL-JSON

⚠️ All endpoints require Application/JSON or Application/X-NDJSON content types.

Webhooks

Subscribe to real-time updates for article changes, new citations, or graph topology shifts. Configure endpoints in your dashboard.

{
  "event": "article.updated",
  "timestamp": "2025-03-12T08:14:22Z",
  "data": {
    "article_id": "ae_9f82x1",
    "version": 14,
    "changed_fields": ["summary", "references"],
    "editor": "verified_expert_42"
  }
}

Signatures are verified via X-Aevum-Signature using HMAC-SHA256 with your webhook secret.

Rate Limits & Best Practices

Default: 1,000 requests/min per API key
Burst allowance: 150 requests/sec
Retry with exponential backoff on 429 Too Many Requests
Cache article responses (ETag support enabled)
Use webhooks instead of polling for live updates

Need higher limits? Contact enterprise@aevum.io for dedicated throughput.

Support & Resources

Stuck? Our developer support team averages 4-minute response times.

📖 Full API Reference | 🐛 Bug Reports | 💬 Community Discord