News API Documentation

Get an API key and make your first request

Use this quick start to create a free Currents account, copy your API key, and test a JSON response from the Latest News API before choosing a paid plan.

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 is a simple example to fetch the latest news as JSON:

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)

Examples by Programming Language (Tab View)

Use the same API call in different client languages.

curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.currentsapi.services/v1/latest-news?language=en&page_size=3"

fetch("https://api.currentsapi.services/v1/latest-news?language=en&page_size=3", {
  headers: { Authorization: "Bearer YOUR_API_KEY" }
})
  .then((res) => res.json())
  .then((data) => console.log(data));

import requests

response = requests.get(
  "https://api.currentsapi.services/v1/latest-news",
  params={"language": "en", "page_size": 3},
  headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())

library(httr)

res <- GET(
  "https://api.currentsapi.services/v1/latest-news",
  query = list(language = "en", page_size = 3),
  add_headers(Authorization = "Bearer YOUR_API_KEY")
)
content(res, "parsed")

Response Structure (What Every Successful Call Looks Like)

{
  "status": "ok",
  "news": [
    {
      "id": "uuid",
      "title": "string",
      "description": "string",
      "url": "string",
      "author": "string|null",
      "image": "string|null",
      "language": "string",
      "category": ["string", "..."],
      "published": "timestamp string"
    }
  ],
  "page": 1
}

What your first request should show

After you sign up and copy your API key, start with a simple /v1/latest-news request. If the key is valid, the API returns HTTP 200, "status": "ok", and a news array. Then try /v1/search with your own keywords.

Once the API call works, keep building on the free plan until you need more daily requests, longer history, larger result windows, or more room to grow. That is when Builder or Professional is worth comparing.

Step 3: Understand API Versions

Currents exposes both /v1 and /v2 paths. V1 remains stable for existing integrations. V2 is the canonical taxonomy path and includes cursor pagination for search.

Step 4: Explore the API

Now that you have your API key, you can:

• Search for news on specific topics
• Filter by country, language, category, author, and domain
• Get latest news or search historical articles
• Limit results and paginate with page numbers or cursor (/v2/search)

Troubleshooting

Need more help? Contact our support team or check out our pricing plans.