API Overview

The Aevum Encyclopedia REST API provides programmatic access to our knowledge base, search engine, and knowledge graph. Designed for developers, researchers, and applications requiring verified, multilingual, and AI-enhanced content.

Production Base URL https://api.aevumencyclopedia.com/v1

Authentication

All API requests require authentication via Bearer Token. Obtain your API key from the Developer Dashboard. Include it in the `Authorization` header.

                        HTTP Header
                        
                        Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

Endpoints

GET /articles

List Articles

Retrieve a paginated list of articles. Supports filtering by category, language, and publication date.

Parameter	Type	Required	Description
category	string	Optional	Filter by knowledge domain
lang	string	Optional	ISO 639-1 language code (default: en)
limit	integer	Optional	Items per page (max: 100)
cursor	string	Optional	Pagination cursor

                            Example Response (200 OK)
                            
                        

                            {
  "data": [
    {
      "id": "art_8x92k1m3",
      "title": "Quantum Computing",
      "slug": "quantum-computing",
      "category": "technology",
      "language": "en",
      "last_updated": "2025-09-12T08:30:00Z",
      "verification_score": 0.98
    }
  ],
  "meta": {
    "total": 243812,
    "next_cursor": "eyJpZCI6...",
    "has_more": true
  }
}
                        

GET /articles/:id

Get Article Details

Retrieve full content, metadata, citations, and AI-generated summaries for a specific article.

Parameter	Type	Required	Description
id	string	Required	Unique article identifier
include	string	Optional	Comma-separated: citations,summary,metadata

                            Example Response (200 OK)
                            
                        

                            {
  "data": {
    "id": "art_8x92k1m3",
    "title": "Quantum Computing",
    "content": "Quantum computing leverages quantum mechanical phenomena...",
    "summary": "An overview of quantum superposition, qubits, and current industrial applications.",
    "citations": [...],
    "metadata": {
      "word_count": 3420,
      "read_time_min": 12,
      "difficulty": "intermediate"
    }
  }
}
                        

GET /search

Semantic Search

Full-text and AI-driven semantic search across the entire encyclopedia. Supports fuzzy matching and cross-language queries.

Parameter	Type	Required	Description
q	string	Required	Search query
semantic	boolean	Optional	Enable AI semantic matching (default: true)
domains	array	Optional	Restrict to specific knowledge domains

POST /articles

Submit Draft Article

Authenticated contributors can submit new articles or drafts for peer review. Requires elevated API permissions.

                            Request Body
                            
                        

                            {
  "title": "CRISPR-Cas9 Gene Editing",
  "slug": "crispr-cas9",
  "category": "biology",
  "language": "en",
  "content_markdown": "## Introduction\nCRISPR-Cas9 is a...",
  "sources": [
    "https://doi.org/10.1038..."
  ]
}
                        

GET /knowledge-graph/:id

Retrieve Knowledge Connections

Fetches the semantic knowledge graph for an article, returning related concepts, entities, and relationship weights.

Parameter	Type	Required	Description
id	string	Required	Article ID to map
depth	integer	Optional	Graph traversal depth (1-3)
min_weight	float	Optional	Minimum relationship relevance (0.0-1.0)

Rate Limits

API access is governed by tiered rate limits. Headers are included in every response for monitoring.

Free Tier

1,000

requests / hour

Pro Tier

10,000

requests / hour

Enterprise

Custom

contact sales

                        Response Headers
                        
                        X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 842
X-RateLimit-Reset: 2025-09-12T10:00:00Z

Error Codes

The API uses standard HTTP status codes. Detailed error payloads are returned in the `errors` array.

400 Bad Request

Invalid parameters or malformed JSON

401 Unauthorized

Missing or invalid API key

403 Forbidden

Insufficient permissions for endpoint

404 Not Found

Resource does not exist

429 Too Many Requests

Rate limit exceeded. Wait for reset.

500 Internal Error

Unexpected server failure

SDKs & Developer Tools

Official and community-maintained libraries to integrate Aevum Encyclopedia into your stack.

                        Installation
                        
                        # Python
pip install aevum-encyclopedia-sdk

# JavaScript / Node.js
npm install @aevum/api-client

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