Currents News API Documentation

Search Endpoint

The Search Endpoint of Currents News API allows you to search through tens of millions of articles from over 14,000 news sources and blogs, including breaking news, blog articles, and forum content. This endpoint is ideal for article discovery, content analysis, and retrieving news for display.

📍 Endpoint

https://api.currentsapi.services/v1/search

Request Parameters

language

Filter results by language code.

  • Valid Values: Codes available via /v1/available/languages
  • Default: en (English)

start_date

Search for news published after given date.

  • Default: Current UTC time
  • Format: RFC 3339 (e.g., YYYY-MM-DDTHH:mm:ss.ss±hh:mm)

end_date

Search for news published before given date.

  • Default: Current UTC time
  • Format: RFC 3339

type

Filter results by content type.

  • Valid Values: 1 (news), 2 (articles), 3 (discussion)
  • Default: 1

country

Filter by country code of news source.

  • Valid Values: Codes available via /v1/available/regions
  • Default: INT (International)

category

Filter results by news category.

  • Valid Values: Categories available via /v1/available/categories

page_number

Specify the page number to access older results.

  • Valid Values: Any integer greater than zero
  • Default: 1

domain

Filter results by specific website domains.

  • Format: Primary domain name without prefixes (e.g., example.com)

domain_not

Exclude specific domains from results.

  • Format: Primary domain name without prefixes

keywords

Search for exact matches of words in titles or descriptions.

  • Format: String

page_size

Specify the number of articles per page.

  • Valid Values: Any integer between 1 and 200
  • Default: 30

limit

Specify the total number of articles returned.

  • Valid Values: Any integer between 1 and 200
  • Default: Returns all matching articles

Additional Filtering Endpoints

For additional filtering, use these endpoints to get supported values:

/v1/available/categories

List of available news categories

/v1/available/regions

List of supported country codes

/v1/available/languages

List of valid language codes