South Africa Nation News API

Get the live top nation headlines from South Africa 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 nation headlines from South Africa. 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=za&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=nation" \
  --data-urlencode "country=za" \
  --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": "za", "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: "za",
    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" => "nation",
    "country"  => "za",
    "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=nation&country=za&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": 33342,
    "articles": [
        {
            "id": "730137a7b26215894dd2afd0eb90848f",
            "title": "State claims Sibiya's lawyers interfered with witnesses",
            "description": "The State has opposed bail for Shadrack Sibiya, accusing his defence team of attempting to secure a statement from a witness.",
            "content": "JOHANNESBURG - The legal team for former Deputy National Police Commissioner Shadrack Sibiya has wrapped up its bail argument.\nSibiya's lawyer, Estelle Killian, has argued that he is not a flight risk or a threat to witnesses, emphasising that they h... [415 chars]",
            "url": "https://www.enca.com/news/state-claims-sibiyas-lawyers-interfered-witnesses",
            "image": "https://www.enca.com/sites/default/files/styles/large/public/2026-10/ED_629096.jpg.webp?itok=5rGY6BId",
            "publishedAt": "2026-10-14T19:04:32Z",
            "lang": "en",
            "source": {
                "id": "3ec23e0c9b7acd73d74ec42d9f325609",
                "name": "eNCA",
                "url": "https://www.enca.com"
            }
        },
        {
            "id": "99393b0e289f82af671d31384a195a9f",
            "title": "Three CIT robbery suspects shot and killed in KZN",
            "description": "Three suspected cash-in-transit robbers have been killed in a shootout with police and private security in Umlazi, KZN.",
            "content": "UMLAZI - Three suspected cash-in-transit robbers have been killed in a shootout with police and private security in Umlazi, KZN.\nInitially, police had reported that four suspects were shot and killed, however, this number has since been revised to th... [549 chars]",
            "url": "https://www.enca.com/news-top-stories/three-cit-robbery-suspects-shot-and-killed-kzn",
            "image": "https://www.enca.com/sites/default/files/styles/large/public/2026-10/Screenshot%202026-10-14%20200238.png.webp?itok=wJJ_dVoQ",
            "publishedAt": "2026-10-14T18:39:32Z",
            "lang": "en",
            "source": {
                "id": "3ec23e0c9b7acd73d74ec42d9f325609",
                "name": "eNCA",
                "url": "https://www.enca.com"
            }
        },
        {
            "id": "157af7108466480f6667cc5bb47ed5bf",
            "title": "BMA official nabbed with 22 stamped passports and cash",
            "description": "The passports had allegedly been transported from Limpopo to Ladybrand.",
            "content": "A 56-year-old Border Management Authority (BMA) official stationed at the Maseru Port of Entry has been arrested following an intelligence driven operation.\nThe operation was conducted by BMA Integrity Management Unit and other role players.\nDeputy A... [1247 chars]",
            "url": "https://www.sabcnews.com/sabcnews/1168737-2/",
            "image": "https://www.sabcnews.com/sabcnews/wp-content/uploads/2026/10/pass-9.jpg",
            "publishedAt": "2026-10-14T18:24:44Z",
            "lang": "en",
            "source": {
                "id": "bbac417191f606fec4ab93fecf31486b",
                "name": "SABC News",
                "url": "https://www.sabcnews.com"
            }
        }
    ]
}

Missing a publisher from South Africa? Suggest a source.

South Africa Nation News API

Categories

Request and live response