🔌 Developer API

Access Aevum News Data

Integrate real-time news data into your applications with our powerful REST API. Fetch articles, topics, and breaking news with just a few lines of code.

API Documentation → ↓ Download SDKs
cURL
curl https://api.aevumnews.com/v1/articles \ -H "Authorization: Bearer \u003cYOUR_API_KEY\u003e" \ -H "Content-Type: application/json" # Response {
"status": "success",
"data": {
"total": 2847,
"articles": [...]
}
}

Overview

The Aevum News API provides programmatic access to our global news database. Built on a RESTful architecture, it delivers real-time articles, topics, and breaking news with consistent JSON responses.

Base URL

Endpoint 
https://api.aevumnews.com/v1

Response Format

All API responses are returned in JSON format with appropriate HTTP status codes. Each response includes a status field and a data object containing the requested information.

ℹī¸
Versioning The API version is included in the base URL path (e.g., /v1/). We maintain backward compatibility within major versions and will provide migration guides for major version updates.

Authentication

All API requests require authentication via a Bearer token. Obtain your API key from the Developer Dashboard.

Authorization Header 
Authorization: Bearer YOUR_API_KEY_HERE
💡
Tip: API Key Security Never expose your API key in client-side code or public repositories. Use environment variables and server-side proxying for any frontend applications.

Rate Limits

API requests are rate-limited based on your subscription tier. Exceeded limits return a 429 Too Many Requests status.

Response Headers (per request) 
X-RateLimit-Limit: 1000

X-RateLimit-Remaining: 997

X-RateLimit-Reset: 1719847200

Retry-After: 45 # Only on 429 responses

Error Handling

The API uses standard HTTP status codes and returns detailed error objects in the response body.

Error Response Body 
{
  "status": "error",
  "code": "VALIDATION_ERROR",
  "message": "Invalid parameter: 'page' must be a positive integer",
  "details": {
    "field": "page",
    "received": "expected": "integer > 0"
  }
}

Status Codes

200OK — Request succeeded 201Created — Resource created 400Bad Request — Invalid parameters 401Unauthorized — Missing/invalid API key 403Forbidden — Insufficient permissions 404Not Found — Resource does not exist 429Too Many Requests — Rate limit exceeded 500Internal Server Error 503Service Unavailable

📰 Articles

Retrieve individual articles or lists of articles from our global news database.

GET /articles List all articles

Retrieve a paginated list of articles. Supports filtering by topic, date range, language, and source.

Query Parameters

Parameter Type Required Description
page integer Optional Page number (default: 1)
limit integer Optional Items per page (default: 20, max: 100)
topic string Optional Filter by topic slug (e.g., "technology")
language string Optional ISO 639-1 language code (default: "en")
published_after ISO 8601 Optional Start date filter (e.g., "2025-01-01T00:00:00Z")
published_before ISO 8601 Optional End date filter
source string Optional Filter by news source slug
sort string Optional Sort by: "published_at", "popularity", "relevance" (default: "published_at")

Response Example

HTTP 200 Response 
{
  "status": "success",
  "data": {
    "total": 2847,
    "page": 1,
    "limit": 20,
    "pages": 143,
    "articles": [
      {
        "id": "aev_20250703_001",
        "title": "Global Summit Reaches Historic Climate Accord",
        "summary": "World leaders agree on binding emissions targets...",
        "url": "https://aevumnews.com/world/summit-climate-accord",
        "topic": "world",
        "language": "en",
        "author": "Elena Rodriguez",
        "source": "aevum-correspondents",
        "published_at": "2025-07-03T08:30:00Z",
        "updated_at": "2025-07-03T09:15:00Z",
        "image_url": "https://cdn.aevumnews.com/img/summit-2025.jpg",
        "read_time_min": 8,
        "popularity_score": 94.7
      }
    ]
  }
}
GET /articles/:id Get single article

Retrieve full content of a specific article by its unique ID.

Path Parameters

Parameter Type Required Description
id string Required Article ID (e.g., "aev_20250703_001")

🏷ī¸ Topics

Access categorized news topics and their metadata.

GET /topics List all topics

Retrieve a list of all available news topics with article counts and descriptions.

Response Example

HTTP 200 Response 
{
  "status": "success",
  "data": {
    "topics": [
      {
        "slug": "world",
        "name": "World Affairs",
        "description": "Geopolitics, diplomacy, and global events",
        "article_count": 2400,
        "icon": "🌍"
      },
      {
        "slug": "technology",
        "name": "Technology",
        "description": "Innovation, startups, and digital transformation",
        "article_count": 1800,
        "icon": "đŸ’ģ"
      }
    ]
  }
}

⚡ Breaking News

Access real-time breaking news as it happens.

GET /breaking Get breaking news

