Aevum News Data API

Quick Start

Authenticate your requests and make your first API call in under 60 seconds.

🔑 Authentication

All endpoints require a valid API key passed in the Authorization header using Bearer token format.

Header

Authorization: Bearer YOUR_API_KEY

Base URL

https://api.aevumnews.com/v2

🚀 First Request

Fetch the latest trending articles worldwide with a single GET request.

cURL

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

Python

import requests

resp = requests.get( "https://api.aevumnews.com/v2/trending", headers={"Authorization": "Bearer YOUR_API_KEY"} )
print(resp.json())

API Endpoints

Explore our core data endpoints. Each includes parameters, authentication requirements, and response schemas.

GET /articles

Retrieve a paginated list of news articles with filtering, sorting, and metadata.

Parameter	Type	Required	Description
`category`	string	Optional	Filter by category slug (e.g., 'tech', 'politics')
`limit`	integer	Optional	Results per page (default: 20, max: 100)
`offset`	integer	Optional	Pagination offset
`published_after`	ISO8601	Optional	Filter articles published after this timestamp

Response (200 OK)

{ "status": "success", "data": { "articles": [ { "id": "art_98273", "title": "Global Climate Accord Reaches Historic Milestone", "slug": "/world/climate-accord-milestone", "category": "world", "published_at": "2025-11-15T14:30:00Z", "read_time_min": 6, "sentiment": "neutral" } ], "pagination": { "total": 14820, "limit": 20, "offset": 0 } }

GET /search

Full-text search across articles, headlines, and metadata with relevance scoring.

Parameter	Type	Required	Description
`q`	string	Required	Search query string
`sources`	array	Optional	Comma-separated list of source slugs
`sort`	string	Optional	Sort by: 'relevance', 'date', 'popularity'

Example Request

GET /search?q=quantum+computing&sort=relevance&limit=10

GET /categories

Fetch available news categories, subcategories, and metadata for filtering.

Response (200 OK)

{ "status": "success", "data": [ { "id": "cat_tech", "name": "Technology", "slug": "tech" }, { "id": "cat_world", "name": "World Affairs", "slug": "world" }, { "id": "cat_biz", "name": "Business & Finance", "slug": "business" } ]

POST /webhooks

Request Body

{ "url": "https://your-app.com/api/aevum-hook", "events": ["article.published", "category.updated"], "secret": "whsec_your_verification_secret"

Rate Limits & Tiers

Scalable pricing designed for startups, developers, and enterprise news aggregators.

Developer

Free forever. Perfect for prototyping.

1,000 requests / month
5 req / minute
Core endpoints access
Community support

Professional

$49

For apps & small-scale production.

50,000 requests / month
60 req / minute
Full API + Search
Webhooks & Analytics
Email support

Enterprise

Custom

Dedicated infrastructure & SLA.

Unlimited requests
Dedicated endpoints
On-premise deployment
24/7 priority support
Custom data pipelines

Official SDKs & Tools

Integrate faster with our maintained client libraries and CLI tools.

🐍 Python

pip install aevum-news

🟢 Node.js

npm install @aevumnews/sdk

🐹 Go

go get github.com/aevumnews/go

⌨️ CLI

Terminal-first data extraction