Flag of United States

United States World News API

Get the live top world headlines from United States with our JSON API.

Get API key for the United States World News API

API Demonstration

This example demonstrates the HTTP request to make and the JSON response you will receive when you use the news api to get the top headlines from United States.

GET
https://gnews.io/api/v4/top-headlines?country=us&category=world&apikey=API_KEY
{
    "totalArticles": 242462,
    "articles": [
        {
            "id": "48ea49df522888cfeb7ce64771d46100",
            "title": "How the former Prince Andrew could be removed from Britain's line of succession",
            "description": "Britain’s government says it is considering legal changes to remove Andrew Mountbatten-Windsor from the royal line of succession.",
            "content": "LONDON (AP) — It’s been 90 years since a British royal was removed from the line of succession. That might happen again now that Britain’s government says it will consider introducing legal changes to formally remove Andrew Mountbatten-Windsor from t... [4691 chars]",
            "url": "https://apnews.com/article/britain-andrew-royal-line-of-succession-c1e25355a885060c0729ccb3acb9d187",
            "image": "https://dims.apnews.com/dims4/default/c796f08/2147483647/strip/true/crop/3303x2201+0+1/resize/980x653!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2Fe1%2Fa8%2F1a2aaed75388c6beb959a1bca9bb%2Fa830bab625bc42808d34006a3cdc5f82",
            "publishedAt": "2026-02-24T10:42:00Z",
            "lang": "en",
            "source": {
                "id": "b356d47a35dfffa723fc8131b36c3ed1",
                "name": "AP News",
                "url": "https://apnews.com"
            }
        },
        {
            "id": "9704abbb7a5731940dfd4afeb0832430",
            "title": "Rottnest Island: The dark history behind an Australian paradise",
            "description": "Rottnest Island, or Wadjemup, is famous for its beautiful beaches and cuddly quokkas. However, the isle has a dark history, and for 93 years was a prison for Aboriginal men and boys.",
            "content": "From the shorelines of Perth in southwestern Australia, a towering blue hill can be seen jutting out of the horizon. Some days it seems so close you could touch it. Other days it’s hidden by mist or passing ships.\n“Sometimes it wants to be seen and s... [7868 chars]",
            "url": "https://www.cnn.com/travel/rottnest-island-wadjemup-prison-island-history",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/107761-2-1.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2026-02-24T10:15:00Z",
            "lang": "en",
            "source": {
                "id": "b7f8938851261c8403f75f40eb1d8645",
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "id": "35d4a518f87c243eef6176530592d244",
            "title": "China issues dual-use blacklist of 20 Japanese entities",
            "description": "Special permission will be needed to export dual-use items to these companies, institutions and agencies.",
            "content": "China’s Commerce Ministry on Tuesday released two lists of Japanese companies, institutions and agencies for which exports will require special government permission.\nA blacklist of 20 entities “participating in enhancing Japan’s military capabilitie... [501 chars]",
            "url": "https://www.japantimes.co.jp/business/2026/02/24/economy/china-japan-companies-watch-list/",
            "image": "https://www.japantimes.co.jp/japantimes/uploads/images/2026/02/24/525408.jpg?v=3.1",
            "publishedAt": "2026-02-24T09:24:18Z",
            "lang": "en",
            "source": {
                "id": "e11720774b511205644c3670b4b2266a",
                "name": "The Japan Times",
                "url": "https://www.japantimes.co.jp"
            }
        }
    ]
}

Categories