South Africa News API

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

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" => "general",
    "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=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": 43056,
    "articles": [
        {
            "id": "281891b3221a9268ede273abed2d046b",
            "title": "007 First Light Gets Free Trial For Select PlayStation Plus Subscribers",
            "description": "License to try.",
            "content": "Select PlayStation Plus subscribers can try 007 First Light for free via a new trial.\nThis will allow you to play the game's prologue and some of Bond's training sections, which are actually quite fun and inventive for a video game tutorial. It's a g... [817 chars]",
            "url": "https://za.ign.com/007-first-ight/244709/007-first-light-gets-free-trial-for-select-playstation-plus-subscribers",
            "image": "https://sm.ign.com/t/ign_za/news/0/007-first-/007-first-light-gets-free-trial-for-select-playstation-plus_pe73.1200.jpg",
            "publishedAt": "2026-11-04T07:28:39Z",
            "lang": "en",
            "source": {
                "id": "09d204a57e283764e26d1f2ae6907e6d",
                "name": "IGN Africa",
                "url": "https://za.ign.com"
            }
        },
        {
            "id": "92069a147db0ff93c9c220d777ae94c3",
            "title": "Democrats capture Congress in sweeping setback for Trump",
            "description": "Democrats captured Senate and House majorities, flipping Republican strongholds as voters punished Trump over economic pressures, rising fuel costs and the Iran war.",
            "content": "Democrats captured majorities in both the Senate and House on Tuesday, scoring sweeping victories that reached deep into Republican strongholds as tens of millions of voters delivered a scathing rebuke to President Donald Trump.\nThe size and breadth... [4325 chars]",
            "url": "https://www.dailymaverick.co.za/article/2026-11-04-democrats-capture-congress-in-sweeping-setback-for-trump/",
            "image": "https://cdn.dailymaverick.co.za/i/W0bDVZmsvrs0ouNq2tWe8MAO5Jg=/800x0/smart/filters:strip_exif()/file/attachments/orphans/Brooks-midtermsNow-1_785656.jpg",
            "publishedAt": "2026-11-04T06:22:30Z",
            "lang": "en",
            "source": {
                "id": "014a1578e982d66b3e13de65ae3a28a6",
                "name": "Daily Maverick",
                "url": "https://www.dailymaverick.co.za"
            }
        },
        {
            "id": "84208403fda277ef7d7d22b67fc2314f",
            "title": "Nick Mallett wades into the 'age' debate that has annoyed Rassie Erasmus and why Jan-Hendrik Wessels 'is going to do a great job' for the Springboks",
            "description": "Ex-Springboks boss Nick Mallett has waded into the selection debate that left Rassie Erasmus frustrated heading into the Nations Championship.",
            "content": "Former Springboks boss Nick Mallett has waded into the selection debate that left Rassie Erasmus frustrated heading into the resumption of the Nations Championship this weekend.\nSouth Africa are in Turin preparing for their clash with Italy on Saturd... [5937 chars]",
            "url": "https://www.planetrugby.com/news/nick-mallett-wades-into-the-age-debate-that-has-annoyed-rassie-erasmus-and-why-jan-hendrik-wessels-is-going-to-do-a-great-job-for-the-springboks",
            "image": "https://d3gbf3ykm8gp5c.cloudfront.net/content/uploads/2026/11/03162450/Springboks-boss-Rassie-Erasmus-and-sub-hooker-Jan-Hendrik-Wessels-.jpg",
            "publishedAt": "2026-11-04T06:11:06Z",
            "lang": "en",
            "source": {
                "id": "8d2907da394950f69035a4520074dae5",
                "name": "Planet Rugby",
                "url": "https://www.planetrugby.com"
            }
        }
    ]
}

Missing a source from South Africa? Suggest a source.

South Africa News API

Categories

Request and live response