New Zealand News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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" => "general",
    "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=general&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": 66706,
    "articles": [
        {
            "id": "d66e329d0a6d668d999ce0085b537fff",
            "title": "Voters deliver historic rebuke to Trump as Democrats win House and Senate",
            "description": "Democrats seized control of both the Senate and House on Tuesday (US time), scoring sweeping victories in Republican strongholds for the first time in generations as tens of millions of voters delivered a scathing rebuke to President Donald Trump.",
            "content": "By Joseph Ax, Brad Heath and Jason Lange\nDemocrats seized control of both the Senate and House on Tuesday (US time), scoring sweeping victories in Republican strongholds for the first time in generations as tens of millions of voters delivered a scat... [6739 chars]",
            "url": "https://www.rnz.co.nz/news/world/2331647/voters-deliver-historic-rebuke-to-trump-as-democrats-win-house-and-senate",
            "image": "https://media.rnztools.nz/rnz/image/upload/s--Tzu5JGbS--/t_tohu-badge-facebook/f_auto/q_auto/4JFOE3U_AFP__20261104__D6D432N__v1__HighRes__UsVoteMichigan_jpg",
            "publishedAt": "2026-11-04T08:13:46Z",
            "lang": "en",
            "source": {
                "id": "79971a6b38016604095f88394b17172a",
                "name": "RNZ",
                "url": "https://www.rnz.co.nz"
            }
        },
        {
            "id": "87d9dfb1e8f1910fe8ff73d243bd8fbc",
            "title": "Sharp rebuke for Trump as Democrats seize control of US Congress",
            "description": "Voters handed Democrats control of the Senate on Tuesday, rejecting Trump's handpicked candidates that he furiously barnstormed for.",
            "content": "Voters have delivered a significant rebuke to President Donald Trump by handing Democrats control of the Senate, rejecting his handpicked candidates that he had furiously barnstormed for in the final weeks of the midterm campaign.\nDemocratic candidat... [7128 chars]",
            "url": "https://www.1news.co.nz/2026/11/04/sharp-rebuke-for-trump-as-democrats-seize-control-of-us-congress/",
            "image": "https://tvnz-1-news-prod.cdn.arcpublishing.com/resizer/v2/resident-donald-trump-boards-air-force-one-after-speaking-at-QXFYPLWRDVCUPCUUBBTF3U37JQ.jpg?auth=d5244ed166e5f25f1ce21b1ef9836be90032a3d8f80366d12e9219220a97556a&quality=70&width=600&height=315&focal=2538%2C1658",
            "publishedAt": "2026-11-04T08:09:21Z",
            "lang": "en",
            "source": {
                "id": "9b3921fcecffb9abd8da549eacb0a84a",
                "name": "1News",
                "url": "https://www.1news.co.nz"
            }
        },
        {
            "id": "f4dd6337fae9523cdc3ef4ca325156f3",
            "title": "Election live coverage, 4 November: As it happened",
            "description": "Recap our daily live coverage of all the happenings on the 2026 election campaign trail for 4 November, 2026.",
            "content": "Recap our daily live coverage of all the happenings on the 2026 election campaign trail for 4 November, 2026.\nWe will continue to have updates, breaking news and analysis from Political Editor Jo Moir, Deputy Editor Craig McCulloch and their team thr... [250 chars]",
            "url": "https://www.rnz.co.nz/news/politics_election-2026/2326657/election-live-coverage-4-november-as-it-happened",
            "image": "https://media.rnztools.nz/rnz/image/upload/s--v3ufRqNz--/t_tohu-badge-facebook/f_auto/q_auto/4JFOZ29_Image_4_jpg",
            "publishedAt": "2026-11-04T07:00:19Z",
            "lang": "en",
            "source": {
                "id": "79971a6b38016604095f88394b17172a",
                "name": "RNZ",
                "url": "https://www.rnz.co.nz"
            }
        }
    ]
}

Missing a source from New Zealand? Suggest a source.

New Zealand News API

Categories

Request and live response