Search Endpoint

The Search Endpoint of the 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.

        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 the given date.
  • Default: Current UTC time
  • Format: RFC 3339 format (e.g., YYYY-MM-DDTHH:mm:ss.ss±hh:mm)
• end_date: Search for news published before the given date.
  • Default: Current UTC time
  • Format: RFC 3339 format
• type: Filter results by content type.
  • Valid Values: 1 (news), 2 (articles), 3 (discussion content)
  • Default: 1
• country: Filter by the country code of the 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

---

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