API Documentation

Complete reference for integrating Currrent's AI-powered news intelligence into your applications.

Getting Started

The Currrent API provides programmatic access to our AI-powered news aggregation and enhancement services.

Base URL
https://api.currrent.io/v1
Quick Start
# Install the Currrent SDK
pip install currrent-api

# Basic usage
import currrent
client = currrent.Client(api_key="your_api_key")
articles = client.articles.list(category="technology")

Authentication

All API requests require authentication using an API key passed in the Authorization header.

curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.currrent.io/v1/articles
Get your API key by contacting api@currrent.io

Articles API

GET /articles

Retrieve curated news articles with optional filtering and pagination.

Parameters
ParameterTypeDescription
categorystringFilter by news category (optional)
limitintegerNumber of articles to return (1-100, default: 20)
offsetintegerPagination offset (default: 0)
languagestringLanguage filter (ISO 639-1 code)
Example Request
GET /v1/articles?category=technology&limit=10
GET /articles/{id}

Retrieve a specific article by ID with full content and metadata.

Example Response
{
"id": "article_123",
"title": "AI Breakthrough in Neural Networks",
"summary": "Researchers announce...",
"content": "Full article content...",
"source": "Tech News Daily",
"published_at": "2025-01-15T10:30:00Z",
"language": "en",
"category": "technology"
}

AI Enhancement API

POST /enhance

Enhance articles with AI-generated summaries, context, and insights.

Request Body
{
"article_id": "article_123",
"enhancements": ["summary", "context", "insights"],
"length": "medium"
}
Response
{
"summary": "AI-generated summary...",
"context": "Background information...",
"insights": ["Key insight 1", "Key insight 2"]
}

Voice Synthesis API

POST /synthesize

Convert text to speech using premium neural voices.

Request Body
{
"text": "Text to convert to speech",
"voice": "en-US-JennyNeural",
"speed": 1.0,
"format": "mp3"
}

Returns audio file as binary data or URL depending on the request format.

News Sources API

GET /sources

List all available news sources and their categories.

Example Response
{
"sources": [
{
"id": "bbc_news",
"name": "BBC News",
"category": "general",
"language": "en",
"country": "gb"
}
]
}

Error Handling

The API uses conventional HTTP response codes to indicate success or failure.

CodeDescription
200OK - Request successful
400Bad Request - Invalid parameters
401Unauthorized - Invalid API key
429Too Many Requests - Rate limit exceeded
500Internal Server Error
Error Response Format
{
"error": {
"code": "invalid_parameter",
"message": "The 'category' parameter is invalid"
}
}

Need Help?

Our developer support team is here to help you integrate successfully.