Aevum News API Documentation
Comprehensive reference for integrating with Aevum News v2.4.1. Access real-time news feeds, search, categories, and subscription management.
Overview
The Aevum News API provides programmatic access to our global news network, delivering verified articles, breaking alerts, and categorized content through a RESTful interface. Version 2.4.1 introduces improved pagination, webhook reliability, and enhanced search filters.
https://api.aevumnews.com/v2
All responses are returned in JSON format. The API uses standard HTTP status codes and requires authentication via Bearer tokens for all endpoints except public health checks.
Installation
Use your preferred package manager to install the official SDK:
# npm npm install @aevum/news-sdk # yarn yarn add @aevum/news-sdk # pnpm pnpm add @aevum/news-sdk
Initialize the client in your application:
import { AevumClient } from '@aevum/news-sdk';
const aevum = new AevumClient({
apiKey: process.env.AEVUM_API_KEY,
region: 'us-east-1', // optional
retries: 3 // optional
});
Quick Start
Fetch the latest verified articles in under 10 lines of code:
const articles = await aevum.articles.list({
limit: 10,
sort: 'published_at:desc',
verified: true,
categories: ['world', 'technology']
});
console.log(articles.data);
// Returns array of article objects with metadata
Articles marked with verified: true have passed our multi-layer editorial review process. Unverified content may include breaking updates pending fact-checking.
Authentication
All authenticated requests require an API key passed via the Authorization header:
Authorization: Bearer aevum_live_sk_7f8d9c2e1a4b6x9z
Keys are scoped by environment. Never expose secret keys in client-side code. Use aevum_live_* for production and aevum_test_* for development.
Articles Endpoint
Retrieve a paginated list of news articles with optional filtering.
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | integer | 20 | Number of articles (max 100) |
offset | integer | 0 | Pagination cursor offset |
verified | boolean | false | Filter to only fact-checked articles |
author | string | - | Filter by journalist slug |
date_from | string | - | ISO 8601 start date |
Search & Filters
Full-text search across titles, summaries, and body content. Supports natural language queries and boolean operators.
GET /v2/search?q="climate summit" AND category:politics -lang:cn&sort=relevance
Results include a _score field indicating relevance ranking. Use facet=true to retrieve category and author distributions.
Rate Limits
To ensure platform stability, API access is governed by tiered rate limits:
| Plan | Requests/min | Burst | Webhook Events |
|---|---|---|---|
| Free | 60 | 10 | Disabled |
| Pro | 600 | 50 | 1,000/day |
| Enterprise | 6,000 | 200 | Unlimited |
Exceeding limits returns 429 Too Many Requests. Response headers include X-RateLimit-Remaining and X-RateLimit-Reset.
v2.4.1 Changelog
Released: November 2024
✅ Fixed pagination edge case with offset > 10000 ✅ Added `verified` filter to /v2/articles ✅ Improved webhook retry logic (exponential backoff) ✅ Deprecated `?page=` in favor of `?offset=` & `?limit=` 🔒 Security: Enforced TLS 1.2+ for all endpoints 📦 SDK: Added TypeScript strict mode support ⚡ Performance: Reduced average response time by ~40ms
Migration from v2.3.x is backward compatible. Review the deprecation notice for pagination parameters before upgrading.