Search

This endpoint allow you to search through ten millions of article over 14,000 large and small news sources and blogs. This includes breaking news, blog articles, forum content. This endpoint is well suited for article discovery and analysis, but can be used to retrieve articles for display, too.

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

Requests parameters

  • language : string value

    • Valid value : Supported code can be found from /v1/available/languages
  • start_date : Search news after the given date

    • Default : current time value in UCT+0
    • Valid format : Date format should be YYYY-MM-ddTHH:mm:ss.ss±hh:mm, which follows the offcial standard of RFC 3339 Date and Time on the Internet
  • end_date : Search news before the given date

    • Valid format : Date format should be YYYY-MM-ddTHH:mm:ss.ss±hh:mm, which follows the offcial standard of RFC 3339 Date and Time on the Internet
    • Default : current time value in UCT+0
  • type : integer number

    • Valid format : 1 for news, 2 for article and 3 for discussion content. All 3 types are choosen if there's no specification
    • Default : 1
  • country : a country code representing news came from a region.

    • Valid value : Supported value can be found in /v1/available/regions
    • Default: INT international
  • category which the news belongs to

    • Valid value : Supported value can be found in /v1/available/categories
    • Default value:

We also serve a list of supported language and country code which you can use to filter your results

  • /v1/available/categories : List of available news category
  • /v1/available/regions : List of country code for query
  • /v1/available/languages : List of valid language code