Retrieve the latest breaking news stories. Results are updated in real-time as events develop. For live updates, use the WebSocket endpoint wss://api.aevumnews.com/v1/breaking/ws.

⚠ī¸
Real-Time Note Breaking news endpoints return data cached at most 30 seconds ago. For true real-time streaming, use our WebSocket integration (WebSocket tier required).

Response Example

HTTP 200 Response 
{
  "status": "success",
  "data": {
    "updated_at": "2025-07-03T14:22:00Z",
    "breaking_news": [
      {
        "id": "bn_20250703_042",
        "headline": "Major development in Pacific trade negotiations",
        "severity": "high",
        "region": "asia-pacific",
        "published_at": "2025-07-03T14:20:00Z",
        "url": "https://aevumnews.com/world/pacific-trade"
      }
    ]
  }
}

📡 Sources

Access our network of contributing news sources and correspondents.

GET /sources List all sources

Retrieve a list of all news sources, including their coverage areas, languages, and credibility ratings.

SDKs & Libraries

Official SDKs and community libraries for rapid integration.

Python SDK 
# pip install aevum-news-sdk
from aevum_news import AevumClient

client = AevumClient(api_key="your_api_key")

# Get latest articles
articles = client.articles.list(
    topic="technology",
    limit=10,
    sort="popularity"
)

for article in articles:
    print(f"{article.title} — {article.url}")

# Search
results = client.search.query(
    q="climate summit 2025",
    date_range="7d"
)
JavaScript SDK 
// npm install @aevum/news-sdk
import { AevumClient } from '@aevum/news-sdk';

const client = new AevumClient('your_api_key');

// Get breaking news
const breaking = await client.breaking.fetch();
console.log(breaking.headlines);

// Subscribe to WebSocket
const ws = client.subscribe('breaking');
ws.on('news', (article) => {
  console.log(`🔴 ${article.headline}`);
});
đŸ“Ļ
Available SDKs Official: Python, JavaScript/TypeScript, Go, Ruby
Community: Rust, PHP, Swift, Kotlin, .NET
All SDKs are open-source on GitHub. Contribute: github.com/aevum/news-sdk

Webhooks

Receive real-time notifications when specific events occur.

Webhook Payload 
{
  "event": "breaking_news.published",
  "timestamp": "2025-07-03T14:22:00Z",
  "data": {
    "id": "bn_20250703_042",
    "headline": "Major development in Pacific trade negotiations",
    "severity": "high",
    "url": "https://aevumnews.com/world/pacific-trade"
  },
  "signature": "sha256=a1b2c3d4e5f6..."
}
🔐
Webhook Verification Always verify webhook signatures using your webhook secret key. The signature header contains an HMAC-SHA256 hash of the payload, signed with your secret.

Pricing

Choose the plan that fits your needs. All plans include a free tier for testing.

Free
For prototyping and testing
$0/mo
Free forever
  • 100 requests / day
  • Articles & Topics API
  • Standard response time
  • Community support
  • 1 webhook endpoint
Start Free
Pro
For applications at scale
$49/mo
Billed monthly
  • 50,000 requests / month
  • All API endpoints
  • Priority response time
  • Webhook & WebSocket
  • Full-text search
  • Email support
Get Started
Enterprise
Custom solutions
Custom
Contact us for pricing
  • Unlimited requests
  • Dedicated infrastructure
  • Custom webhook routing
  • SLA guarantee (99.99%)
  • Dedicated account manager
  • On-premise deployment
Contact Sales

FAQ

Common questions about the Aevum News API.

How do I get an API key? +

Sign up for a free account at our Developer Dashboard. Your API key will be generated immediately upon registration. You can also create multiple keys for different environments (development, staging, production).

What is the latency for API responses? +

Average response time is under 150ms for Free tier and under 50ms for Pro/Enterprise tiers. Our global CDN ensures low-latency access from any region. Enterprise customers get dedicated infrastructure with guaranteed sub-30ms latency.

Can I use the API for commercial applications? +

Yes! The Pro and Enterprise plans include full commercial usage rights. You may redistribute article data within your application subject to our Terms of Service. Reselling raw article content is not permitted — content must be transformed or integrated meaningfully.

How often is the news data updated? +

Our articles database is updated in near real-time — typically within 60 seconds of publication on our editorial platforms. Breaking news items are available within 15 seconds of being filed by our correspondents. The WebSocket API provides truly instantaneous notifications.

Do you offer data export or bulk access? +

Enterprise customers can request bulk data exports via SFTP or cloud storage (AWS S3, Google Cloud Storage). We provide historical data back to 2020. Contact our sales team for custom data solutions and pricing.

Ready to Integrate?

Start building with the Aevum News API today. Get your free API key and access 25,000+ articles across 120+ countries.

Get API Key → View GitHub Examples