South Africa World News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --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": "world", "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: "world",
    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" => "world",
    "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=world&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": 5312,
    "articles": [
        {
            "id": "a61f221b534cf640cc73a879f919dabf",
            "title": "U.S. faces a double challenge in Africa as China dominates and Russia expands its influence by more than a quarter",
            "description": "The U.S., China, and Russia are actively reshaping geopolitical dynamics across Africa, where Washington faces a growing dual challenge as Beijing maintains economic dominance and Moscow expands its influence. | Business Insider Africa",
            "content": "According to data from the Foreign Bilateral Influence Capacity (FBIC) index compiled by the University of Denver's Pardee Institute, Russia’s share of foreign influence in Africa has expanded by more than a quarter over the past decade, rising from ... [2792 chars]",
            "url": "https://africa.businessinsider.com/local/markets/us-faces-a-double-challenge-in-africa-as-china-dominates-and-russia-expands-its/r9vwq93",
            "image": "https://ocdn.eu/pulscms-transforms/1/XEHktkpTURBXy83NmVkMGE0NThkY2E5N2E4MmMzODdkMGMyZjAyNThlYy5qcGeSlQPMewDNAuHNAZ-TBc0EsM0Cdg",
            "publishedAt": "2026-11-03T13:35:56Z",
            "lang": "en",
            "source": {
                "id": "00e8b3d988b9e44beed452c70bcbf59f",
                "name": "Business Insider Africa",
                "url": "https://africa.businessinsider.com"
            }
        },
        {
            "id": "88d0caa2e81354dca44d56a98087c6a1",
            "title": "Turkey and one of its most reliable African allies are looking to generate $5 billion in bilateral trade",
            "description": "Turkey and Libya are looking to grow their bilateral trade to $5 billion, as both countries explore new ways to deepen their economic relationship. | Business Insider Africa",
            "content": "The target was discussed during a meeting in Istanbul between Turkish Trade Minister Omer Bolat and Libya’s Minister of Economy and Trade, Suhail Aboushiha.\nBoth officials expressed their commitment to reaching the trade goal and expanding business t... [2589 chars]",
            "url": "https://africa.businessinsider.com/local/markets/turkey-and-one-of-its-most-reliable-african-allies-are-looking-to-generate-dollar5/4vff8v0",
            "image": "https://ocdn.eu/pulscms-transforms/1/d3RktkpTURBXy81ZjFlNjliYzNhNjI1OTNmYWRlMTIxYjI0NTdiZmFiZS5qcGeSlQMAzF7NC7jNBpeTBc0EsM0Cdg",
            "publishedAt": "2026-11-03T07:00:17Z",
            "lang": "en",
            "source": {
                "id": "00e8b3d988b9e44beed452c70bcbf59f",
                "name": "Business Insider Africa",
                "url": "https://africa.businessinsider.com"
            }
        },
        {
            "id": "6795c3359ab516e68340f2f8f717c193",
            "title": "Mbilizi’s fertiliser fiasco: Farmers warn of hunger as subsidy delays threaten Malawi’s next harvest",
            "description": "Agriculture Minister Roza Mbilizi is facing mounting criticism over a fertiliser rollout branded a failure as thousands of farmers fear they could be pushed ... Read the latest breaking news on Nyasa Times.",
            "content": "Agriculture Minister Roza Mbilizi is facing mounting criticism over a fertiliser rollout branded a failure as thousands of farmers fear they could be pushed towards hunger if vital inputs do not arrive before the planting rains.\nAn editorial in The N... [3036 chars]",
            "url": "https://www.nyasatimes.com/mbilizis-fertiliser-fiasco-farmers-warn-of-hunger-as-subsidy-delays-threaten-malawis-next-harvest/",
            "image": "https://www.nyasatimes.com/wp-content/uploads/FB_IMG_1790293712489.jpg",
            "publishedAt": "2026-11-03T04:50:28Z",
            "lang": "en",
            "source": {
                "id": "45ec4451aa3209075fd6796257163680",
                "name": "Nyasa Times",
                "url": "https://www.nyasatimes.com"
            }
        }
    ]
}

Missing a source from South Africa? Suggest a source.

South Africa World News API

Categories

Request and live response