Aevum News API

Access real-time, verified news data through a modern, RESTful interface. Built for developers, publishers, and AI systems.

https://api.aevumnews.com/v1

Authentication

All requests require an API key passed via the Authorization header:

Authorization: Bearer YOUR_API_KEY

Sign up at the developer portal to generate your key. Keys are scoped per project and support environment isolation (prod, staging).

GET /v1/articles List Articles

Retrieve a paginated list of published articles. Supports filtering by category, date range, and source.

Parameter	Type	Description
page	integer	Page number (default: 1)
limit	integer	Results per page (max: 100)
category	string	Filter by category slug
from_date	string	ISO 8601 start date

GET /v1/articles?page=1&limit=20&category=world HTTP/1.1
Host: api.aevumnews.com
Authorization: Bearer sk_live_...x9Y2

Waiting for request...

POST /v1/search Full-Text Search

Search across titles, summaries, and full article text. Supports advanced operators and relevance boosting.

Parameter	Type	Required	Description
query	string	Yes	Search keywords or phrase
min_relevance	float		Minimum score threshold (0-1)
boost_recent	boolean		Prioritize articles < 24h old

{
  "query": "quantum computing breakthrough",
  "min_relevance": 0.75,
  "boost_recent": true
}

API access is structured by subscription tier. Exceeding limits returns 429 Too Many Requests with a Retry-After header.

100

Requests / minute (Free)

1,000

Requests / minute (Pro)

10,000

Requests / minute (Enterprise)

5MB

Max Payload Size

Aevum uses standard HTTP status codes. Errors return a consistent JSON structure:

{
  "error": {
    "code": "INVALID_AUTH",
    "message": "API key expired or malformed",
    "request_id": "req_7x92kL1p"
  }
}