New Zealand Nation News API

Get the live top nation 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 nation 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=nation&country=nz&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=nation" \
  --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": "nation", "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: "nation",
    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" => "nation",
    "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=nation&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": 46032,
    "articles": [
        {
            "id": "d0b47a433ccde0ea3827c837bf358234",
            "title": "Judge tells jury to put emotions aside as four teens face trial for Kyle Whorrall killing",
            "description": "A judge is preparing jury members to decide the verdicts of four teens on trial for the murder of American student Kyle Whorrall.",
            "content": "A judge is preparing jury members to decide the verdicts of four teens on trial for the murder of American student Kyle Whorrall.\nWhorrall was killed at a bus stop in Auckland's Meadowbank on 19 April 2025.\nFour teens pleaded not guilty to the killin... [3377 chars]",
            "url": "https://www.rnz.co.nz/news/crime-and-justice/2334665/judge-tells-jury-to-put-emotions-aside-as-four-teens-face-trial-for-kyle-whorrall-killing",
            "image": "https://media.rnztools.nz/rnz/image/upload/s--LMZmeI0a--/t_tohu-badge-facebook/f_auto/q_auto/4K8JMI2_kyle_whorrall_PNG",
            "publishedAt": "2026-11-04T01:00:43Z",
            "lang": "en",
            "source": {
                "id": "79971a6b38016604095f88394b17172a",
                "name": "RNZ",
                "url": "https://www.rnz.co.nz"
            }
        },
        {
            "id": "936b2c7fb1ca961862a73573c75482bf",
            "title": "Nine children sent to Wellington Hospital after school bus blows a head gasket",
            "description": "Nine students were taken to Wellington Hospital after a bus travelling to Te Papa blew a head gasket. The school bus carrying 44 Wainuiomata Primary School...",
            "content": "Assistant district commander Matt Franklin said fumes from the blown gasket had caused respiratory and stomach pains.\n“There’s been fumes inside the cabin of the bus and [the students] were transferred to another bus. Some of them have presented with... [590 chars]",
            "url": "https://www.nzherald.co.nz/nz/children-unwell-after-incident-involving-bus-and-unknown-substance-in-wellington/D4UF5Z6VDJDHBJWXHTPKFWCTN4/",
            "image": "https://www.nzherald.co.nz/resizer/v2/ZVIEQRU4MNBOFLH72LPI7J5RBU.jpg?auth=368407a68e0236d78bd963410ff4ad4bdaec518f0b541d3abbc9005b30b111c6&width=1200&height=675&quality=70&focal=554%2C337&smart=false",
            "publishedAt": "2026-11-04T00:28:17Z",
            "lang": "en",
            "source": {
                "id": "a086bc2011f6ea09f34f87b9ef0a588b",
                "name": "NZ Herald",
                "url": "https://www.nzherald.co.nz"
            }
        },
        {
            "id": "2bcb4f5e4d31d7c42fb61ce74f34ac78",
            "title": "Ten taken to Wellington Hospital due to fumes in bus on school trip",
            "description": "Students and teachers from Wainuiomata Primary School were travelling into Wellington for a kapa haka performance when the bus blew a head gasket.",
            "content": "Emergency services have responded to central Wellington this morning after a bus carrying Wainuiomata Primary School pupils blew a head gasket and fumes affected those on board.\n1News footage from the scene on Cable St showed emergency services inclu... [1745 chars]",
            "url": "https://www.1news.co.nz/2026/11/04/ten-taken-to-wellington-hospital-due-to-fumes-in-school-bus/",
            "image": "https://tvnz-1-news-prod.cdn.arcpublishing.com/resizer/v2/emergency-services-work-at-the-scene-outside-of-te-papa-TGKVH7ZBTZDARH5MM3RHAH5PUY.jpg?auth=ea009333c026cf6ac89d2eb2224036a5cbc5463d286225d1344240b4811dbd8b&quality=70&width=600&height=315&focal=926%2C407",
            "publishedAt": "2026-11-04T00:05:29Z",
            "lang": "en",
            "source": {
                "id": "9b3921fcecffb9abd8da549eacb0a84a",
                "name": "1News",
                "url": "https://www.1news.co.nz"
            }
        }
    ]
}

Missing a source from New Zealand? Suggest a source.

New Zealand Nation News API

Categories

Request and live response