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. 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 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);
}

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "world",
    "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=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": 9062,
    "articles": [
        {
            "id": "f9844f42e6df538ce1487cccf67ba2d5",
            "title": "Zacharia's debut shows the pitfalls, possibilities of White House press sec role",
            "description": "Katie Zacharia, the new White House press secretary, faced reporters for a brief first turn at the lectern.",
            "content": "President Donald Trump's new press secretary stepped to the podium, the eyes of a packed room of journalists — and many in their audiences — upon her. She smiled broadly at the sea of faces both probing and friendly. With that, Katie Zacharia went li... [5634 chars]",
            "url": "https://www.1news.co.nz/2026/10/15/zacharias-debut-shows-the-pitfalls-possibilities-of-white-house-press-sec-role/",
            "image": "https://tvnz-1-news-prod.cdn.arcpublishing.com/resizer/v2/white-house-press-secretary-katie-zacharia-speaks-with-repor-6AO3KHY2GVBNTE2AIWWKTH5L2M.jpg?auth=c9ebedb1a93dabcbeaa1f7995a9ad9d5c20016feeee1e22305a7f3107e90488a&quality=70&width=600&height=315&focal=1609%2C1129",
            "publishedAt": "2026-10-14T20:04:44Z",
            "lang": "en",
            "source": {
                "id": "9b3921fcecffb9abd8da549eacb0a84a",
                "name": "1News",
                "url": "https://www.1news.co.nz"
            }
        },
        {
            "id": "d50114f22fd651a3d55bee935739dd6e",
            "title": "Russell Brand a 'ruthless, calculated sexual predator', London court hears",
            "description": "A \"ruthless, calculated and manipulative sexual predator\". That is how the Crown Prosecutor has described British entertainer Russell Brand in her opening address at his trial for multiple sex offences.",
            "content": "The prosecution has made its opening statement in Russell Brand's trial for numerous sex offences.\nIn London on Wednesday, the court was told women were \"simply a means to an end\" for the entertainer.\nThe trial is expected to last several weeks.\nA \"r... [4219 chars]",
            "url": "https://www.rnz.co.nz/news/world/1917198/russell-brand-a-ruthless-calculated-sexual-predator-london-court-hears",
            "image": "https://media.rnztools.nz/rnz/image/upload/s--KnNmlj3L--/t_tohu-badge-facebook/f_auto/q_auto/4JGQDTQ_AFP__20261014__D38H2NL__v2__HighRes__BritainCelebrityCourtAssaultBrand_jpg",
            "publishedAt": "2026-10-14T19:05:48Z",
            "lang": "en",
            "source": {
                "id": "79971a6b38016604095f88394b17172a",
                "name": "RNZ",
                "url": "https://www.rnz.co.nz"
            }
        },
        {
            "id": "952778956a6a40fd829b9d65dddd96f0",
            "title": "UK prosecutor tells jury Russell Brand is a ‘sexual predator’",
            "description": "Comedian Russell Brand was a “sexual predator” who was “ruthless, calculated and manipulative” when targeting women for sex, a British prosecutor told a UK...",
            "content": "Brand was not deterred when some of the women said no, she said, adding his desire for sex was “indiscriminate and voracious”.\nHe used charm and comic talents when he wanted something but would then be “demanding and entitled ... childlike in his exp... [3019 chars]",
            "url": "https://www.nzherald.co.nz/world/uk-prosecutor-tells-jury-russell-brand-is-a-sexual-predator/NUGRBPSH4BAKXASJT6YIIDJ3DE/",
            "image": "https://www.nzherald.co.nz/resizer/v2/ZCT55GRE2ZFWBG5GUXV6KQ7M34.jpg?auth=63fe57cb576b09fbdbef163b4940d474b726200d82a7f6d7a9aa27fb7520ed88&width=1200&height=675&quality=70&focal=2226%2C992&smart=false",
            "publishedAt": "2026-10-14T16:48:49Z",
            "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 World News API

Categories

Request and live response