Home / Documentation / Export API

Export API

Programmatically export verified encyclopedia content, knowledge graphs, and structured datasets in multiple formats.

ℹ️

All export requests return structured data. Format negotiation is handled via the Accept header or query parameters.

Base URL: https://api.aevumenc.com/v1

Authentication

Authenticate all requests using Bearer tokens in the Authorization header. Tokens can be generated from your developer dashboard.

cURL

curl "https://api.aevumenc.com/v1/export/articles?category=physics" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Accept: application/json"

Article Export

GET /export/articles

Retrieve structured article data including metadata, revisions, citations, and multilingual versions.

Query Parameters

Parameter	Type	Required	Description
category	string	Optional	Filter by top-level discipline (e.g., physics, history, biology)
format	string	Optional	Output format: `json`, `csv`, `xml`, `markdown`
lang	string	Optional	ISO 639-1 language code. Defaults to `en`
limit	integer	Optional	Max results per request (1–500). Default: 50

Response Example

                    JSON
                    
                
{
  "status": "success",
  "data": [
    {
      "id": "ae_phys_quantum_0492",
      "title": "Quantum Entanglement",
      "category": "Physics",
      "last_updated": "2025-09-12T14:30:00Z",
      "word_count": 3842,
      "languages": ["en", "es", "fr", "de", "ja"],
      "citation_count": 147,
      "url": "https://aevumenc.com/articles/quantum-entanglement"
    }
  ],
  "pagination": {
    "total": 2481,
    "page": 1,
    "next_cursor": "eyJpZCI6MTIzfQ=="
  }
}

Knowledge Graph Export

GET /export/graph

Export semantic relationships, ontology mappings, and cross-domain connections as graph-structured data.

⚠️

Graph exports can be large. Use ?format=dot or ?format=cypher for visualization pipelines.

Rate Limits & Quotas

Plan	Requests/Hour	Burst Limit	Max Export Size	Commercial Use
Free	100	10	5 MB	No
Pro	2,000	50	200 MB	Yes
Enterprise	Unlimited	Custom	Full Dumps	Yes

Exceeding limits returns 429 Too Many Requests with a Retry-After header.

SDK Examples

Python

import requests

API_KEY = "your_api_key_here"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

response = requests.get(
    "https://api.aevumenc.com/v1/export/articles",
    headers=HEADERS,
    params={"category": "history", "format": "json", "limit": 100}
)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}")

JavaScript / Node.js

JavaScript

const apiKey = 'your_api_key_here';

const exportArticles = async () => {
  try {
    const res = await fetch(
      'https://api.aevumenc.com/v1/export/articles?category=bio&format=json',
      { headers: { 'Authorization': `Bearer ${apiKey}` } }
    );
    const data = await res.json();
    console.log(data);
  } catch (err) {
    console.error('Export failed:', err);
  }
};

exportArticles();

Response Codes

Code	Meaning	Action
200	Success	Data returned
400	Bad Request	Check parameters
401	Unauthorized	Verify API key
403	Forbidden	Check permissions/plan
429	Too Many Requests	Wait per Retry-After header
500	Server Error	Temporary, retry later

Last updated: November 2025 · API Version: v1.4.2

Need help? · System Status