Up & Running in 3 Steps
Fetch your first article in under 60 seconds.
Generate API Key
Create an account or sign in to your dashboard. Navigate to Settings → API Keys and generate a new secret.
Make a Request
Pass your key via the `X-Aevum-Key` header. All endpoints return standardized JSON responses.
Parse & Build
Access headlines, metadata, content snippets, and author data. Filter by category, date, or region.
curl https://api.aevumnews.com/v2/articles/latest \\ -H "X-Aevum-Key: YOUR_API_KEY" \\ -H "Accept: application/json"
Core Endpoints
Explore our most frequently used resources. Full schema docs available in the dashboard.
Latest Headlines
Retrieve the most recent verified articles across all categories. Supports pagination and time filters.
Full-Text Search
Query articles by keyword, author, publication date, or region. Returns relevance-sorted results.
Category Index
Get a list of available categories with article counts and top-level metadata.
Configure Webhooks
Register endpoints to receive real-time payloads when breaking news or category updates occur.
Full Article Content
Fetch complete article text, multimedia assets, and structured metadata. Requires Pro tier.
Custom Feed Config
Save user-specific filtering rules, category weights, and exclusion keywords to our edge network.
🔐 Authentication
All authenticated endpoints require your API key in the request header. Keys can be rotated from the dashboard.
X-Aevum-Key: your_api_key_here
Never expose your secret key in client-side code. Use environment variables or a proxy server.
⚡ Rate Limits & Webhooks
Limits are enforced per key, per minute. Exceeding limits returns `429 Too Many Requests` with a `Retry-After` header.
X-RateLimit-Remaining: 842
X-RateLimit-Reset: 1698765432
Webhooks are delivered with retries (3 attempts, exponential backoff) and HMAC signature validation.
Pricing Tiers
Starter
- 100 requests / day
- Latest headlines only
- Community support
- Standard response time
Professional
- 50,000 requests / day
- Full text & multimedia
- Advanced search & filters
- Email & priority chat support
Enterprise
- Unmetered requests
- Dedicated webhook endpoints
- SLA & uptime guarantees
- Custom integrations & onboarding
SDKs & Integrations
Official client libraries maintained by the Aevum team. Install via your favorite package manager.
Developer Support
Community Forum
Ask questions, share use cases, and browse solutions from fellow developers.
Visit ForumGitHub & SDKs
Report bugs, request features, and contribute to open-source client libraries.
View Repos