New Zealand News API

Get the live top headlines from New Zealand with one request to the Top Headlines endpoint of GNews API. Stories are selected by Google News rankings and returned as clean JSON.

Get your free 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);
}

<?php

$apiKey = "YOUR_API_KEY";

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

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $query);
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": 65444,
    "articles": [
        {
            "id": "04efb7fa1ffc441c8b0bd6ed7c7f93fd",
            "title": "Dragon or dinosaur? Scaly Spyro challenging children to think about genetics",
            "description": "Dragon or dinosaur? Scaly Spyro challenging children to think about genetics",
            "content": "A desert dweller resembling a dinosaur has been captivating curious minds.\nChildren have been relishing the chance to get up close and personal with a bearded dragon called Spyro during the school holidays.\nAs Tūhura Otago Museum draws visitors to it... [2025 chars]",
            "url": "https://www.odt.co.nz/news/dunedin/the-star/dragon-or-dinosaur-scaly-spyro-challenging-children-to-think-about-genetics-fw5cv2q9",
            "image": "https://images.odt.co.nz/view/acePublic/alias/contentid/1u8h3tu6gjy4wb1x4ly/1/star8dragonbeard1-jpg.jpeg?f=3%3A2",
            "publishedAt": "2026-10-14T23:14:06Z",
            "lang": "en",
            "source": {
                "id": "9371f7f51fd8f7252ed1d882285f716a",
                "name": "ODT",
                "url": "https://www.odt.co.nz"
            }
        },
        {
            "id": "a8b75f346a9b81cf54c28ae25ade3a8a",
            "title": "Luckless job hunter Karina Atkins who applied for 300 jobs lands role after year",
            "description": "Jobhunter Karina Atkins, who has finally found work after applying for 331 roles in just over a year, says the process “wasn’t easy” but taught her...",
            "content": "She said that while it wasn’t easy, she had learned greater resilience.\n“It’s not easy but it builds resilience and I know there’s a learning in here for me ... I know there’s a reason I’ve gone through this journey.\n“People come up to me in the supe... [1126 chars]",
            "url": "https://www.nzherald.co.nz/nz/auckland/luckless-job-hunter-karina-atkins-who-applied-for-300-jobs-lands-role-after-year/36ZJUA3HQZHW5CTVTJJS7TDS7E/",
            "image": "https://www.nzherald.co.nz/resizer/v2/XQ4ULYCBGFEI7NSEREZNFAGSWA.JPG?auth=bc67bb3b0b86c2f90eea7f0ea27e19158a5436b5c81dac6c860ffc0914280421&width=1200&height=675&quality=70&focal=1516%2C837&smart=false",
            "publishedAt": "2026-10-14T22:52:30Z",
            "lang": "en",
            "source": {
                "id": "a086bc2011f6ea09f34f87b9ef0a588b",
                "name": "NZ Herald",
                "url": "https://www.nzherald.co.nz"
            }
        },
        {
            "id": "f30f96cfeee751bce1ac590f4ad3280a",
            "title": "Wintry blast plunges temps, SH3 Awakino Gorge swamped by flooding as heavy rain hits",
            "description": "Flooding has swamped and closed a North Island highway as heavy rain lashes parts of New Zealand, with more expected into the afternoon. MetService said rain...",
            "content": "MetService said heavy rain was also forecast for parts of Otago, with North Otago, Dunedin and Clutha under a heavy rain watch until 4pm today.\nMetService meteorologist Devlin Lynden said further heavy rain was possible around Wairoa and northern Bay... [2013 chars]",
            "url": "https://www.nzherald.co.nz/nz/metservice-forecast-temperatures-set-to-plunge-as-southerly-arrives-snow-possible-on-highways/OE4ACUPJZJAJZHJIEIWTDYILGA/",
            "image": "https://www.nzherald.co.nz/resizer/v2/BZI3JQ6NYFGKFBMPMVZLOVMMHM.png?auth=7a30c6a1c7642ba8ec7edcb6c33a75d080368f8add5645b6606494956572555a&width=1200&height=675&quality=70&smart=true",
            "publishedAt": "2026-10-14T22:38:20Z",
            "lang": "en",
            "source": {
                "id": "a086bc2011f6ea09f34f87b9ef0a588b",
                "name": "NZ Herald",
                "url": "https://www.nzherald.co.nz"
            }
        }
    ]
}

Missing a publisher from New Zealand? Suggest a source.

New Zealand News API

Categories

Request and live response