Authentication
All API requests require a valid API key passed in the Authorization header.
🔑 API Key Setup
Generate your key from the Developer Dashboard. Never expose it in client-side code.
Authorization: Bearer aevum_live_sk_xxxxxxxxxxxx
🌍 Base URL & Versions
Always include the version prefix. v1 is deprecated.
https://api.aevum-encyclopedia.com/v2
API Endpoints
Click any endpoint to view parameters, request formats, and response examples.
Articles
GET
/articles/{slug}
Retrieve full article metadata and content
| Parameter | Type | Description |
|---|---|---|
| slug* | string | Unique article identifier (e.g., quantum-computing) |
| format | string | Response format: markdown (default) or json |
| lang | string | ISO 639-1 language code |
curl -X GET https://api.aevum-encyclopedia.com/v2/articles/quantum-computing?format=markdown \ -H "Authorization: Bearer YOUR_KEY"
200 OK
{ "id": "art_qc_8842", "title": "Quantum Computing", "slug": "quantum-computing", "content_md": "# Quantum Computing\n\nQuantum computing leverages..." }
POST
/articles/search
Semantic search across the entire encyclopedia
| Parameter | Type | Description |
|---|---|---|
| query* | string | Natural language search query |
| limit | integer | Max results (default: 10, max: 50) |
| filters | object | { category: string[], year_min: int } |
curl -X POST https://api.aevum-encyclopedia.com/v2/articles/search \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "machine learning ethics", "limit": 5 }'
Knowledge Graph
GET
/graph/nodes/{concept_id}
Fetch related concepts and relationship edges
| Parameter | Type | Description |
|---|---|---|
| concept_id* | string | Internal concept identifier |
| depth | integer | Traversal depth (1-3) |
curl -X GET https://api.aevum-encyclopedia.com/v2/graph/nodes/concept_ml_ethics \ -H "Authorization: Bearer YOUR_KEY"
Rate Limits & Status Codes
Fair usage policies ensure platform stability for all developers.
⚡
Tiered Rate Limiting
Free: 100 req/min | Pro: 1,000 req/min | Enterprise: Custom. Headers include X-RateLimit-Remaining and Retry-After.
✅ Success & Info
| 200 OK | Request successful |
| 201 Created | Resource created |
| 204 No Content | Request processed, no body |
❌ Errors
| 400 Bad Request | Invalid parameters |
| 401 Unauthorized | Missing/invalid API key |
| 429 Too Many Requests | Rate limit exceeded |
Official SDKs
Install our native libraries for idiomatic integration.
Python
Async support, type hints, built-in pagination.
pip install aevum-encyclopedia
JavaScript / TS
Promise-based, ESM & CommonJS, auto-retry.
npm i @aevum/sdk
Ruby
Thread-safe, streaming responses, Rails-friendly.
gem install aevum-sdk
Go
Native interfaces, context cancellation, low allocs.
go get github.com/aevum/encyclopedia-go