API Documentation

Welcome to the Aevum Encyclopedia API. Access over 2.4M verified articles, interactive knowledge graphs, and multilingual content programmatically. Build educational tools, research assistants, or data pipelines with our RESTful endpoints.

💡 New in v2.4: Semantic search, real-time article updates, and GraphQL beta endpoints now available. Migrate your keys to the new dashboard for enhanced security.

Authentication

All API requests require authentication via API keys. Include your key in the Authorization header as a Bearer token.

HTTP Header

Authorization: Bearer YOUR_API_KEY

Key Types

Scope	Permissions	Rate Limit
`read_only`	Articles, Search, Metadata	1,000 req/min
`graph_access`	Knowledge Graph, Relationships	500 req/min
`editor`	Submit revisions, Drafts	100 req/min

Rate Limits

Requests are throttled based on your plan and endpoint type. Exceeding limits returns 429 Too Many Requests.

⚠️ Burst traffic may trigger temporary IP-level throttling. Implement exponential backoff in your retry logic.

Header	Description
`X-RateLimit-Limit`	Max requests per window
`X-RateLimit-Remaining`	Requests left in current window
`X-RateLimit-Reset`	Unix timestamp when quota resets

Base URL

Production

https://api.aevumencyclopedia.com/v2

Sandbox

https://sandbox-api.aevumencyclopedia.com/v2

Articles

Retrieve, filter, and manage encyclopedia entries.

GET /articles

Fetch a paginated list of articles with filtering options.

Query Parameters

Parameter	Type	Description
`q` optional	string	Full-text search query
`category` optional	string	Filter by category slug
`lang` optional	string	ISO 639-1 language code
`limit` optional	integer	Results per page (max 100)

Example Request

curl

curl "https://api.aevumencyclopedia.com/v2/articles?category=science&limit=5" \\
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON (200 OK)

{
  "data: [
    {
      "id: "art_8f3k29d",
      "title: "Quantum Computing",
      "slug: "quantum-computing",
      "category: "Science",
      "updated_at: "2025-03-14T09:22:00Z",
      "access_level: "public"
    }
  ],
  "meta: {
    "total: 14230,
    "page: 1,
    "limit: 5
  }
}

Search

Semantic search powered by vector embeddings. Returns ranked results with relevance scores.

POST /search/semantic

Request Body

{
  "query: "impact of climate change on marine ecosystems",
  "filters: {
    "min_relevance: 0.75,
    "languages: ["en, "fr]
  }
}

Knowledge Graph

Explore relationships between entities. Returns nodes and edges with confidence scores.

GET /graph/nodes/:slug

Retrieves connected concepts for a given article slug. Useful for generating visual relationship maps or recommendation engines.

Error Codes

Code	Meaning	Resolution
`400`	Bad Request	Check parameter format & required fields
`401`	Unauthorized	Verify API key validity & permissions
`403`	Forbidden	Key lacks scope for this endpoint
`404`	Not Found	Resource or slug does not exist
`429`	Rate Limited	Wait until `X-RateLimit-Reset`
`500`	Server Error	Internal failure. Retry or contact support

SDKs & Tools

Official client libraries and community tools for faster integration.

Python: pip install aevum-encyclopedia
JavaScript: npm install @aevum/api-client
Postman: Import Collection →
GraphQL Beta: Explore Schema →