API Documentation

Integrate the world's most comprehensive knowledge graph into your applications. Access millions of verified articles, semantic search, and cross-disciplinary insights via REST.

👋 Welcome Developers
The Aevum Encyclopedia API is designed for speed, accuracy, and scalability. All responses are JSON-formatted, versioned, and include standard HTTP status codes.

Base URL & Versioning

All API requests should be made to:

URL

https://api.aevumencyclopedia.com/v1

The API is currently on v1. Breaking changes will trigger a major version bump. We recommend pinning your integration to v1.

Authentication

Access the API using a Bearer token. Generate your key from the Developer Dashboard.

Header

Authorization: Bearer YOUR_API_KEY

🔒 Security Note: Never expose your secret API keys in client-side code or public repositories. Use environment variables or a backend proxy.

Rate Limits

Requests are limited to prevent abuse. Limits are applied per API key:

Free Tier: 100 requests/minute
Pro Tier: 1,000 requests/minute
Enterprise: Custom limits

Rate limit headers are included in every response:

Headers

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1698765432

Exceeding limits returns a 429 Too Many Requests status.

Endpoints

GET /articles

Retrieve a paginated list of articles. Supports filtering, sorting, and language preference.

Query Parameters

Parameter	Type	Description
q	string	Search query (keyword or phrase)
lang	string	ISO 639-1 code (e.g., `en`, `fr`, `ja`)
category	string	Filter by discipline (e.g., `physics`, `history`)
limit	integer	Results per page (default: 20, max: 100)
offset	integer	Pagination offset

Example Request

cURL

curl -X GET "https://api.aevumencyclopedia.com/v1/articles?q=quantum+computing&lang=en&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "status": 200,
  "data": {
    "articles": [
      {
        "id": "qc-8842a1",
        "title": "Quantum Computing",
        "slug": "quantum-computing",
        "excerpt": "Quantum computing leverages quantum mechanical phenomena...",
        "category": "Physics",
        "last_updated": "2025-01-15T08:30:00Z",
        "languages": ["en", "es", "zh", "de", "ja"],
        "read_time_min": 12
      }
    ],
    "meta": {
      "total": 142,
      "limit": 10,
      "offset": 0
    }
  }
}

POST /search

Advanced semantic search using our AI engine. Supports natural language queries, entity linking, and cross-topic discovery.

Request Body

JSON

{
  "query": "How did Renaissance art influence modern psychology?",
  "depth": "comprehensive",
  "sources": ["academic", "historical", "peer_reviewed"],
  "language": "en"
}

Example Response

JSON

{
  "status": 200,
  "data": {
    "results": [
      {
        "article_id": "ren-art-291",
        "relevance_score": 0.94,
        "matched_concepts": ["perspective", "humanism", "cognitive development"],
        "summary": "Renaissance emphasis on humanism and visual perspective laid groundwork for..."
      }
    ],
    "query_time_ms": 142
  }
}

GET /articles/{id}

Fetch full content, metadata, citations, and knowledge graph connections for a specific article.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Unique article identifier

Example Response

JSON

{
  "status": 200,
  "data": {
    "id": "qc-8842a1",
    "title": "Quantum Computing",
    "content": "Quantum computing is a type of computation..."