Aevum News API

v1.2.0

Overview

The Aevum News API provides programmatic access to our global news database, allowing developers to fetch verified articles, search by topic, and access real-time updates. All endpoints return JSON responses and support standard HTTP methods.

https://api.aevumnews.com/v1

For support or API key requests, contact api-support@aevumnews.com.

Authentication

Access to the Aevum News API requires a valid API key. Include your key in the request header as a Bearer token. Keys can be generated from your developer dashboard.

curl -X GET "https://api.aevumnews.com/v1/articles" \n  -H "Authorization: Bearer YOUR_API_KEY" \n  -H "Content-Type: application/json"

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

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

Rate Limits

API requests are limited based on your subscription tier. Exceeding limits will result in a 429 Too Many Requests response.

Free100 requests / hour

Pro5,000 requests / hour

EnterpriseCustom limits & dedicated support

List Articles

GET /articles Fetch paginated list of latest articles

Query Parameters

Parameter	Type	Required	Description
page	integer	Optional	Page number (default: 1)
limit	integer	Optional	Items per page (max: 100)
category	string	Optional	Filter by category (world, tech, business)

Example Request

curl -X GET "https://api.aevumnews.com/v1/articles?limit=10&category=tech" \n  -H "Authorization: Bearer YOUR_API_KEY"

response = requests.get(
    "https://api.aevumnews.com/v1/articles?limit=10&category=tech",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

Example Response

{
  "status": "success",
  "data": [
    {
      "id": "art_8x92k",
      "title": "AI Revolution: New Language Models Redefine Interaction",
      "category": "technology",
      "published_at": "2025-04-10T14:30:00Z",
      "url": "https://aevumnews.com/articles/ai-revolution-2025"
    }
  ],
  "pagination": { "page": 1, "limit": 10, "total": 1450 }
}

Article Detail

GET /articles/:id Get full article content and metadata

Replace :id with the article identifier returned from the list endpoint. Returns complete article body, author details, and related tags.

Search

POST /search Advanced full-text search across articles

Request Body

Parameter	Type	Required	Description
query	string	Required	Search keywords or phrases
date_from	string (date)	Optional	Start date filter (YYYY-MM-DD)
date_to	string (date)	Optional	End date filter (YYYY-MM-DD)

Error Codes

The API uses standard HTTP status codes to indicate success or failure.

200OK - Request succeeded

400Bad Request - Invalid parameters or malformed JSON

401Unauthorized - Missing or invalid API key

429Rate Limited - Too many requests. Retry after 60s.

500Internal Error - Aevum News server issue

SDKs & Tools

Official client libraries are available for Python, JavaScript/Node.js, and Go. Community-maintained wrappers exist for PHP, Ruby, and Java.

# Python SDK
pip install aevum-news-api

# Node.js SDK
npm install @aevumnews/api-client

# Go SDK
go get github.com/aevumnews/go-sdk