🔹 Production Ready

API Documentation

Integrate Aevum News' authoritative journalism data into your applications. Access real-time breaking news, curated feeds, and historical archives via our RESTful API.

🌐 Base URL

All API requests should be made to:

Base URL

https://api.aevumnews.com/v1

The API follows standard REST conventions. All endpoints return JSON responses and accept JSON request bodies.

🔐 Authentication

Aevum News API uses Bearer token authentication. Include your API key in the Authorization header of every request:

cURL

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

Keys can be generated from the Developer Dashboard. Rotate keys periodically and never expose them client-side.

📊 Rate Limiting

To ensure platform stability, requests are throttled per key:

Plan	Requests / Hour	Burst Limit
Free	1,000	10/min
Professional	100,000	100/min
Enterprise	Unlimited	Custom

Exceeding limits returns 429 Too Many Requests. Use the X-RateLimit-Remaining header to track usage.

⚠️ Error Handling

The API uses conventional HTTP status codes and returns structured error objects:

Response

{
  "error": {
    "code": "invalid_request",
    "message": "Missing required field: category",
    "details": { "field": "category" }
  }
}

400

Bad Request – Malformed syntax or missing params

401

Unauthorized – Invalid or expired API key

403

Forbidden – Insufficient permissions

404

Not Found – Resource does not exist

429

Rate Limited – Too many requests

500

Server Error – Internal platform issue

📰 News Feed

GET /news

Retrieve the latest curated news articles with pagination and filtering.

Query Parameters

Parameter	Type	Description
page optional	integer	Page number (default: 1)
limit optional	integer	Results per page (max: 50, default: 20)
category optional	string	Filter by slug (e.g., `technology`)
from_date optional	date	ISO 8601 date for earliest article
trending optional	boolean	Only return trending stories

Response

JSON

{
  "data": [
    {
      "id": "aev_8f3k2m9x",
      "title": "Global Climate Accord Reaches Final Stage",
      "summary": "Negotiators finalize emission targets...",
      "category": "world",
      "published_at": "2025-04-12T09:30:00Z",
      "source": "Aevum Correspondents",
      "url": "https://www.aevumnews.com/article/8f3k2m9x"
    }
  ],
  "pagination": { "page": 1, "total_pages": 42, "total_results": 830 }
}

🔍 Search

POST /search

Perform full-text, faceted search across the Aevum archive and live feed.

Request Body

JSON

{
  "query": "AI regulation European Union",
  "language": "en",
  "date_range": "month",
  "sort_by": "relevance"
}

📂 Categories

GET /categories

List all available news categories and metadata.

📄 Single Article

GET /news/{id}

Retrieve full article content, author metadata, and related links.

🔔 Webhooks

Subscribe to real-time event notifications via HTTPS callbacks. Supported events:

article.published – New story matching your filters
breaking.alert – High-priority breaking news drops
category.update – Metadata or routing changes

Configure endpoints in the Dashboard. Payloads include article metadata and signature verification headers.

📦 SDKs & Libraries

Official client libraries maintain type safety, automatic retries, and auth management:

Language	Package	Version
JavaScript/Node.js	`@aevum/api-client`	2.1.0
Python	`aevum-news`	1.4.2
Ruby	`gem aevum`	0.9.1
Go	`github.com/aevum/go-sdk`	1.0.3