Aevum News
API Documentation

curl -X POST https://api.aevumnews.com/v2/api-keys \\
  -H "Authorization: Bearer YOUR_MASTER_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "name": "Production API Key",
    "scope": "read:articles,write:articles",
    "environment": "live"
  }'

{
  "key": "sk_aev_xK9mP2nQ7wR4vL8jT6yF3bH5cD1eA0g",
  "name": "Production API Key",
  "scope": "read:articles,write:articles",
  "created_at": "2025-01-15T08:30:00Z",
  "last_used": null,
  "environment": "live"
}

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1705312800
X-RateLimit-Window: hourly

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "API rate limit exceeded. Please retry after 45 seconds.",
    "retry_after": 45,
    "documentation_url": "https://docs.aevumnews.com/rate-limits"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "The requested article does not exist.",
    "request_id": "req_a7f3k9m2p4q8",
    "documentation_url": "https://docs.aevumnews.com/errors/not_found"
  }
}

curl -X GET \\
  "https://api.aevumnews.com/v2/articles?limit=5&category=technology&sort_by=published_at&order=desc" \\
  -H "Authorization: Bearer sk_aev_xK9mP2nQ7wR4vL8jT6yF3bH5cD1eA0g"

{
  "data": [
    {
      "id": "art_8xK3mP9qL2nR7vW4

{
  "data": {
    "id": "art_8xK3mP9qL2nR7vW4",
    "title": "AI Revolution: New Language Models Redefine Interaction",
    "slug": "ai-revolution-new-language-models",
    "summary": "Researchers unveil breakthrough AI systems...",
    "body": "[Full HTML article content...]",
    "body_plain": "[Plain text version...]",
    "status": "published",
    "category": "technology",
    "tags": ["AI", "machine-learning", "NLP"],
    "author": {
      "id": "au_3mK8pL1nQ6",
      "name": "Marcus Chen",
      "slug": "marcus-chen",
      "bio": "Senior technology correspondent...",
      "avatar_url": "https://cdn.aevumnews.com/avatars/mc.jpg"
    },
    "featured_image": {
      "url": "https://cdn.aevumnews.com/imgs/ai-model-2025.jpg",
      "alt": "Abstract visualization of neural network connections",
      "width": 1200,
      "height": 630
    },
    "views": 14852,
    "comments_count": 342,
    "read_time_min": 5,
    "published_at": "2025-01-15T14:30:00Z",
    "created_at": "2025-01-15T10:00:00Z",
    "updated_at": "2025-01-15T14:30:00Z"
  }
}

{
  "title": "Global Markets React to Central Bank Policy Shifts",
  "summary": "Markets worldwide adjust as major central banks signal rate adjustments amid shifting economic landscapes.",
  "body": "<p>In a coordinated move...</p>",
  "category": "business",
  "tags": ["economy", "central-banks", "interest-rates"],
  "status": "draft"
}

{
  "data": {
    "id": "art_9yL4nQ0rM3oS8wX5",
    "title": "Global Markets React to Central Bank Policy Shifts",
    "slug": "global-markets-react-central-bank",
    "status": "draft",
    "created_at": "2025-01-16T09:15:00Z",
    "message": "Article created successfully as draft."
  }
}

{
  "title": "Global Markets React to Central Bank Policy Shifts (Updated)",
  "tags": ["economy", "central-banks", "interest-rates", "inflation"],
  "status": "published"
}

// Empty response body on success // Response Headers:
X-Deletion-Id: del_2xP7kM4qN9

{
  "title": "Climate Crisis: A Comprehensive Overview",
  "slug": "climate-crisis-overview",
  "topic": "climate-environment",
  "article_ids": ["art_8xK3mP", "art_9yL4nQ", "art_1zA5bR"],
  "editor_note": "This story aggregates our best coverage on the climate crisis.",
  "status": "published"
}

{
  "data": [
    {
      "id": "str_4mL9pN2qR7",
      "title": "Climate Crisis: A Comprehensive Overview",
      "slug": "climate-crisis-overview",
      "topic": "climate-environment",
      "article_count": 3,
      "published_at": "2025-01-14T12:00:00Z",
      "featured": true
    }
  ],
  "pagination": {
    "total": 47,
    "count": 1,
    "has_more": true
  }
}

{
  "data": [
    { "id": "cat_1", "name": "Technology", "slug": "technology", "article_count": 1824 },
    { "id": "cat_2", "name": "Politics", "slug": "politics", "article_count": 2103 },
    { "id": "cat_3", "name": "World Affairs", "slug": "world", "article_count": 2410 },
    { "id": "cat_4", "name": "Business & Finance", "slug": "business", "article_count": 1567 },
    { "id": "cat_5", "name": "Science", "slug": "science", "article_count": 1198 },
    { "id": "cat_6", "name": "Culture & Arts", "slug": "culture", "article_count": 980 },
    { "id": "cat_7", "name": "Health", "slug": "health", "article_count": 860 },
    { "id": "cat_8", "name": "Climate & Environment", "slug": "climate", "article_count": 1120 }
  ]
}

{
  "name": "Sports",
  "slug": "sports",
  "description": "Coverage of local and international sports events"
}

{
  "data": {
    "id": "au_3mK8pL1nQ6",
    "name": "Marcus Chen",
    "slug": "marcus-chen",
    "role": "senior-correspondent",
    "bio": "Senior technology correspondent covering AI, quantum computing, and semiconductor innovation.",
    "avatar_url": "https://cdn.aevumnews.com/avatars/mc.jpg",
    "social": {
      "twitter": "@marcuschen_tech",
      "linkedin": "linkedin.com/in/marcuschen"
    },
    "article_count": 187,
    "total_views": 2400000,
    "joined_at": "2021-03-10T00:00:00Z"
  }
}

{
  "data": {
    "period": "last_30_days",
    "total_views": 12847563,
    "views_change": 12.4,
    "total_articles": 847,
    "avg_read_time_sec": 245,
    "top_performing": {
      "article_id": "art_8xK3mP9qL2nR7vW4",
      "title": "AI Revolution: New Language Models...",
      "views": 148520
    },
    "traffic_sources": {
      "direct": 34.2,
      "social": 28.7,
      "search": 22.1,
      "referral": 10.5,
      "email": 4.5
    }
  }
}

{
  "url": "https://your-app.com/webhooks/aevum",
  "events": [
    "article.published",
    "article.updated",
    "article.deleted",
    "story.published"
  ],
  "secret": "whsec_a8K3mP9qL2nR7vW4xY6z"
}