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. Headlines are based on Google News rankings and returned as JSON.

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

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" => "nation",
    "country"  => "za",
    "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=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": 36894,
    "articles": [
        {
            "id": "c7fce4f21fd7d7cfed5a267102e1c3e6",
            "title": "Joburg signs R10.3bn wage deal on eve of elections - and the next mayor is stuck with it",
            "description": "The City of Johannesburg has signed the addendum to the so-called Political Facilitation Agreement, which seeks to put all the City’s employees on the same pay grade.",
            "content": "Johannesburg has signed a R10.3 billion wage agreement with Samwu to put all municipal employees on the same pay grade.\nThis is despite Finance Minister Enoch Godongwana having forbidden the deal in a scathing leaked letter earlier this year and the ... [4413 chars]",
            "url": "https://www.news24.com/politics/joburg-signs-r103bn-wage-deal-on-eve-of-elections-and-the-next-mayor-is-stuck-with-it-20261103-1126",
            "image": "https://news24cobalt.24.co.za/resources/02ab-21fc120619d3-6bff13fc6294-1000/format/inline/image_1_.png",
            "publishedAt": "2026-11-03T18:47:55Z",
            "lang": "en",
            "source": {
                "id": "6968b9c173b8542d6a08ee81be99dfcb",
                "name": "News24",
                "url": "https://www.news24.com"
            }
        },
        {
            "id": "41538823cfe83fe684fc5493dbd1977a",
            "title": "ANC members lose Electoral Court battle to overturn Eastern Cape candidate lists",
            "description": "The ANC has won a legal challenge brought by two of its Eastern Cape members who wanted the party’s candidate lists declared invalid.",
            "content": "The ANC has emerged victorious in a legal challenge brought by two of its Eastern Cape members who wanted the party’s candidate lists for the 2026 local government elections declared invalid.\nFreedom Nkululeko Jojiyasi and Masande Mambulu took the pa... [3770 chars]",
            "url": "https://www.citizen.co.za/news/south-africa/elections/anc-electoral-court-eastern-cape-candidate-lists/",
            "image": "https://media.citizen.co.za/wp-content/uploads/2026/11/Electoral-Court-ANC-Eastern-Cape-candidate-lists.jpg",
            "publishedAt": "2026-11-03T17:30:09Z",
            "lang": "en",
            "source": {
                "id": "70fef475a9ba64f00a42970d13afd011",
                "name": "The Citizen",
                "url": "https://www.citizen.co.za"
            }
        },
        {
            "id": "a0610c389e88abbb0c1a02777a5c39be",
            "title": "Sibiya fights back against bail rejection in rape case",
            "description": "The National Prosecuting Authority (NPA) confirmed that it had received the documents and would fight the application.",
            "content": "Former deputy national police commissioner Shadrack Sibiya has launched another legal fight to secure his release from custody, challenging the latest court decision denying him bail in his rape case.\nSibiya lodged papers on Tuesday afternoon to appe... [1446 chars]",
            "url": "https://iol.co.za/news/crime-and-courts/2026-11-03-sibiya-fights-back-against-bail-rejection-in-rape-case/",
            "image": "https://iol-prod.appspot.com/image/b4091ef4f5e2d531eaed6befa75e94db0e3403da/1000/jpeg",
            "publishedAt": "2026-11-03T17:25:34Z",
            "lang": "en",
            "source": {
                "id": "08c84a5b4f8cff00c8564f66cd359e72",
                "name": "IOL",
                "url": "https://iol.co.za"
            }
        }
    ]
}

Missing a source from South Africa? Suggest a source.

South Africa Nation News API

Categories

Request and live response