📡 API Endpoints
Access Aevum News' global content infrastructure programmatically. All endpoints return JSON and support CORS. Base URL is required for all requests.
Production Base URL
https://api.aevumnews.com/v1
Sandbox Base URL
https://sandbox.api.aevumnews.com/v1
Content Type
application/json
Default Format
JSON
🔐 Authentication
All API requests require authentication via Bearer token. Include your API key in the request header.
Header
Authorization: Bearer sk_live_your_api_key_here
Token Types
sk_live_ — Production (read/write)sk_test_ — Sandbox (read-only)rk_ — Restricted key (custom scopes)
📰 Articles
Retrieve, create, and manage news articles published across Aevum News' global network.
GET
/articles
Retrieve a paginated list of published articles. Supports filtering, sorting, and pagination.
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | No | Page number (default: 1) |
limit | integer | No | Items per page (1-100, default: 20) |
category_id | string | No | Filter by category slug |
sort | string | No | published_at, popularity, relevance |
Response (200 OK)
{
"data": [
{
"id": "art_9x8d7f6g5h",
"title": "Global Climate Summit Reaches Historic Accord",
"slug": "climate-summit-2025",
"category": "world",
"published_at": "2025-04-12T09:30:00Z",
"read_time": 8,
"status": "published"
}
],
"meta": {
"total": 14820,
"page": 1,
"per_page": 20
}
}
200 OK
401 Unauthorized
429 Rate Limited
GET
/articles/:id
Fetch a single article by its unique identifier or slug. Returns full content, metadata, and related articles.
| Parameter | Type | Required | Description |
|---|---|---|---|
:id | string | Yes | Article ID or URL slug |
include | array | No | author, related, comments |
Request
GET /v1/articles/art_9x8d7f6g5h?include=author,related
200 OK
404 Not Found
500 Server Error
POST
/articles
Submit a new article draft or publish directly. Requires elevated permissions (`articles:write`).
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Article headline (max 120 chars) |
slug | string | No | URL-friendly identifier (auto-generated if omitted) |
content | string | Yes | HTML or Markdown body |
category_id | string | Yes | Target category slug |
publish_at | datetime | No | ISO 8601 schedule timestamp |
Request Body
{
"title": "Market Analysis: Q2 2025 Outlook",
"content": "
Economic indicators suggest...
", "category_id": "business", "status": "draft" }
201 Created
400 Bad Request
403 Forbidden
🏷️ Categories
Browse and filter content by editorial category.
GET
/categories
Return all active content categories with metadata and article counts.
Response (200 OK)
[
{
"id": "cat_world",
"slug": "world",
"name": "World Affairs",
"article_count": 2481,
"color": "#457b9d"
},
{
"id": "cat_tech",
"slug": "technology",
"name": "Technology",
"article_count": 1842,
"color": "#c9a84c"
}
]
🔍 Search
Full-text search across articles, authors, and tags using Aevum's vector index.
GET
/search
Query the content index. Supports fuzzy matching, date ranges, and semantic ranking.
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | Yes | Search query (min 3 chars) |
type | string | No | article, author, multimedia |
date_from | date | No | Filter by publication start date |
date_to | date | No | Filter by publication end date |
Example Request
GET /v1/search?q="quantum computing"&type=article&date_from=2025-01-01
👤 Users
Manage authenticated user profiles and subscriptions.
GET
/users/me
Return the authenticated user's profile, subscription tier, and usage statistics.
Response (200 OK)
{
"id": "usr_3m2n1k0j",
"email": "developer@example.com",
"role": "developer",
"subscription": {
"tier": "pro",
"status": "active",
"expires_at": "2026-01-15T00:00:00Z"
},
"api_usage": {
"requests_today": 142,
"daily_limit": 10000
}
}
⚡ Rate Limits
API requests are throttled based on subscription tier. Exceeding limits returns 429 Too Many Requests.
Free Tier
100 req/min
10,000 req/day
10,000 req/day
Pro Tier
600 req/min
500,000 req/day
500,000 req/day
Enterprise
Custom limits
Dedicated support
Dedicated support
Rate Limit Headers
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9842
X-RateLimit-Reset: 1713456000