Aevum Encyclopedia API

Quick Start

Base URL

https://api.aevum-encyclopedia.com/v1

Authentication

Headers: X-Aevum-Key: YOUR_API_KEY

Example Request

curl -X GET "https://api.aevum-encyclopedia.com/v1/articles?query=quantum+computing" \n -H "X-Aevum-Key: $API_KEY"

📚 Articles & Search

GET /articles Search and retrieve encyclopedia entries

Returns a paginated list of articles matching the query parameters. Supports fuzzy matching, language filtering, and source verification levels.

Parameter	Type	Required	Description
query	string	YES	Search term or phrase
lang	string	NO	ISO 639-1 language code (default: en)
limit	integer	NO	Results per page (max 50, default 10)
verified_only	boolean	NO	Filter to peer-reviewed entries only

Request

Response

# GET /articles?query=photosynthesis&lang=de&verified_only=true
{
  "Authorization": "Bearer <your_token>"
}

GET /articles/{id} Fetch full article by ID

Returns the complete article including structured data, references, multimedia assets, and citation metadata.

Parameter	Type	Required	Description
id	string	YES	Article unique identifier

Response (200)

{
  "id": "art_1a2b3c",
  "title": "General Relativity",
  "content_html": "<p>Einstein's theory...</p>",
  "references": [
    { "type": "journal", "title": "Annalen der Physik, 1916" }
  ],
  "last_updated": "2025-09-14T08:30:00Z"
}

🤖 AI & Knowledge Graph

POST /ai/insights Generate AI-powered connections & summaries

Uses Aevum's proprietary models to surface cross-disciplinary connections, generate summaries, and suggest related concepts.

Parameter	Type	Required	Description
topic	string	YES	Subject to analyze
depth	string	NO	"surface" \| "deep" \| "expert" (default: surface)
include_graph	boolean	NO	Return knowledge graph nodes/edges

Request

Response

{
  "topic": "CRISPR-Cas9",
  "depth": "deep",
  "include_graph": true
}

🌍 Categories & Metadata

GET /categories List all knowledge domains

Returns the hierarchical taxonomy used to organize Aevum's content. Includes article counts, subcategories, and canonical URLs.

{
  "categories": [
    { "id": "cat_01", "name": "Natural Sciences", "count": 412030 },
    { "id": "cat_02", "name": "Humanities", "count": 289140 },
    { "id": "cat_03", "name": "Technology & Engineering", "count": 245800 }
  ]
}

⚠️ Status Codes

200 OK
201 Created
400 Bad Request
401 Unauthorized
403 Forbidden
429 Rate Limited
500 Server Error

⏱️ Rate Limits

Free Tier 60 req/min
Pro Tier 600 req/min
Enterprise Custom (unlimited)
AI Insights Separate quota (10/min free)