API Documentation - Currrent Enterprise

What You Can Build

Add News Feeds to Your App

Show relevant news directly in your app, automatically filtered and updated in real-time.

// Fetch personalized news feed
GET /api/v1/feeds/personalized
{
  "topics": ["fintech", "enterprise-software"],
  "limit": 20,
  "format": "json"
}
                        

Turn Any Content into Audio

Send us any text and get back smart summaries with high-quality voice narration.

// Generate AI summary
POST /api/v1/summarize
{
  "content": "Your content here...",
  "tone": "professional",
  "voice_enabled": true
}
                        

Create Custom Audio Reports

Generate podcast-style reports on any topic for your team dashboards and weekly briefings.

// Create documentary episode
POST /api/v1/documentaries
{
  "topic": "Q4 Market Analysis",
  "sources": ["internal", "news", "social"],
  "format": "audio+transcript"
}
                        

Smart CRM Alerts

Automatically watch your prospects and customers, and get alerts when they're mentioned in the news.

// Monitor CRM contacts
POST /api/v1/crm/monitor
{
  "contact_id": "sf_001234",
  "company": "Acme Corp",
  "alert_webhook": "https://your-app.com/webhook"
}
                        

How It Works

Built for Security

Secure login with industry-standard OAuth2
Private API keys for your team only
Built-in usage limits to protect your account
All connections encrypted and secure
Extra security for sensitive data

Developer Friendly

Simple, easy-to-understand web addresses
Works with standard web development tools
Simple JSON format for all data
Clear error messages when something goes wrong
Complete documentation with examples

Instant Updates

Get notified instantly when news breaks
Live connections for real-time news feeds
Set your own alert preferences
Automatic retry if something doesn't work
Only get the updates you want to see

Plans & Usage Limits

Plan	API Calls/Hour	Live Connections	Alert Endpoints	Support Level
Essentials	1,000	5	3	Standard
Professional	10,000	25	10	Priority
Enterprise	Custom	Unlimited	Unlimited	Dedicated

Getting Started

// OAuth2 Token Request
POST https://api.currrent.ai/oauth/token

{
  "grant_type": "client_credentials",
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "scope": "read:feeds write:monitors"
}

// Using the token in requests
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     https://api.currrent.ai/v1/feeds/personalized
            

Setting Up Instant Alerts

// Configure webhook endpoint
POST /api/v1/webhooks
{
  "url": "https://your-app.com/currrent/webhook",
  "events": ["news.alert", "documentary.ready"],
  "secret": "your_webhook_secret"
}

// Example webhook payload
{
  "event": "news.alert",
  "timestamp": "2024-12-01T15:30:00Z",
  "data": {
    "contact_id": "sf_001234",
    "company": "Acme Corp",
    "news_summary": "Acme Corp announces $50M Series B...",
    "audio_url": "https://cdn.currrent.ai/audio/alert_123.mp3"
  }
}
            

Connect Currrent to Your Tools