SDKs & Integrations
Access Aevum News content programmatically with our official SDKs. Built for speed, reliability, and ease of integration across all major platforms.
JavaScript SDK
Node.js & browser-compatible SDK for Aevum News API
Overview
The official JavaScript SDK provides a seamless way to integrate Aevum News into your web applications, Node.js servers, and serverless functions. Supports both CommonJS and ES modules.
Features
- ✓ Full API coverage — all 24 endpoints
- ✓ Real-time streaming with Server-Sent Events
- ✓ Automatic retry with exponential backoff
- ✓ TypeScript definitions included
- ✓ Request caching & pagination helpers
- ✓ Webhook signature verification
- ✓ Tree-shakeable for optimal bundle size
Quick Start
Python SDK
Python 3.8+Full-featured Python client with async/await support, type hints, and comprehensive error handling for data science and backend integration.
pip install aevum-news
iOS SDK
Swift 5.7+ / iOS 14+Native Swift SDK with SwiftUI components, Combine integration, and push notification support for real-time news alerts on iOS devices.
swift package add AevumNews
Android SDK
Kotlin / min SDK 21Native Kotlin SDK with Jetpack Compose UI components, Flow-based reactive streams, and WorkManager support for background sync.
implementation 'com.aevumnews:android-sdk:3.5.0'
Go SDK
Go 1.20+High-performance Go client with goroutine-based streaming, connection pooling, and context-aware request cancellation.
go get github.com/aevumnews/go-sdk
React SDK
React 18+ / Next.jsReact hooks and components for integrating Aevum News feeds. Includes <NewsFeed>, <ArticleCard>, and useAevum() hooks.
npm install @aevum-news/react
Ruby SDK
Ruby 3.0+Idiomatic Ruby gem with Rails integration, AR-like querying, and seamless ActiveJob support for background news processing.
gem install aevum-news
CLI Tool
Node.js / macOS / LinuxCommand-line interface for querying Aevum News directly from your terminal. Supports piping, JSON output, and scriptable workflows.
npm install -g @aevum-news/cli
PHP SDK
PHP 8.1+PSR-compliant PHP library with Laravel service provider, Symfony bundle, and PSR-7/PSR-17 support for modern PHP frameworks.
composer require aevum-news/php-sdk
Key API Endpoints
| Method | Endpoint | Description | Auth |
|---|---|---|---|
| GET | /v2/articles | List articles with filtering, sorting, and pagination | API Key |
| GET | /v2/articles/{id} | Get a single article by ID with full content | API Key |
| GET | /v2/search | Full-text search across all articles and sources | API Key |
| GET | /v2/categories | List all available news categories and topics | Public |
| POST | /v2/alerts | Create keyword or topic-based news alerts | API Key |
| GET | /v2/sources | List contributing news sources and outlets | Public |
| POST | /v2/webhooks | Register webhook endpoints for real-time events | API Key |
| GET | /v2/analytics | Usage analytics and API consumption metrics | API Key |
Recent SDK Updates
- Added Server-Sent Events support for real-time streaming
- Added TypeScript 5.3 support
- Fixed Memory leak in long-running stream connections
- Changed Default timeout from 10s to 15s
- Added SwiftUI NewsFeed component
- Fixed Push notification registration on iOS 17
- Changed Minimum deployment target to iOS 14
- Added Async client with asyncio support
- Added Pydantic v2 data models
- Fixed Rate limit retry logic
- Added Connection pooling with configurable max connections
- Added Context-aware request cancellation
- Breaking Renamed NewClient() to NewAevumClient()