South Africa News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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" => "general",
    "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=general&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": 39426,
    "articles": [
        {
            "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": "905e9aa1d338091c82a181ca8191e941",
            "title": "Three suspected robbers killed in shootout after cash-in-transit vehicle bombed near Umlazi",
            "description": "Three men allegedly linked to a cash-in-transit robbery were fatally wounded in a shooting near Umlazi Mega City. Two security guards sustained minor to moderate injuries.",
            "content": "Three men believed to be in their 20's were killed during a shootout after a cash-in-transit heist near Umlazi Mega City in KwaZulu-Natal on Wednesday.\nALS Paramedics spokesperson Garrith Jamieson said a security vehicle was reportedly bombed multipl... [2017 chars]",
            "url": "https://iol.co.za/news/crime-and-courts/2026-10-14-three-suspected-robbers-killed-in-shootout-after-cash-in-transit-vehicle-bombed-near-umlazi/",
            "image": "https://iol-prod.appspot.com/image/7385d579760723bdc1919c996e8c60d5c6b1e8ec/1000/jpeg",
            "publishedAt": "2026-10-14T17:30:14Z",
            "lang": "en",
            "source": {
                "id": "08c84a5b4f8cff00c8564f66cd359e72",
                "name": "IOL",
                "url": "https://iol.co.za"
            }
        },
        {
            "id": "b79e9ccf5135d93b3a93506acf8b00b2",
            "title": "Zuma-Sambudla says situation in MK Party worse since her departure",
            "description": "Duduzile Zuma-Sambudla claims internal rifts and leadership struggles plague MK Party",
            "content": "Former MK Party MP Duduzile Zuma-Sambudla says her father’s party has deteriorated since she and former party spokesperson Nhlamulo Ndhlela left.\nZuma-Sambudla and Ndhlela were expelled from the MK Party in June after months of internal friction. The... [2711 chars]",
            "url": "https://www.timeslive.co.za/politics/2026-10-14-zuma-sambudla-says-situation-in-mk-party-worse-since-her-departure/",
            "image": "https://www.timeslive.co.za/resizer/v2/HKDYWK3FIVIYZMVLBQCHLPRWU4.jpg?smart=true&auth=751c9d672d08f6eda9dc23de43b99357125167fa2c435a2c30eed2f2ffed4782&width=1200&height=630",
            "publishedAt": "2026-10-14T16:16:32Z",
            "lang": "en",
            "source": {
                "id": "a553059319712706bd71054b38fd052e",
                "name": "TimesLIVE",
                "url": "https://www.timeslive.co.za"
            }
        }
    ]
}

Missing a publisher from South Africa? Suggest a source.

South Africa News API

Categories

Request and live response