Aevum Encyclopedia API

Access 2.4M+ verified articles, interactive knowledge graphs, and AI-powered insights through our RESTful API. Designed for researchers, educators, and developers building knowledge-driven applications.

🌍 Global Access

All endpoints support multilingual queries and return localized content based on the Accept-Language header or query parameters.

Base URL & Versions

Base URL: https://api.aevum-encyclopedia.com/v1
Version: v1.2.0 (Stable)
Format: JSON

Authentication

All API requests require authentication via Bearer token. Include your API key in the Authorization header.

GET /v1/search?q=quantum+computing
Authorization: Bearer ae_live_sk_8f7d9c2e1a4b...
Content-Type: application/json

⚠️ Security Notice

Never expose your API keys in client-side code or public repositories. Use environment variables or secure vaults.

Core Endpoints

GET /v1/search

Search the encyclopedia using semantic matching, keyword filtering, and AI-powered relevance scoring.

GET /v1/search?q=Renaissance+art&limit=5&lang=en
Authorization: Bearer ae_live_sk_...

{
  "data": [
    {
      "id": "art_renaissance_001",
      "title": "Renaissance Art",
      "summary": "Cultural movement beginning in Florence...",
      "relevance": 0.98,
      "tags": ["Art", "History", "Culture"]
    }
  ],
  "meta": {
    "total": 4723,
    "page": 1,
    "limit": 5
  }
}

Parameter	Type	Description
q required	string	Search query string (max 256 chars)
limit optional	integer	Results per page (1-50, default: 10)
lang optional	string	ISO 639-1 language code (default: en)
category optional	string	Filter by discipline (e.g., science, history)

GET /v1/articles/{id}

Retrieve full article content, metadata, references, and related knowledge graph nodes.

GET /v1/articles/art_renaissance_001
Authorization: Bearer ae_live_sk_...

{
  "id": "art_renaissance_001",
  "title": "Renaissance Art",
  "content": "The Renaissance was a cultural movement...",
  "sections": ["Origins", "Key Figures", "Techniques"],
  "references": 42,
  "last_updated": "2025-03-14T09:22:00Z",
  "graph_nodes": ["Florence", "Michelangelo", "Perspective"]
}

POST /v1/articles

Submit a new article draft for peer review. Requires contributor-tier API key.

POST /v1/articles
Authorization: Bearer ae_live_sk_...
{
  "title": "Quantum Machine Learning",
  "content": "Intersection of quantum computing and...",
  "category": "Technology",
  "references": [
    { "url": "https://arxiv.org/abs/...", "type": "paper" }
  ]
}

Rate Limits

API requests are throttled to ensure fair usage and platform stability. Limits reset every 60 seconds.

Plan	Requests/min	Burst	Concurrent
Free	30	10	2
Developer	120	30	5
Enterprise	1,000	100	20

Exceeding limits returns 429 Too Many Requests with a Retry-After header.

Error Codes

Code	Status	Description
400	Bad Request	Malformed syntax or missing required parameters
401	Unauthorized	Invalid or expired API key
403	Forbidden	Insufficient permissions for requested action
404	Not Found	Article or resource does not exist
429	Too Many Requests	Rate limit exceeded. Check Retry-After header
500	Internal Error	Server-side issue. Retry after 30 seconds

SDKs & Libraries

Official client libraries are available for popular languages. Community-maintained wrappers are also supported.

🐍 Python

Async support, type hints, automatic retries

pip install aevum-encyclopedia

⚡ JavaScript

Node.js & browser compatible, Promise-based

npm install @aevum/sdk-js

🚀 Go

Concurrent requests, context cancellation

go get github.com/aevum/go-sdk

📜 cURL

Zero-dependency, works everywhere

curl -X GET https://api.aevum... -H "Authorization: Bearer ..."