3.0 REST API Reference

🚀 Stable Release • GA • SDKs Available

The Aevum Encyclopedia 3.0 REST API provides comprehensive programmatic access to our verified knowledge base, AI-enhanced search, semantic knowledge graphs, and contributor infrastructure. Designed for researchers, educators, and developers, v3.0 introduces semantic routing, real-time event streaming, and expanded multilingual endpoints.

ℹ️

All API responses are formatted in JSON. Requests must include Content-Type: application/json and valid authentication headers.

Base URL

Production

https://api.aevum-encyclopedia.com/v3

Sandbox / Testing

https://sandbox.api.aevum-encyclopedia.com/v3

Authentication

Access the API using API Keys or OAuth 2.0 Bearer Tokens. API Keys are recommended for server-to-server communication, while OAuth is required for user-scoped operations (contributions, profiles, drafts).

curl • API Key

curl -X GET https://api.aevum-encyclopedia.com/v3/articles \
  -H "X-API-Key": "ae_live_8x92kLm4Pq7vRtYz..." \
  -H "Accept": "application/json"

curl • Bearer Token

curl -X GET https://api.aevum-encyclopedia.com/v3/user/profile \
  -H "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6..."

⚠️

Never expose API keys in client-side code. Use environment variables or secret management services.

Articles

Retrieve, create, and update encyclopedia entries. All article payloads support structured metadata, citation tracking, and version history.

GET /articles/{id} Retrieve a single article by ID or slug

Returns the full article payload including content, metadata, citations, and revision history.

Parameter	Type	Required	Description
id	string	Yes	Article UUID or URL-safe slug
include	string	No	Comma-separated: `citations,history,multimedia`
locale	string	No	ISO 639-1 code (e.g., `en`, `es`, `ja`)

Response • 200 OK

{
  "id": "art_8f4a2c1d9e0b",
  "slug": "quantum-computing",
  "title": "Quantum Computing",
  "locale": "en",
  "content": "Quantum computing leverages quantum mechanical phenomena...",
  "category": "Science",
  "verified": true,
  "last_updated": "2025-09-18T14:32:00Z",
  "version": 42
}

POST /articles Create a new article draft

Submits a new article for editorial review. Drafts are sandboxed until verified by domain experts.

Request Body

{
  "title": "CRISPR Gene Editing",
  "content": "CRISPR-Cas9 is a revolutionary gene-editing technology...",
  "category": "Biology",
  "locale": "en",
  "tags": ["genetics", "biotechnology"],
  "citations": [
    { "source": "Nature, 2023", "url": "https://..." }
  ]
}

Search & Discovery

AI-enhanced semantic search with faceted filtering, relevance scoring, and cross-lingual support.

GET /search Query the knowledge base

Parameter	Type	Required	Description
q	string	Yes	Search query (supports natural language)
page	integer	No	Pagination cursor (default: 1)
limit	integer	No	Results per page (max: 50)
categories	string[]	No	Filter by taxonomy
ai_insights	boolean	No	Include AI-generated summaries

Knowledge Graph

Explore semantic relationships, citation networks, and conceptual mappings across disciplines.

GET /graph/{entity_id}/connections Retrieve linked entities & relationships

Returns a directed graph payload containing nodes, edges, relationship types, and confidence scores.

Response • 200 OK

{
  "entity": "art_9c3e7f2a1b",
  "connections": [
    {
      "target": "art_4d8b2e9f0c",
      "relation": "extends_concept",
      "confidence": 0.94,
      "context": "Theoretical foundations shared"
    }
  ],
  "depth": 2,
  "generated_at": "2025-09-20T08:15:00Z"
}

Rate Limits

API requests are throttled to ensure platform stability and fair access. Limits are applied per API key.

Plan	Requests / min	Requests / day	Burst Allowance
Free / Community	60	10,000	10
Academic	300	100,000	50
Enterprise	2,000	Unlimited	100

Rate limit headers are included in every response:

Response Headers

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 247
X-RateLimit-Reset: 1726934400
Retry-After: 42 # (only on 429 responses)

Versioning

The API uses URL path versioning. Current stable version is v3. Deprecated versions receive 12 months of maintenance support before sunset. Breaking changes are never introduced in minor or patch releases.