Flag of New Zealand

New Zealand World News API

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

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

GET
https://gnews.io/api/v4/top-headlines?country=nz&category=world&apikey=API_KEY
{
    "totalArticles": 2089,
    "articles": [
        {
            "id": "12f10800aa3e4bbd6d8209c612b82cfc",
            "title": "How Iran crisis shows NZ has failed on fuel supplies, EVs and road building",
            "description": "Analysis: For a country that imports every drop of its petrol, diesel and jet fuel, it’s a hard reminder for New Zealand, says Timothy Welch.",
            "content": "Analysis: The war in Iran and the effective closure of the Strait of Hormuz have sent oil prices past US$100 a barrel – and Kiwis flocking to fill up. Petrol just hit NZ$3 a litre and some stations have reported running dry.\nBy Timothy Welch for The ... [4495 chars]",
            "url": "https://www.1news.co.nz/2026/03/19/how-iran-crisis-shows-nz-has-failed-on-fuel-supplies-evs-and-road-building/",
            "image": "https://tvnz-1-news-prod.cdn.arcpublishing.com/resizer/v2/traffic-file-photo-getty-R2A77S5CQJED5IBFEUBAVNINXI.jpg?auth=8a4c1ca9089f926b5ccd3f2465138c96f42d7b2dd82449e8c8822b55738d95d4&quality=70&width=600&height=315&focal=2534%2C1425",
            "publishedAt": "2026-03-19T00:05:48Z",
            "lang": "en",
            "source": {
                "id": "9b3921fcecffb9abd8da549eacb0a84a",
                "name": "1News",
                "url": "https://www.1news.co.nz"
            }
        },
        {
            "id": "e47770f61ee20166798813e7ec93c376",
            "title": "Iran targets Gulf energy sites after intel chief killed",
            "description": "Iranian President Masoud Pezeshkian warned that the attack on its key energy site could have uncontrollable consequences.",
            "content": "By AFP teams in Tehran, Jerusalem, Beirut and Washington\nIran launched attacks targeting oil and gas facilities around the Gulf, lashing out after suffering yet another blow to its leadership with Israel's killing of its intelligence chief.\nThe death... [5352 chars]",
            "url": "https://www.rnz.co.nz/news/world/590033/iran-targets-gulf-energy-sites-after-intel-chief-killed",
            "image": "https://media.rnztools.nz/rnz/image/upload/s--aQpbYZTN--/t_tohu-badge-facebook/v1761680807/4JYSBQ3_AFP__20230609__089_MEI_Iran_SA_20210304_140__v1__MidRes__SouthParsGasCondensateField_jpg?_a=BACCd2AD",
            "publishedAt": "2026-03-18T21:42:12Z",
            "lang": "en",
            "source": {
                "id": "79971a6b38016604095f88394b17172a",
                "name": "RNZ",
                "url": "https://www.rnz.co.nz"
            }
        },
        {
            "id": "2fc6a134740e332cd152c8e0d2e2ce99",
            "title": "Family sue US ski resort claiming hot chocolate was too hot",
            "description": "A family are suing a US ski resort claiming the hot chocolate it sold them was too ... hot. The lawsuit in California says that when Brittany Burns and...",
            "content": "They “knew and should have known that such hot beverages posed a great hazard of causing just this type of incident and injuries”.\nRoger Dreyer, a personal injury attorney in Sacramento who is representing the Burns family, said the youngster has bee... [1205 chars]",
            "url": "https://www.nzherald.co.nz/world/family-sues-us-ski-resort-claiming-hot-chocolate-was-too-hot/LJXVCGJGJVBCHMWS54AIMAE36Q/",
            "image": "https://www.nzherald.co.nz/resizer/v2/XXANF3IXONBKROA75FVNXEEWOA.jpg?auth=6cfffe724ed95cfbfca102703db0a791b787577a3fcdbcd8221e7856807e1693&width=1200&height=675&quality=70&focal=441%2C385&smart=false",
            "publishedAt": "2026-03-18T21:15:21Z",
            "lang": "en",
            "source": {
                "id": "a086bc2011f6ea09f34f87b9ef0a588b",
                "name": "NZ Herald",
                "url": "https://www.nzherald.co.nz"
            }
        }
    ]
}

Categories