New Zealand World News API

Get the live top world headlines from New Zealand with one request to the Top Headlines endpoint of GNews API. Headlines are based on Google News rankings and returned as JSON.

Get API key

Request and live response

This request returns the current top world headlines from New Zealand. The response below is live: it was fetched when this page loaded. Every parameter is described in the Top Headlines endpoint documentation.

GET https://gnews.io/api/v4/top-headlines?category=world&country=nz&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --data-urlencode "country=nz" \
  --data-urlencode "apikey=YOUR_API_KEY"

import requests

API_KEY = "YOUR_API_KEY"

response = requests.get(
    "https://gnews.io/api/v4/top-headlines",
    params={"category": "world", "country": "nz", "apikey": API_KEY},
    timeout=10,
)
response.raise_for_status()

for article in response.json()["articles"]:
    print(article["title"])

const API_KEY = "YOUR_API_KEY";

const params = new URLSearchParams({
    category: "world",
    country: "nz",
    apikey: API_KEY,
});

const response = await fetch(`https://gnews.io/api/v4/top-headlines?${params}`);
if (!response.ok) {
    throw new Error(`Request failed: ${response.status}`);
}

const { articles } = await response.json();
for (const article of articles) {
    console.log(article.title);
}

On the Free plan, browsers can only call the API from localhost: see Using the API in the FAQ.

<?php

$apiKey = "YOUR_API_KEY";

$params = http_build_query([
    "category" => "world",
    "country"  => "nz",
    "apikey"   => $apiKey,
]);

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $params);
if ($response === false) {
    throw new RuntimeException("Request failed");
}

$data = json_decode($response, true);
foreach ($data["articles"] as $article) {
    echo $article["title"] . PHP_EOL;
}

using System.Net.Http.Json;

const string ApiKey = "YOUR_API_KEY";

using var client = new HttpClient();

var url = $"https://gnews.io/api/v4/top-headlines?category=world&country=nz&apikey={ApiKey}";
var data = await client.GetFromJsonAsync<ApiResponse>(url)
           ?? throw new InvalidOperationException("Empty response");

foreach (var article in data.Articles)
{
    Console.WriteLine(article.Title);
}

record ApiResponse(List<Article> Articles);
record Article(string Title);

200 OK · Live JSON response

{
    "totalArticles": 9440,
    "articles": [
        {
            "id": "7e6931df6f4118bf070fe1dcb318ce31",
            "title": "Florida jet crash: Plane parts found as far as 6km from crash site",
            "description": "Investigators found part of the tail of the jet that crashed in South Florida nearly 2km from the crater caused when the aircraft made impact.",
            "content": "Investigators found part of the tail of the jet that crashed in South Florida nearly 2km from the crater caused when the aircraft made impact.\nNational Transportation Safety Board member Tom Chapman said during a news conference Wednesday that the di... [4404 chars]",
            "url": "https://www.1news.co.nz/2026/11/04/florida-jet-crash-plane-parts-found-as-far-as-6km-from-crash-site/",
            "image": "https://tvnz-1-news-prod.cdn.arcpublishing.com/resizer/v2/police-stand-near-the-scene-of-a-plane-crash-in-greenacres-f-UNRVOP4TXRHYZOUI5GXMSLBSBE.png?auth=9daf50c6054236dadf6bc1eeca958cb3d1ed585cdb2b15608cf08d7de81bdf88&quality=70&width=600&height=315&focal=1089%2C571",
            "publishedAt": "2026-11-03T22:24:32Z",
            "lang": "en",
            "source": {
                "id": "9b3921fcecffb9abd8da549eacb0a84a",
                "name": "1News",
                "url": "https://www.1news.co.nz"
            }
        },
        {
            "id": "837beb8854fa91d3342b615fe7f0d14f",
            "title": "Kiwi injured in fatal helicopter collision at Mt Everest",
            "description": "Two helicopters collided while trying to land just below Mount Everest's base camp.",
            "content": "Two helicopters collided Tuesday while trying to land just below Mount Everest's base camp, killing at least one person and injuring two others, officials said.\nThe aircraft were ferrying trekkers who had been hiking up to Everest base camp during Ne... [1223 chars]",
            "url": "https://www.1news.co.nz/2026/11/03/kiwi-injured-in-fatal-helicopter-collision-at-mt-everest/",
            "image": "https://tvnz-1-news-prod.cdn.arcpublishing.com/resizer/v2/mt-everest-6X36OSLFORHYNJZSGCTSYKLZBY.jpg?auth=269bdded9ba22af85c69b0d8b331e723cb330fafbaabe1440004c7d6ca08d2c8&quality=70&width=600&height=315&focal=991%2C752",
            "publishedAt": "2026-11-03T20:15:42Z",
            "lang": "en",
            "source": {
                "id": "9b3921fcecffb9abd8da549eacb0a84a",
                "name": "1News",
                "url": "https://www.1news.co.nz"
            }
        },
        {
            "id": "b2a8f34c62621adc984f4dfd43016972",
            "title": "Officials helping New Zealander injured in Nepal helicopter crash, MFAT says",
            "description": "New Zealand consular officials in Kathmandu and New Delhi are providing assistance to a New Zealander injured in a helicopter crash in Nepal.",
            "content": "New Zealand consular officials in Kathmandu and New Delhi are providing assistance to a New Zealander injured in a helicopter crash in Nepal.\nAn Indian national was also killed after two choppers collided as they prepared to land in Nepal's Mount Eve... [311 chars]",
            "url": "https://www.rnz.co.nz/news/world/2328352/officials-helping-new-zealander-injured-in-nepal-helicopter-crash-mfat-says",
            "image": "https://media.rnztools.nz/rnz/image/upload/s--aUmrqC3n--/t_tohu-badge-facebook/f_auto/q_auto/4JFR11N_AFP__20261103__D69B4KG__v1__HighRes__NepalAccident_jpg",
            "publishedAt": "2026-11-03T19:28:38Z",
            "lang": "en",
            "source": {
                "id": "79971a6b38016604095f88394b17172a",
                "name": "RNZ",
                "url": "https://www.rnz.co.nz"
            }
        }
    ]
}

Missing a source from New Zealand? Suggest a source.

New Zealand World News API

Categories

Request and live response