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": 65483,
    "articles": [
        {
            "title": "Ukraine accuses Putin of faking meeting with 'ill' Kadyrov",
            "description": "It has been alleged that the Kremlin faked Thursday's meeting between Russian President Vladimir Putin and Chechen leader Ramzan Kadyrov, who was said to have been suffering from poor health.",
            "content": "A senior Ukrainian official suggested that the Kremlin faked a meeting between President Vladimir Putin and Chechen leader Ramzan Kadyrov, who has been rumored to be gravely ill.\nRussian state news agencies and a pro-Putin reporter released videos fr... [3925 chars]",
            "url": "https://nypost.com/2023/09/29/ukraine-accuses-putin-of-faking-meeting-with-ill-kadyrov/",
            "image": "https://nypost.com/wp-content/uploads/sites/2/2023/09/NYPICHPDPICT000053118473-1.jpg?quality=75&strip=all&w=1024",
            "publishedAt": "2023-09-29T16:03:00Z",
            "source": {
                "name": "New York Post ",
                "url": "https://nypost.com"
            }
        },
        {
            "title": "Seven countries order ammunition under EU scheme to aid Ukraine",
            "description": "Seven EU countries have ordered ammunition under a landmark European Union procurement scheme to get urgently needed artillery shells to Ukraine and replenish depleted Western stocks, according to the EU agency in charge.",
            "content": "BRUSSELS, Sept 29 (Reuters) - Seven EU countries have ordered ammunition under a landmark European Union procurement scheme to get urgently needed artillery shells to Ukraine and replenish depleted Western stocks, according to the EU agency in charge... [2497 chars]",
            "url": "https://www.reuters.com/world/europe/seven-countries-order-ammunition-under-eu-scheme-aid-ukraine-2023-09-29/",
            "image": "https://www.reuters.com/resizer/FAg1iHxrt_NtG29yfGPDF-ZdM5Y=/1200x628/smart/filters:quality(80)/cloudfront-us-east-2.images.arcpublishing.com/reuters/2IN2YQ2EHJNJJFCGKXUFRCGF4A.jpg",
            "publishedAt": "2023-09-29T14:36:00Z",
            "source": {
                "name": "Reuters",
                "url": "https://www.reuters.com"
            }
        },
        {
            "title": "Gen. Mark Milley to step aside as new Joint Chiefs chair takes command",
            "description": "Gen. Mark Milley, who is retiring after more than 40 years in the military, will be succeeded as Joint Chiefs chairman by Gen. Charles Q. Brown Jr.",
            "content": "Listen 3 min Share Comment on this story Comment\nMilley’s sometimes tumultuous four-year tenure caps a career that spanned over 43 years. His was one of the most consequential and polarizing tenures of any senior military leader in recent memory.\nHe ... [2425 chars]",
            "url": "https://www.washingtonpost.com/national-security/2023/09/29/mark-milley-charles-q-brown/",
            "image": "https://www.washingtonpost.com/wp-apps/imrs.php?src=https://arc-anglerfish-washpost-prod-washpost.s3.amazonaws.com/public/QXKH6BBEMEI6XBTSYKA4PIWJNY_size-normalized.jpg&w=1440",
            "publishedAt": "2023-09-29T13:00:00Z",
            "source": {
                "name": "The Washington Post",
                "url": "https://www.washingtonpost.com"
            }
        }
    ]
}

Categories