New Zealand Sports News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=sports" \
  --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": "sports", "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: "sports",
    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" => "sports",
    "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=sports&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": 43824,
    "articles": [
        {
            "id": "e06c6c6317e96c931415fe9a8856630f",
            "title": "Ex-Silver Fern reveals 'devastating' impact of domestic league uncertainty",
            "description": "Erena Mikaere admits the situation has had a significant effect on her trust in Netball NZ.",
            "content": "The ongoing uncertainty surrounding the future of New Zealand’s domestic netball league continues to take its toll, with players describing the immense emotional toll of the situation and the damage to trust resulting from Netball NZ's failure to con... [3609 chars]",
            "url": "https://www.1news.co.nz/2026/11/04/ex-silver-fern-reveals-devastating-impact-of-domestic-league-uncertainty/",
            "image": "https://tvnz-1-news-prod.cdn.arcpublishing.com/resizer/v2/erena-mikaere-T5OCNLJZXNBZ3MEJZ7NIS2RD64.jpg?auth=db861a361f3a04f46980869b2a394939490f98b5baad5dceed85bae8f37c8cc5&quality=70&width=600&height=315&focal=1903%2C724",
            "publishedAt": "2026-11-04T02:19:55Z",
            "lang": "en",
            "source": {
                "id": "9b3921fcecffb9abd8da549eacb0a84a",
                "name": "1News",
                "url": "https://www.1news.co.nz"
            }
        },
        {
            "id": "4cb7846229349ce9f818fa440ab8b15c",
            "title": "Marc Ellis takes aim at rugby’s ‘pale, stale mentality’ with league growing in popularity",
            "description": "One of New Zealand’s best-loved sporting personalities has taken aim at rugby’s “pale, stale mentality” and believes the game risks falling behind league...",
            "content": "Three years on, those views have only strengthened and, speaking to the Herald about playing cricket for Team Rugby in January’s Black Clash, Ellis said the game needs an evolution from the top.\n“I’m going to get myself in trouble here being a Highla... [4640 chars]",
            "url": "https://www.nzherald.co.nz/sport/rugby/marc-ellis-takes-aim-at-rugbys-pale-stale-mentality-with-league-growing-in-popularity/premium/VNXWJXII3ZEW5DQ22CCTKSVYC4/",
            "image": "https://www.nzherald.co.nz/resizer/v2/ZYUW5N64IVFQ7ISQOYTQ4CT3LI.JPG?auth=8710d03b415c561288780ecace4a892b82bdbe170e639cd2b16aff80b31171b0&width=1200&height=675&quality=70&focal=1151%2C806&smart=false",
            "publishedAt": "2026-11-04T01:05:19Z",
            "lang": "en",
            "source": {
                "id": "a086bc2011f6ea09f34f87b9ef0a588b",
                "name": "NZ Herald",
                "url": "https://www.nzherald.co.nz"
            }
        },
        {
            "id": "04de2bb23245ba0e5b2aba9eb91543f6",
            "title": "Black Caps v India live updates: First One",
            "description": "Live updates of the first ODI between the Black Caps and India at Eden Park. While no cricketer ever wants to see a teammate go down injured, a freak...",
            "content": "Live updates of the first ODI between the Black Caps and India at Eden Park.\nWhile no cricketer ever wants to see a teammate go down injured, a freak training accident has opened a door that Black Cap Tim Seifert is perfectly positioned to walk throu... [3910 chars]",
            "url": "https://www.nzherald.co.nz/sport/cricket/black-caps/black-caps-v-india-live-updates-first-one-day-international-at-eden-park/X6U6XWOI2NA6ZLK6SYBHOVMQXA/",
            "image": "https://www.nzherald.co.nz/resizer/v2/KUTBWZBH25DHPL74GXLBHURITE.jpg?auth=8fb6745215f053a7f818180d69b7c97c0219654ee878a68dc528de4ea1cc1bc6&width=1200&height=675&quality=70&focal=607%2C313&smart=false",
            "publishedAt": "2026-11-04T01:04:46Z",
            "lang": "en",
            "source": {
                "id": "a086bc2011f6ea09f34f87b9ef0a588b",
                "name": "NZ Herald",
                "url": "https://www.nzherald.co.nz"
            }
        }
    ]
}

Missing a source from New Zealand? Suggest a source.

New Zealand Sports News API

Categories

Request and live response