Top News

Get the top news from a country in a language for a specific date. The top news are clustered from multiple sources in the given country. The more news in a cluster the higher the cluster is ranked.

Example Top 10 News for Today () from the US (source-country=us)


Results for the current day are frequently updated to capture new developments.

GET
https://api.worldnewsapi.com/top-news
Example Request and Response
GET
https://api.worldnewsapi.com/{{ examples.getTopNews }}
{
    "top_news": [
        {
            "news": [
                {
                    "id": 224767206,
                    "title": "Jury to Begin Deliberations In Trump Trial",
                    "text": "...",
                    "summary": "...",
                    "url": "https://politicalwire.com/2024/05/28/jury-to-begin-deliberations-in-trump-trial/",
                    "image": "https://politicalwire.com/wp-content/uploads/2018/02/PW-podcast-logo.jpg",
                    "video": null,
                    "publish_date": "2024-05-29 00:10:48",
                    "author": "Taegan Goddard",
                    "authors": [
                        "Taegan Goddard"
                    ]
                },
                {
                    "id": 224839780,
                    "title": "Jury in Donald Trump's hush money case to begin deliberations",
                    "text": "...",
                    "summary": "...",
                    "url": "https://apnews.com/article/trump-trial-deliberations-jury-judge-verdict-390f045e9e8a37f069e82576edd7a842",
                    "image": "https://dims.apnews.com/dims4/default/3446536/2147483647/strip/true/crop/6195x3485+0+323/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fec%2Fd5%2Ff56fdc38f86e38b6217b50083d19%2Fd5ef4afe1cb64825be1349de8fd40df0",
                    "video": null,
                    "publish_date": "2024-05-29 04:30:08",
                    "authors": []
                },
                {
                    "id": 224936214,
                    "title": "Jury in Trump's hush money case to begin deliberations after hearing instructions from judge",
                    "text": "...",
                    "summary": "...",
                    "url": "https://whdh.com/news/jury-in-trumps-hush-money-case-to-begin-deliberations-after-hearing-instructions-from-judge/",
                    "image": "https://whdh.com/wp-content/uploads/sites/3/2024/05/WHDH_2024-05-27_15h27-33-cover.jpg?quality=60&strip=color",
                    "video": null,
                    "publish_date": "2024-05-29 08:47:26",
                    "authors": []
                },
                {
                    "id": 224956968,
                    "title": "Trump trial jury set to begin deliberating verdict today after judge issues instructions",
                    "text": "...",
                    "summary": "...",
                    "url": "https://www.cbsnews.com/live-updates/trump-trial-verdict-jury-deliberations-judge-instructions/",
                    "image": "https://assets3.cbsnewsstatic.com/hub/i/r/2024/05/29/66524a85-576c-4c40-94ba-cfb04cbb7950/thumbnail/1200x630g3/d2d9c8ea35b659db292c371bdc0a47e8/gettyimages-2154550679.jpg?v=c5044be0004eac09882c007ac02fef6d",
                    "video": "https://prod.vodvideo.cbsnews.com/cbsnews/vr/hls/2942696_hls/master.m3u8",
                    "publish_date": "2024-05-29 10:00:18",
                    "authors": []
                },
                {
                    "id": 224957034,
                    "title": "Jury in Trump’s Hush-Money Trial to Begin Deliberations on Wednesday",
                    "text": "...",
                    "summary": "...",
                    "url": "https://www.nytimes.com/2024/05/29/nyregion/trump-trial-jury-charges.html",
                    "image": "https://static01.nyt.com/images/2024/05/29/multimedia/29trump-trial-pinned-qzmh/29trump-trial-pinned-qzmh-facebookJumbo-v2.jpg",
                    "video": null,
                    "publish_date": "2024-05-29 10:12:08",
                    "authors": []
                },
                {
                    "id": 224961802,
                    "title": "Jury to begin deliberations in Trump trial and more top headlines",
                    "text": "...",
                    "summary": "...",
                    "url": "https://www.foxnews.com/us/judge-outline-framework-jury-trial-decide-trumps-fate-more-top-headlines",
                    "image": "https://a57.foxnews.com/static.foxnews.com/foxnews.com/content/uploads/2024/05/931/524/judge-trump.png?ve=1&tl=1",
                    "video": null,
                    "publish_date": "2024-05-29 10:22:36",
                    "authors": []
                }
            ]
        },
        {
            "news": [
                {
                    "id": 225109966,
                    "title": "Scottie Scheffler PGA Championship charges set to get dropped",
                    "text": "...",
                    "url": "https://www.sbnation.com/golf/2024/5/29/24167024/scottie-scheffler-pga-championship-louisville-police-drop-charges",
                    "image": "https://cdn.vox-cdn.com/thumbor/WBEMdSSOD_jHJGnNV7hLX88zANk=/0x444:5601x3376/fit-in/1200x630/cdn.vox-cdn.com/uploads/chorus_asset/file/25469085/2152809074.jpg",
                    "video": null,
                    "publish_date": "2024-05-29 15:24:34",
                    "author": "Brendan Porath",
                    "authors": [
                        "Brendan Porath"
                    ]
                },
                {
                    "id": 225118216,
                    "title": "Charges against world’s top golfer Scottie Scheffler dropped after arrest outside PGA Championship",
                    "text": "...",
                    "summary": "...",
                    "url": "https://www.pilotonline.com/2024/05/29/charges-against-worlds-top-golfer-scottie-scheffler-dropped-after-arrest-outside-pga-championship/",
                    "image": "https://www.pilotonline.com/wp-content/uploads/2024/05/Scheffler_Arrest_Golf_86723_6d56d8.jpg?w=1024",
                    "video": null,
                    "publish_date": "2024-05-29 17:05:55",
                    "authors": []
                },
                {
                    "id": 225118304,
                    "title": "Charges against world’s top golfer Scottie Scheffler dropped after arrest outside PGA Championship",
                    "text": "...",
                    "summary": "...",
                    "url": "https://www.twincities.com/2024/05/29/charges-against-worlds-top-golfer-scottie-scheffler-dropped-after-arrest-outside-pga-championship/",
                    "image": "https://www.twincities.com/wp-content/uploads/2024/05/Scheffler_Arrest_Golf_86723_6d56d8.jpg?w=1024",
                    "video": null,
                    "publish_date": "2024-05-29 17:05:55",
                    "authors": []
                },
                {
                    "id": 225119550,
                    "title": "Charges against world's top golfer Scottie Scheffler dropped after arrest outside PGA Championship",
                    "text": "...",
                    "summary": "...",
                    "url": "https://wsvn.com/sports/charges-against-worlds-top-golfer-scottie-scheffler-dropped-after-arrest-outside-pga-championship/",
                    "image": "https://wsvn.com/wp-content/uploads/sites/2/2024/04/240414_Scottie_Scheffler.jpg?quality=60&strip=color",
                    "video": null,
                    "publish_date": "2024-05-29 17:10:09",
                    "authors": []
                }
            ]
        },
        {
            "news": [
                {
                    "id": 225012756,
                    "title": "Pandas to return to DC's National Zoo",
                    "text": "...",
                    "summary": "...",
                    "url": "https://www.nbcwashington.com/news/local/national-zoo-expected-to-make-announcement-about-panda-program/3627045/",
                    "image": "https://media.nbcwashington.com/2019/09/AP163564666366.jpg?quality=85&strip=all&fit=722%2C406",
                    "video": null,
                    "publish_date": "2024-05-29 12:37:10",
                    "authors": []
                },
                {
                    "id": 225017360,
                    "title": "Giant pandas are returning to D.C.'s National Zoo",
                    "text": "...",
                    "summary": "...",
                    "url": "https://apnews.com/article/giant-pandas-washington-zoo-china-764f8016d98c01ab579bdbb6dcc3dd6b",
                    "image": "https://dims.apnews.com/dims4/default/1f5b9aa/2147483647/strip/true/crop/3382x1902+0+176/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fc4%2F1e%2F69094cc265243956d243348db814%2F71b160bbb0204eb594474a4934fb0df6",
                    "video": null,
                    "publish_date": "2024-05-29 12:51:08",
                    "authors": []
                },
                {
                    "id": 225017634,
                    "title": "2 new giant pandas are returning to Washington’s National Zoo from China by the end of the year",
                    "text": "...",
                    "summary": "...",
                    "url": "https://www.baltimoresun.com/2024/05/29/2-new-giant-pandas-are-returning-to-washingtons-national-zoo-from-china-by-the-end-of-the-year/",
                    "image": "https://www.baltimoresun.com/wp-content/uploads/2024/05/Giant_Pandas_89303.jpg?w=1024",
                    "video": null,
                    "publish_date": "2024-05-29 12:52:08",
                    "authors": []
                }
            ]
        }
    ],
    "language": "en",
    "country": "us"
}
cURL
Java
Javascript
Python
Go
C#
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}
 {{ codeCopyText }}