API & Tracking Reference

The Aevum News Developer Platform provides programmatic access to our real-time news feed, audience analytics, event tracking, and conversion APIs. Integrate seamlessly with your CMS, ad tech stack, or internal data pipelines.

Core Capabilities

• Real-time news content delivery with regional/localized filtering
• Audience event tracking (views, scrolls, shares, dwell time)
• Server-to-server conversion & attribution reporting
• Webhook delivery for live content updates and analytics events
• Rate-limited public endpoints and authenticated commercial tiers

Authentication

All authenticated endpoints require a Bearer token issued via your developer dashboard. Tokens are scoped to specific keys and cannot be shared publicly.

curl -X POST https://api.aevumnews.com/v2/auth/token \
  -H "Content-Type: application/json" \
  -d '{"api_key": "ak_live_x8f9s...", "api_secret": "sk_live_9d2k..."}'

const response = await fetch('https://api.aevumnews.com/v2/auth/token', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    api_key: 'ak_live_x8f9s...',
    api_secret: 'sk_live_9d2k...'
  })
});
const { access_token, expires_in } = await response.json();

Event Tracking API

Track reader behavior across web and mobile environments. Events are processed in real-time and available via dashboard and webhooks.

Request Body Schema

curl -X POST https://api.aevumnews.com/v2/events \
  -H "Authorization: Bearer " \
  -H "Content-Type: application/json" \
  -d '{
    "event_name": "article_view",
    "session_id": "sess_7f8a9b",
    "timestamp": "2025-07-14T08:23:11Z",
    "properties": { "article_id": "aev_9921", "category": "technology", "read_duration_sec": 142 }
  }'

fetch('https://api.aevumnews.com/v2/events', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + TOKEN,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    event_name: 'article_view',
    session_id: 'sess_7f8a9b',
    timestamp: new Date().toISOString(),
    properties: { article_id: 'aev_9921', category: 'technology', read_duration_sec: 142 }
  })
});

Content Feed API

Retrieve curated news articles with filtering by region, category, publication time, and freshness. Supports pagination and etag caching.

Query Parameters

Response Schema

Tracking & Pixel Integration

Deploy Aevum News tracking across your properties using the JavaScript SDK or server-side pixel. Enables cross-domain attribution, audience segmentation, and real-time analytics.

JavaScript SDK Setup

<script src="https://cdn.aevumnews.com/tracking/v2/aevum-track.min.js"></script>
<script>
  AevumTrack.init({
    publisher_id: 'pub_aev_8821',
    region: 'global',
    consent_mode: 'granted',
    debug: false
  });
  AevumTrack.identify({ uid: 'user_1293', email_hash: 'sha256(...)' });
</script>

// Track custom actions
AevumTrack.track('newsletter_signup', {
  source: 'article_footer',
  tier: 'premium'
});

// Page view (auto-tracked, but can override)
AevumTrack.pageView({
  article_id: 'aev_9921',
  dwell_time_ms: 42000,
  scroll_depth: 0.85
});

Webhooks & Delivery

Receive real-time payloads for content publication, tracking events, and system alerts. Configure endpoints in your developer dashboard.

Event Types

Webhook Signature Verification

Aevum signs all webhook payloads using HMAC-SHA256. Verify using the X-Aevum-Signature header and your webhook secret.

const crypto = require('crypto');
const sig = req.headers['x-aevum-signature'];
const payload = JSON.stringify(req.body);
const expected = crypto.createHmac('sha256', WEBHOOK_SECRET).update(payload).digest('hex');
if (sig !== expected) throw new Error('Invalid signature');

Session Tracking

Aevum automatically generates anonymous session identifiers via first-party cookies or URL parameter fallback. Sessions persist across subdomains within your configured domain scope.

• Auto-captured: page_load, scroll_depth, back_button, share_click
• Custom properties merged via AevumTrack.setSessionProperties()
• Session TTL: 30 minutes of inactivity

Conversion API

Server-to-server conversion tracking for offline or high-value actions. Bypasses browser restrictions and improves attribution accuracy.

Matchable Fields

SDKs & Libraries

Official client libraries for rapid integration. Community wrappers available on npm, pypi, and go modules.

Rate Limits

API tiers enforce request throttling to ensure platform stability. Exceeded limits return 429 Too Many Requests with Retry-After header.

API Status

Monitor live status and historical incidents at status.aevumnews.com

Developer Support

Need integration help, custom endpoints, or enterprise SLAs? Our API team reviews submissions within 24 business hours.

• Email: api@aevumnews.com
• Dashboard: developer.aevumnews.com
• Status Page: status.aevumnews.com
• Changelog: /developer/changelog

© 2025 Aevum News. API documentation v2.4. All rights reserved. Usage subject to Developer Terms and Data Processing Agreement.