Latest News API Endpoint

The Latest News API endpoint returns newly indexed news articles in JSON for applications that need fresh headlines, source links, publication times, and available metadata without running a keyword search first.

At a Glance

  • Use for: fresh news feeds, dashboards, monitoring workflows, and region/category pages.
  • Returns: article titles, descriptions, source URLs, authors when available, images when available, language, category, and published timestamps.
  • Filter by: country, language, category, domain, excluded domain, author, page number, and page size.
  • Use search instead when: you need keywords, date ranges, image-only filtering, or cursor pagination.

Latest News API vs Search API

Choose the endpoint that matches the job before you build the request into your app.

  • Latest News API: fresh feeds by country, language, category, source domain, excluded domain, or author.
  • Search API: keyword, topic, image, and date-range discovery. See the Search News API overview when search is the main product path.
  • Planning a product page or feed? Start with the Latest News API overview, then check pricing and quotas.
Free News API Pricing and Quotas Code Examples Search News API Create API Key

📍 Endpoint

V1 (Stable):

https://api.currentsapi.services/v1/latest-news

V2 (Canonical Taxonomy):

https://api.currentsapi.services/v2/latest-news

Request Parameters

Core Filters

  • language: Default en. Valid values from /v1/available/languages or /v2/available/languages.
  • country: 2-letter country code from /v1/available/regions or /v2/available/regions.
  • category: One or multiple categories. Use v1 values on /v1/* and v2 values on /v2/*. science_technology is v2 only.
  • type: 1 (news), 2 (articles), 3 (discussion).
Search-only parameters rejected here: keywords, query, start_date, end_date, limit, has_image, and has_description are only supported on /v1/search and /v2/search. cursor is supported only on /v2/search. Passing these parameters to /v1/latest-news or /v2/latest-news returns 400 Invalid parameters. For latest articles about a topic, use /v1/search?keywords=... or /v2/search?keywords=....

Structured Filters

  • domain: Include only sources from one domain (for example, reuters.com).
  • domain_not: Exclude sources from one domain.
  • author: Case-insensitive exact author match.

Pagination

Control the subset of results returned using page_number and page_size.

page_number

The page index you want to retrieve.

  • Range: 1 to 180
  • Default: 1
page_size

The number of articles to return per page.

  • Range: 1 to 300 (hard upper bound; your plan may enforce lower limits)
  • Default: 30

Example Calls by Programming Language (Tab View)

Switch tabs to use the same endpoint from different client languages.

Request

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

Request

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

Request

import requests

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

Request

library(httr)

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

V2 taxonomy example:

curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.currentsapi.services/v2/latest-news?category=science_technology&language=en"

Incorrect (returns 400):

curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.currentsapi.services/v1/latest-news?keywords=technology"

Canonical V2 Categories

The API canonical category taxonomy is now the V2 set. Use these values for category on /v2/latest-news and /v2/search.

general, society, science_technology, politics_government, economy_business_finance, arts_culture_entertainment, lifestyle_leisure, human_interest, sport, crime_law_justice, education, environment, labour, health, automotive, real_estate

Legacy internal labels are normalized by the backend (for example, non-canonical SOC variants map to society) and canonical category values are returned in API responses.

Response Object

  • status: Indicates whether request was successful (ok) or failed (error).
  • page: The current page number being returned.
  • news: A list of news articles. Each article contains following attributes:
    • id: Unique identifier for the article.
    • title: The headline of the news article.
    • description: A brief summary of the article.
    • url: The direct link to the original article.
    • author: The author of the news article, if available.
    • image: URL of the associated image, if available.
    • language: Language code of the article.
    • category: List of categories associated with the article.
    • published: The publication date and time.

Full Response Example

{
  "status": "ok",
  "news": [
    {
      "id": "f8f18e4b-c66e-47ca-9f7d-54f03e431a77",
      "title": "Chipmaker expands data-center investment",
      "description": "The company announced a new multi-year expansion plan...",
      "url": "https://example.com/business/chipmaker-expands",
      "author": "Editorial Desk",
      "image": "https://example.com/images/chipmaker.jpg",
      "language": "en",
      "category": ["science_technology", "economy_business_finance"],
      "published": "2026-03-24 11:10:00 +0000"
    }
  ],
  "page": 1
}

Auxiliary Endpoints

Retrieve valid filter codes for languages, regions, and categories with matching version paths:

/v2/available/categories

Canonical category list for current integrations.

/v1/available/regions
/v2/available/regions

List of supported country codes.

/v1/available/languages
/v2/available/languages

List of valid language codes.