API Documentation

Programmatic access to 2.4M+ verified articles, knowledge graphs, and semantic search across 140+ languages.

ℹ️

All endpoints are hosted under the base URL: https://api.aevum-encyclopedia.com/v1. We use standard HTTP semantics, JSON request/response bodies, and return appropriate status codes.

Request Format

HTTP Request

GET /v1/articles/search?q=quantum+computing&lang=en HTTP/1.1
Host: api.aevum-encyclopedia.com
X-API-Key: ak_live_8f3k29d...
Accept: application/json
Content-Type: application/json

Authentication

Aevum uses API keys to authenticate requests. You can manage your keys in the Developer Dashboard.

Include your API key in the X-API-Key header for every request. Keys are scoped to either read-only or read-write access.

JavaScript

const response = await fetch('https://api.aevum-encyclopedia.com/v1/articles', {
  headers: {
    'X-API-Key': 'ak_live_your_key_here',
    'Content-Type': 'application/json'
  }
});

⚠️

Never expose your live API keys in client-side code or public repositories. Use environment variables and proxy requests through your backend.

Articles

Retrieve, filter, and explore encyclopedia articles. Supports metadata extraction, revision history, and cross-lingual links.

GET /v1/articles/{id}

Fetch a specific article by its unique identifier or slug.

Parameter	Type	Description
`id`required	string	Article UUID or normalized slug
`fields`optional	string	Comma-separated list of fields to return (title, body, summary, metadata)
`lang`optional	string	ISO 639-1 language code. Defaults to `en`

Response (200 OK)

{
  "id": "ae_qc_99284",
  "title": "Quantum Computing",
  "summary": "Quantum computing is a type of computation whose operations can exploit...",
  "language": "en",
  "last_updated": "2025-03-14T08:32:00Z",
  "verified": true,
  "read_time_min": 12
}

GET /v1/articles

List articles with filtering, sorting, and pagination. Returns up to 50 results per page.

Parameter	Type	Description
`category`optional	string	Filter by top-level category (science, history, arts, etc.)
`updated_after`optional	string	ISO 8601 date. Returns articles modified after this timestamp
`sort`optional	string	Sort by `relevance`, `updated`, or `alpha`

Semantic Search

Our AI-powered search understands context, intent, and cross-domain relationships. Returns ranked results with confidence scores.

POST /v1/search

Execute a semantic query across the entire knowledge base.

Request Body

{
  "query": "economic impacts of the renaissance on trade",
  "filters": {
    "languages": ["en", "fr"],
    "verified_only": true
  },
  "limit": 10,
  "include_graph": true
}

Rate Limits

API requests are limited to ensure fair usage and system stability. Limits are applied per API key.

Free 100 req/min, 10K req/day

Pro 1,000 req/min, Unlimited

Enterprise Custom limits & dedicated infrastructure

Current usage and reset windows are returned in response headers:

Response Headers

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 842
X-RateLimit-Reset: 1715638400
X-Request-ID: req_8f2a9c...

Error Handling

Aevum uses standard HTTP status codes and returns detailed error objects in JSON format.

200 Success

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

429 Rate Limited

500 Server Error

Error Response (400 Bad Request)

{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "The 'limit' parameter must be between 1 and 100.",
    "details": {
      "field": "limit",
      "value": 0
    },
    "request_id": "req_3x9k2m..."
  }
}