Top News Headlines by Country
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 (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 }}
Frequently Asked Questions
What does the Top News endpoint return?
The Top News endpoint returns the most important news stories from a specific country, clustered from multiple sources. Stories with more sources covering them are ranked higher, giving you a relevance-weighted view of the day's biggest news.
How often is top news updated?
Results for the current day are frequently updated to capture new developments throughout the day. Historical dates return a fixed snapshot of that day's top stories.
Can I get top news for a specific country?
Yes. Use the source-country parameter with an ISO country code (e.g., us for the United States, gb for the United Kingdom). You can also specify the language for the results using the language parameter.