Aevum News API

Access real-time news data, search archives, and integrate editorial content into your applications. Build powerful, informed experiences with our RESTful API.

Getting Started

The Aevum News API uses standard HTTP methods and returns JSON responses. All requests must be made over HTTPS. Calls made over plain HTTP will fail.

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

Authentication

Authenticate your requests using API keys in the Authorization header:

curl https://api.aevumnews.com/v1/articles \\
  -H "Authorization: Bearer your_api_key_here" \\
  -H "Content-Type: application/json"
const response = await fetch("https://api.aevumnews.com/v1/articles", {
  headers: {
    "Authorization": `Bearer ${yourApiKey}`,
    "Content-Type": "application/json"
  }
});
import requests

response = requests.get(
    "https://api.aevumnews.com/v1/articles",
    headers={"Authorization": f"Bearer {your_api_key}"}
)

Articles

GET /v1/articles

Retrieve a paginated list of published articles. Supports filtering by category, date, and source type.

Query Parameters

Parameter	Type	Description
categoryoptional	string	Filter by category ID or slug (e.g., `tech`, `world`)
limitoptional	integer	Number of results (default: 20, max: 100)
afteroptional	string	Cursor for pagination. Use `next_cursor` from previous response
sort_byoptional	string	`published_at`, `relevance`, or `popularity`

Response Example

{
  "data": [
    {
      "id": "art_9f8s7d6f5g4h3j2k",
      "title": "Global Climate Summit Reaches Historic Accord",
      "summary": "190 nations agree to binding emissions targets...",
      "category": "world",
      "published_at": "2025-03-14T08:30:00Z",
      "url": "https://aevumnews.com/articles/9f8s7d6f5g4h3j2k"
    }
  ],
  "pagination": {
    "next_cursor": "eyJpZCI6MTIzfQ==",
    "has_more": true
  }
}
curl "https://api.aevumnews.com/v1/articles?category=tech&limit=5" \\
  -H "Authorization: Bearer sk_live_..."

Rate Limits & Usage

To ensure fair access and service stability, API requests are rate-limited based on your subscription tier.

Tier	Requests / Minute	Requests / Day
Free	30	1,000
Pro	150	50,000
Enterprise	Custom	Unlimited

⚠️ Exceeding rate limits returns 429 Too Many Requests. Monitor your usage via the X-RateLimit-Remaining header.

Official SDKs

Speed up development with our officially maintained client libraries. All SDKs handle authentication, retries, and type definitions automatically.

Node.js / JavaScript

npm install @aevum/news-sdk

Python

pip install aevum-news

go get github.com/aevum/news-go

Ruby

gem install aevum-news