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:
  • page_number : page number to access older news from current search results

    • Valid format : Any integer number larger than zero
    • Default : 1
  • domain : Filter results by website domain

    • Valid format : website primary domain name (without www or blog prefix )
  • domain_not : Remove website domain from results, allow you to blacklist any website from your search results

    • Valid format : website primary domain name (without www or blog prefix )
  • keywords : Exact match of words in can be found in title or description.

    • Valid format : string format
  • page_size : Number of articles in each page

    • Valid format : Any integer between 1 to 200
    • Default : 30
  • limit : Total number of articles return in results. Try set this parameter to a small number ( around 30 ) if you have complex query

    • Valid format : Any integer between 1 to 200
    • Default : return all matched articles by default

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