Australia World News API

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

Get API key for the Australia 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 Australia.

GET
https://gnews.io/api/v4/top-headlines?country=au&category=world&apikey=API_KEY
{
    "totalArticles": 160848,
    "articles": [
        {
            "id": "4617ef75f4992f311dbd5e4d8718bb08",
            "title": "Middle East crisis live: US and Iran reach peace deal as European leaders warn Tehran ‘must never acquire a nuclear weapon’",
            "description": "Initial peace deal expected to be signed in Geneva on Friday but questions remain over strait of Hormuz, Lebanon conflict and Iran’s nuclear program",
            "content": "How much sticking power will the “great deal” – as Trump has described it – have given that so many details are yet to be addressed?\nSpeaking to Australian Associated Press, Kylie Moore-Gilbert, an expert on Middle Eastern politics who spent more tha... [2024 chars]",
            "url": "https://www.theguardian.com/world/live/2026/jun/15/iran-us-peace-deal-live-updates-trump-israel-lebanon-hormuz-nuclear-program-europe-response",
            "image": "https://i.guim.co.uk/img/media/9a88096c87276acd2f8b53e1a7e60478f7d416fd/815_0_4491_3595/master/4491.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctbGl2ZS5wbmc&enable=upscale&s=c1e28fc3a9fcec8839e8d5a2dffddaee",
            "publishedAt": "2026-06-15T03:17:30Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "36ec130ea7844195f9575742481284ab",
            "title": "What do we know about the US-Iran peace deal - and what questions remain?",
            "description": "Access to the strait of Hormuz and the future of Iran’s nuclear program are among the issues that remain unclear amid a lack of detail on the agreement",
            "content": "1. The strait of Hormuz\nOn Sunday evening, Donald Trump appeared unequivocal about the status of the strait of Hormuz, declaring: “I hereby fully authorize the toll free opening of the Strait of Hormuz, and, simultaneously herewith, authorize the imm... [5081 chars]",
            "url": "https://www.theguardian.com/world/2026/jun/15/us-iran-peace-deal-terms-details-conditions-explained-what-do-we-know-hormuz-lebanon-israel-nuclear",
            "image": "https://i.guim.co.uk/img/media/473382d6de8bcc02afd19f1a01f3a93e578e1853/504_0_4492_3595/master/4492.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=cdf1180df40f63c5e654e3a6ed675304",
            "publishedAt": "2026-06-15T02:30:00Z",
            "lang": "en",
            "source": {
                "id": "558a003a7a0164e924408edec7e99f99",
                "name": "The Guardian",
                "url": "https://www.theguardian.com"
            }
        },
        {
            "id": "e3350ccdd790f25120b7b036bdceafe9",
            "title": "Trump’s deal will show how pointless his war was",
            "description": "Oil might soon flow through the Strait of Hormuz, but the damage done by Trump’s war will linger for a very long time.",
            "content": "Advertisement\nOpinion\nTrump’s deal will show how pointless his war was\nStephen BartholomeuszSenior business columnist\nJune 15, 2026 — 11:59am\nJune 15, 2026 — 11:59am\nYou have reached your maximum number of saved items.\nRemove items from your saved li... [8091 chars]",
            "url": "https://www.theage.com.au/business/markets/trump-s-deal-will-show-how-pointless-his-war-was-20260615-p606s6.html",
            "image": "https://static.ffx.io/images/$zoom_0.1226%2C$multiply_0.7554%2C$ratio_1.777778%2C$width_1059%2C$x_0%2C$y_42/t_crop_custom/q_86%2Cf_auto/t_metro_opinion_no_age_social_wm/db62badc474d7ca5788716d6d5c890158a2a086e",
            "publishedAt": "2026-06-15T01:59:48Z",
            "lang": "en",
            "source": {
                "id": "8952aa953859e9190b836f04018f5efe",
                "name": "The Age",
                "url": "https://www.theage.com.au"
            }
        }
    ]
}

Categories