Documents

Latest News

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

  • news are sorted by creation date

Search News

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

Valid Parameters
  • start_date : Search news after the given date

The valid format of the date 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 value is 180 days before current time value

Example : query the starting date for 20th of June, 2018 12 pm at UTC 0800 timezone

https://api.currentsapi.services/v1/search?start_date=2018-06-20T12:00:00+08:00


  • end_date : Search news before the given date

The valid format of the date 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 value is current time value

Example : query the starting date for 22 nd of June, 2018 12 pm at UTC 0800 timezone

https://api.currentsapi.services/v1/search?end_date=2018-06-22T12:00:00+08:00

Note: if your query contain both end_date and start_date fields, the start_date must always be earlier than the end_date otherwise it will return an empty result


  • language : the valid languages are

    Language code Language Name
    ar Arabic
    es Spanish
    de German
    nl Dutch
    en English
    fi Finnish
    fr French
    it Italian
    ja Japanese
    ko Korean
    pt Portugese
    msa Malay
    ru Russian
    zh Chinese

Example :

/v1/search?language=zh


  • type : 1 for news,2 for article and 3 for discussion content. All 3 types are choosen if there's no specification

Example : Get latest news (type=1) with english as the choosen language (language=en)

https://api.currentsapi.services/v1/search?type=1&language=en


  • country : available countries code are

    Country code Country Name
    AF Afghanistan
    AS Australia
    AT Austria
    BD Bangladesh
    BR Brazil
    BW Botswana
    CA Canada
    CN China
    FI Finland
    FR France
    DE German
    HK Hong Kong
    IN India
    ID Indonesia
    IE Ireland
    IL Israel
    IT Italy
    JP Japan
    LB Lebanon
    MX Mexico
    MY Malaysia
    MM Myanmar
    NL Netherland
    NO Norway
    NZ New Zealand
    NG Nigeria
    PH Philipines
    PSE Palestine
    PK Pakistan
    PA Panama
    PT Portugal
    RU Russia
    SA Saudi Arabia
    SG Singapore
    CH Switzerland
    SK South Korea
    SA South Africa
    TW Taiwan
    TH Thailand
    TR Turkey
    VIET Vietnam
    VEN Venezuela
    AE United Arabian Emirates
    US United States
    GB United Kingdom
    VEN Venezuela
    ZW Zimbabwe
    Continent code Continent Name
    INT INT
    EU Europe
    ASIA Asia

Example : Get content from China

https://api.currentsapi.services/v1/search?country=CN


Python


Use any http requests to call our urls and include your secret token in the http headers

import requests r = requests.get(YOUR_URL, headers={ "Authorization": YOUR_API_KEY }) print(r.json())