Flag of the 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": 74649,
    "articles": [
        {
            "title": "France to sue student it accuses of falsely accusing principal of forcibly removing headscarf",
            "description": "A French high school student is being sued by the government for falsely accusing her former principal of assaulting her after he made her remove her headscarf on school premises, the country’s prime minister said Wednesday.",
            "content": "Paris CNN —\nA French high school student is being sued by the government for falsely accusing her former principal of assaulting her after he made her remove her headscarf on school premises, the country’s prime minister said Wednesday.\nFrench Prime ... [3002 chars]",
            "url": "https://edition.cnn.com/2024/03/28/europe/france-sue-student-principal-accusation-headscarf-intl/index.html",
            "image": "https://media.cnn.com/api/v1/images/stellar/prod/shutterstock-editorial-14375670s.jpg?c=16x9&q=w_800,c_fill",
            "publishedAt": "2024-03-28T13:22:00Z",
            "source": {
                "name": "CNN",
                "url": "https://www.cnn.com"
            }
        },
        {
            "title": "What is ISIS-K, the group linked to the Moscow attack?",
            "description": "ISIS-K has become a global terror threat while the world has been distracted.",
            "content": "The Islamic State — the notorious group known for building a brutal regime in Iraq and Syria — has claimed responsibility for Friday’s terror attack at a Moscow concert venue that killed at least 139 people.\nISIS released graphic footage via its medi... [10455 chars]",
            "url": "https://www.vox.com/world-politics/24113965/isis-khorasan-russia-attack-terror",
            "image": "https://cdn.vox-cdn.com/thumbor/_Xr21Uh4nc0vRgYqCBWaI_O5Ui4=/0x436:6112x3636/fit-in/1200x630/cdn.vox-cdn.com/uploads/chorus_asset/file/25358521/2110551920.jpg",
            "publishedAt": "2024-03-28T12:30:00Z",
            "source": {
                "name": "Vox.com",
                "url": "https://www.vox.com"
            }
        },
        {
            "title": "No joke: UK comedian told to remove hot dog from subway poster over junk food ban",
            "description": "A British comedian has been ordered to remove a picture of a hot dog from a poster in London subway stations for his new standup show.",
            "content": "LONDON (AP) — On the London Underground, hot dogs are no joking matter.\nComedian Ed Gamble has been ordered to change a subway station poster campaign for his new standup show because the image of a hot dog violated the transit network’s ban on junk ... [1478 chars]",
            "url": "https://apnews.com/article/london-subway-comedian-hot-dog-poster-ban-be4b80462495788462323c1fac8d880d",
            "image": "https://dims.apnews.com/dims4/default/ac12322/2147483647/strip/true/crop/3500x1969+0+328/resize/1440x810!/quality/90/?url=https%3A%2F%2Fassets.apnews.com%2F19%2F1b%2Fcd368a8b5b1c8d298b0b833348ec%2F16e0ca77f80543939820bdbec38a6d52",
            "publishedAt": "2024-03-28T11:54:00Z",
            "source": {
                "name": "The Associated Press",
                "url": "https://apnews.com"
            }
        }
    ]
}

Categories