Currents News API Documentation
Getting Started
New to Currents? Create a free account to get your API key and start making requests.
Step 1: Get Your API Key
To use the Currents API, you need an API key. You can get one by:
Step 2: Make Your First Request
Here's a simple example to fetch the latest news:
GET
https://api.currentsapi.services/v1/latest-news
With cURL
curl -H "Authorization: YOUR_API_KEY" \
https://api.currentsapi.services/v1/latest-news
With JavaScript (fetch)
fetch('https://api.currentsapi.services/v1/latest-news', {
headers: {
'Authorization': 'YOUR_API_KEY'
}
})
.then(response => response.json())
.then(data => console.log(data));
With Python (requests)
import requests
headers = {
'Authorization': 'YOUR_API_KEY'
}
response = requests.get(
'https://api.currentsapi.services/v1/latest-news',
headers=headers
)
data = response.json()
print(data)
Step 3: Explore the API
Now that you have your API key, you can:
- Search for news on specific topics
- Filter by country, language, and category
- Get latest news or search historical articles
- Limit results and paginate through data
Troubleshooting
401 Unauthorized
Make sure you're using the correct API key from your dashboard.
429 Too Many Requests
You've exceeded your daily request limit. Check your usage in the dashboard.
Need more help? Contact our support team or check out our pricing plans.