Aevum News Syndication

REST API

Powerful Endpoints

Simple, well-documented APIs designed for developers. Get started in minutes.

GET /v2/articles

Retrieve a paginated list of articles with optional filtering by category, date range, and relevance score.

                        
                        GET https://api.aevumnews.com/v2/articles
Authorization: Bearer {your_api_key}
Content-Type: application/json

Query Parameters:
{
  "limit": 20,
  "offset": 0,
  "category": "technology",
  "sort": "published_desc",
  "fields": "title,summary,author,published_at,url,image"
}
                    

GET /v2/articles/{id}

Fetch a single article by its unique ID with full content, metadata, and related articles.

                        
                        // Response Example
{
  "id": "art_9x2k4m",
  "title": "Global Climate Summit Reaches Historic Agreement",
  "summary": "In a landmark session, 190 nations signed a binding carbon reduction framework...",
  "content": "[Full article HTML content]",
  "author": {
    "name": "Elena Rodriguez",
    "avatar": "https://cdn.aevum.com/authors/er.jpg"
  },
  "category": "world",
  "published_at": "2025-01-15T14:30:00Z",
  "reading_time": 8,
  "featured_image": "https://cdn.aevum.com/img/climate-summit.jpg"
}
                    

GET /v2/articles/trending

Get the most-read articles in real-time, ranked by engagement metrics over configurable time windows.

                        
                        GET https://api.aevumnews.com/v2/articles/trending

Query Parameters:
{
  "window": "24h",      // 1h, 6h, 24h, 7d, 30d
  "limit": 10,
  "metric": "views"     // views, shares, engagement
}
                    

GET /v2/search

Full-text search across all published articles with semantic understanding and relevance ranking.

                        
                        GET https://api.aevumnews.com/v2/search?q=artificial+intelligence

Query Parameters:
{
  "q": "artificial intelligence regulation",
  "limit": 20,
  "language": "en",
  "date_from": "2025-01-01",
  "date_to": "2025-01-31",
  "sort": "relevance"
}

// Supports: natural language queries, synonyms,
// Boolean operators (AND, OR, NOT), phrase matching
                    

GET /v2/search/suggest

Get real-time search suggestions and autocomplete results for your UI.

// Response Example
{
  "suggestions": [
    "artificial intelligence regulation",
    "artificial intelligence in healthcare",
    "artificial intelligence ethics"
  ],
  "query_time_ms": 3
}

GET /v2/categories

List all available content categories with article counts and hierarchy.

                        
                        // Response Example
{
  "categories": [
    {
      "id": "world",
      "name": "World Affairs",
      "slug": "world",
      "article_count": 2481,
      "icon": "🌍"
    },
    {
      "id": "tech",
      "name": "Technology",
      "slug": "technology",
      "article_count": 1843,
      "icon": "💻"
    }
    // ... more categories
  ]
}
                    

POST /v2/webhooks/register

                        
                        POST https://api.aevumnews.com/v2/webhooks/register
Authorization: Bearer {your_api_key}

Body:
{
  "url": "https://your-site.com/webhook/aevum",
  "events": ["article.published", "article.updated", "breaking"],
  "secret": "your_webhook_secret"
}

// Incoming webhook payload:
{
  "event": "article.published",
  "timestamp": "2025-01-15T14:30:00Z",
  "data": {
    "article_id": "art_9x2k4m",
    "title": "...",
    "category": "world"
  }
}
                    

EVENTS Available Webhook Events

                        
                        "article.published"   — New article goes live
"article.updated"     — Existing article is revised
"breaking"            — Breaking news alert
"category.updated"    — Category content refreshed
"trending.changed"    — Trending articles shift
                    

Content Feeds

Ready-to-Use Feeds

Plug-and-play feeds for every platform. No API key required for public feeds.

📡

RSS 2.0 Feed

Standard RSS feeds for all categories. Compatible with every aggregator, CMS, and content management system.

https://feeds.aevumnews.com/rss/all

🕐 Updates every 15 min 📄 XML format

⚛️

Atom Feed

W3C-compliant Atom syndication with full article content, author metadata, and rich media references.

https://feeds.aevumnews.com/atom/all

🕐 Updates every 10 min 📄 XML / Atom

🔗

JSON Feed

Modern JSON Feed format with full content, images, and structured data. Ideal for modern web apps and SPAs.

https://feeds.aevumnews.com/json/all

🕐 Updates every 5 min 📄 JSON format

Plans & Pricing

Scale Your Content Distribution

From startups to enterprise publishers. Transparent pricing, no hidden fees.

Starter

Developer

Perfect for personal projects, prototypes, and small-scale applications.

$0 /month

✓ 1,000 API requests / month
✓ 3-day content window
✓ RSS & JSON feeds
✓ Basic article data
✗ Full article content
✗ Webhook events
✗ Priority support

Start Free

Metric	Free	Pro	Enterprise
API Requests / Month	1,000	100,000	Unlimited
Requests / Minute	10	200	Custom
Content Access Window	3 days	Unlimited	Unlimited
Feed Bandwidth	1 GB / month	100 GB / month	Unlimited
Webhook Endpoints	0	5	Unlimited
Search Queries / Day	100	10,000	Unlimited
Support Level	Community	Email & Chat	Dedicated PM
SLA Guarantee	None	99.9%	99.99%

Common Questions

Everything you need to know about syndicating Aevum News content.

What licensing terms apply to syndicated content?

All syndicated content is provided under our standard Content Distribution License. This permits you to display Aevum News articles on your platform with proper attribution. Full content licensing (including republication rights) is available on Pro and Enterprise plans. Enterprise customers can negotiate custom licensing agreements for exclusive or time-limited content access.

How quickly is new content available via API and feeds?

Content appears in our feeds within 5 minutes of publication. With webhooks (Pro and Enterprise plans), you receive real-time notifications the moment an article goes live. Our API reflects new content within 30 seconds of publishing, making Aevum one of the fastest news APIs available.

Can I use Aevum content in offline or mobile applications?

Yes. Pro and Enterprise plans include caching rights that allow you to store article content for offline access in mobile apps or kiosks. The cache duration depends on your plan — Pro allows 24-hour caching, while Enterprise allows custom durations. All cached content must display proper Aevum attribution.

What attribution is required when displaying Aevum content?

All displayed articles must include a visible "© Aevum News" attribution link pointing to aevumnews.com. Headlines and summaries must be accompanied by author bylines. Our API responses include all necessary attribution metadata. Enterprise clients receive guidance on meeting brand and legal requirements for attribution display.

How do I get started with the API?

Simply sign up for a free account and generate your API key from the developer dashboard. You'll get immediate access to the Starter tier with 1,000 requests per month. Our comprehensive documentation includes SDKs for Python, JavaScript, PHP, and Ruby. You can also join our developer community on Discord for support and best practices.

Is there a sandbox or test environment available?

Yes. All plans include access to our sandbox environment at api-sandbox.aevumnews.com. The sandbox contains sample articles and mirrors the full API structure, allowing you to develop and test your integration without consuming production rate limits or requiring a paid plan.

Distribute Aevum Content Everywhere