RSS & API Documentation

Authentication

All API requests require a valid API key passed in the Authorization header. Generate your key from the Developer Dashboard.

HTTP Header

Authorization: Bearer YOUR_API_KEY_HERE

Note: Keys are scoped by environment. Use test_ prefixes for development and live_ for production. Never expose keys in client-side code. Server-side proxy recommended.

REST API

Available Endpoints

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

GET /articles

Retrieve paginated list of articles. Supports filtering by category, date range, and search query.

Request

GET https://api.aevumnews.com/v1/articles?
category=world&
limit=20&
offset=0&
sort=published_at:desc

GET /articles/{id}

Fetch full article content, metadata, author details, and related tags.

Response (JSON)

{
  "id": "art_8f3k29a",
  "title": "Global Climate Summit Reaches Historic Agreement",
  "category": "world",
  "published_at": "2025-01-15T09:30:00Z",
  "author": { "name": "Elena Rodriguez" },
  "content_html": "<p>Full article content...</p>",
  "tags": ["climate", "policy", "summit"]
}

GET /search

Full-text search across all published content. Supports boolean operators and field filtering.

Parameters

q: "query string" (required)
type: "article" | "author" | "topic" (default: article)
page: 1 (pagination)
per_page: 20 (max: 50)

Feeds

RSS & Atom Streams

Subscribe to real-time updates via standardized XML feeds. No authentication required for public feeds.

All Stories Complete feed, updated continuously

World Affairs Geopolitics & international coverage

Technology AI, startups, digital trends

Business Markets, finance, economy

Science & Climate Research, environment, health

Atom Format Standard Atom 1.0 feed

Integrations

Code Examples

Quickly integrate Aevum News into your stack with these ready-to-use snippets.

fetch API

// Fetch latest world articles
const response = await fetch('https://api.aevumnews.com/v1/articles', {
  headers: {
    'Authorization': `Bearer ${API_KEY}`,
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data.articles);

requests

import requests

url = "https://api.aevumnews.com/v1/search"
headers = {
    "Authorization": f"Bearer {API_KEY}"
}
params = {
    "q": "artificial intelligence",
    "type": "article",
    "per_page": 10
}

response = requests.get(url, headers=headers, params=params)
data = response.json()
for article in data["results"]:
    print(article["title"])

terminal

curl -X GET "https://api.aevumnews.com/v1/articles?category=tech&limit=5" \

Node.js (rss-parser)

const Parser = require('rss-parser');
const parser = new Parser();

async function fetchFeed() {
  const feed = await parser.parseURL('https://feeds.aevumnews.com/rss/world.xml');
  console.log(`Loaded ${feed.items.length} articles`);
  feed.items.forEach(item => {
    console.log(item.title, item.link);
  });
}

fetchFeed();

Limits & Policies

Rate Limits & Status Codes

Transparent usage tiers and error handling standards.

Plan	Requests / Minute	Requests / Day	Support
Free	30	1,000	Community
Pro	300	50,000	Priority Email
Enterprise	Custom	Unlimited	24/7 Dedicated

Common Status Codes

200 OK — Request successful
401 Unauthorized — Invalid or missing API key
403 Forbidden — Insufficient permissions
429 Too Many Requests — Rate limit exceeded (retry after Retry-After header)
500 Internal Server Error — Service temporarily unavailable