API Documentation

Welcome to the Aevum Encyclopedia API. This RESTful interface provides access to our comprehensive knowledge base, search engine, and contribution tools.

Install SDK View Postman Collection API Status

Overview #

The Aevum API allows developers to retrieve, search, and integrate encyclopedia data into their applications. All requests are made over HTTPS and returned in JSON format.

ℹī¸
New Version: We recently launched v2 of the API with enhanced knowledge graph capabilities. Migration Guide. 
# Production
https://api.aevum-encyclopedia.com/v1

# Sandbox (Testing)
https://sandbox.api.aevum-encyclopedia.com/v1

Authentication #

Aevum uses API keys to authenticate requests. You can view and manage your API keys in the Developer Dashboard. All API keys are tied to your account and have specific scopes.

Authorization: Bearer YOUR_API_KEY
⚠ī¸
Never expose your secret API keys in client-side code or public repositories.

Core Endpoints #

GET /articles/{id}

Retrieve Article

Returns the full content, metadata, and citations for a specific article based on its unique identifier.

Path Parameters

Parameter Type Description
id Required string The unique slug or UUID of the article (e.g., quantum-computing)

Response Example

{
  "id: "quantum-computing,
  "title: "Quantum Computing,
  "excerpt: "Quantum computing leverages quantum mechanical phenomena...,
  "content: {
    "html: "<h1>Introduction</h1><p>...</p>",
    "markdown: "# Introduction\n..."
  },
  "metadata: {
    "lastUpdated: "2025-04-12T10:30:00Z,
    "readTime: 5,
    "difficulty: "intermediate,
    "categories: ["physics, "technology]
  },
  "citations: [
    {
      "title: "Nielsen, M. A. - Quantum Computation,
      "url: "https://doi.org/10.1017/CBO9780511813...,
      "verified: true
    }
  ]
}
POST /search

Search Knowledge Base

Perform semantic and keyword searches across the entire encyclopedia. Supports filters for category, date, and content type.

Request Body

{
  "query: "artificial neural networks history,
  "filters: {
    "category: ["technology, "history],
    "minYear: 2000
  },
  "limit: 10,
  "semanticMatch: true
}

Response Example

{
  "results: [
    {
      "id: "backpropagation,
      "title: "Backpropagation,
      "relevanceScore: 0.98,
      "category: "technology
    },
    {
      "id: "perceptron,
      "title: "Perceptron,
      "relevanceScore: 0.95,
      "category: "history
    }
  ],
  "total: 142,
  "nextPage: "https://api.aevum.com/v1/search?page=2
}

Error Codes #

Aevum uses standard HTTP status codes to indicate the success or failure of a request. Codes in the 2xx range indicate success, 4xx indicate client errors, and 5xx indicate server errors.

Code Meaning
400 Bad Request – The request was malformed or missing required parameters.
401 Unauthorized – Missing or invalid API key.
403 Forbidden – The API key does not have permission to access this resource.
404 Not Found – The requested resource does not exist.
429 Too Many Requests – You have exceeded the rate limit.
500 Internal Server Error – Something went wrong on Aevum's end.