Currents News API Documentation

Authentication

Security Note: We strongly recommend using query string parameter (apiKey) instead of HTTP headers to prevent API key exposure in logs.

Authentication is handled with a simple API key that you can get from your dashboard.

Authentication Methods

You can attach your API key to a request in two ways:

✅ Recommended

Query String Parameter

Append apiKey=YOUR_KEY to your request URL.

⚠️ Alternative

Authorization Header

Add Authorization: YOUR_KEY HTTP header.

Examples

cURL

Query String (Recommended)

curl "https://api.currentsapi.services/v1/latest-news?apiKey=YOUR_KEY"

Authorization Header

curl -H "Authorization: YOUR_KEY" \
  https://api.currentsapi.services/v1/latest-news"

JavaScript (fetch)

// Query String (Recommended)
fetch('https://api.currentsapi.services/v1/latest-news?apiKey=YOUR_KEY')
  .then(response => response.json())
  .then(data => console.log(data));

// Authorization Header
fetch('https://api.currentsapi.services/v1/latest-news', {
  headers: {
    'Authorization': 'YOUR_KEY'
  }
})
  .then(response => response.json())
  .then(data => console.log(data));

Python (requests)

import requests

# Query String (Recommended)
response = requests.get(
  'https://api.currentsapi.services/v1/latest-news',
  params={'apiKey': 'YOUR_KEY'}
)

# Authorization Header
response = requests.get(
  'https://api.currentsapi.services/v1/latest-news',
  headers={'Authorization': 'YOUR_KEY'}
)

data = response.json()
print(data)

Error Handling

401 Unauthorized

If API key is not provided, invalid, or expired, you'll receive:

{
  "status": "error",
  "code": 401,
  "message": "Invalid API key"
}

Tip: Make sure you're using the correct API key from your dashboard. You can regenerate it if needed.

Next Steps

Now that you know how to authenticate, explore:

Latest News Endpoint Search Endpoint Rate Limits

Need help? Contact support or check our pricing plans.