Docs â€ē Getting Started â€ē Quick Start

Quick Start Guide

Learn how to integrate the Aevum Encyclopedia API into your application in under 5 minutes.

Introduction

The Aevum Encyclopedia API provides programmatic access to our verified, multilingual knowledge base. Whether you're building a research assistant, educational platform, or data pipeline, our RESTful interface delivers structured, citation-ready content with millisecond latency.

ℹī¸ Note

API v2.4 includes breaking changes to pagination and entity linking. See the Migration Guide for details.

Prerequisites

Installation

Install the official SDK via your preferred package manager:

# npm
npm install @aevum/enc-sdk

# pip
pip install aevum-enc

Or use direct HTTP calls if you prefer not to install dependencies.

Authentication

All requests must include your API key in the Authorization header. Keys never expire unless revoked manually.

curl -X GET https://api.aevum.dev/v2/articles/quantum-mechanics \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
⚠ī¸ Security Warning

Never expose your API key in client-side code or public repositories. Use environment variables or a proxy server.

Core Endpoints

The API exposes four primary resource types:

Endpoint Description Rate Limit
GET /v2/articles/{id} Retrieve a full article with citations 100 req/min
GET /v2/search Semantic search across knowledge graph 60 req/min
GET /v2/entities/{slug} Resolve named entities & relationships 150 req/min
POST /v2/verify Fact-check a statement against sources 20 req/min

Response Format

All responses follow a consistent envelope structure:

{
  "status": "success",
  "data": { ... },
  "meta": {
    "request_id": "req_8f3a2c1d",
    "latency_ms": 42,
    "cache": "hit"
  }
}

Error responses use standard HTTP status codes and include a machine-readable error.code field.

Next Steps