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

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "world",
    "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=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": 2826,
    "articles": [
        {
            "id": "a1d194373dec7ee69132ff395e1ddd7b",
            "title": "Cabinet approves US$650 million Kariba floating solar project as Gwanda plant remains stalled",
            "description": "CABINET has approved the implementation of a US$650 million floating solar power project on Lake Kariba, despite lingering concerns over the stalled Gwanda Solar Project, which was awarded to late businessman Wicknell Chivayo’s company, Intratrek Zimbabwe. The latest initiative comes amid questions over the lack of progress on the Gwanda project, which was approved in […]",
            "content": "CABINET has approved the implementation of a US$650 million floating solar power project on Lake Kariba, despite lingering concerns over the stalled Gwanda Solar Project, which was awarded to late businessman Wicknell Chivayo’s company, Intratrek Zim... [2710 chars]",
            "url": "https://www.newzimbabwe.com/cabinet-approves-us650-million-kariba-floating-solar-project-as-gwanda-plant-remains-stalled/",
            "image": "https://s3-eu-west-2.amazonaws.com/newzimlive/wp-content/uploads/2022/12/04140213/Kariba-Dam.jpeg",
            "publishedAt": "2026-10-14T14:24:50Z",
            "lang": "en",
            "source": {
                "id": "b5634ecb88c17024238d0aebec34ae73",
                "name": "NewZimbabwe.com",
                "url": "https://www.newzimbabwe.com"
            }
        },
        {
            "id": "b65a4d04b7b84e36fa70b1c368bb9a7f",
            "title": "Fear of a war between Ethiopia and Eritrea, 28 years after their last, has been ignited as armies from both sides get uncomfortably close to each other",
            "description": "Tensions in the eastern region of Africa continue to escalate as Ethiopia mobilizes troops to patrol its border town near neighbouring Eritrea. | Business Insider Africa",
            "content": "The recent development marks the latest show of aggression between the two countries in what could lead to a repeat of the 1998 conflict.\nDON’T MISS THIS: The world’s most powerful country just warned its citizens in Ethiopia of possible long-range a... [3685 chars]",
            "url": "https://africa.businessinsider.com/local/markets/fear-of-a-war-between-ethiopia-and-eritrea-28-years-after-their-last-has-been-ignited/pw7mh2m",
            "image": "https://ocdn.eu/pulscms-transforms/1/LyIktkpTURBXy8xMTgxNzllZWM4NzlmYTg4ZjVmZWVmNjQwZjliNTZiYy5qcGeSlQMAHs0DwM0CHJMFzQSwzQJ2",
            "publishedAt": "2026-10-14T08:30:26Z",
            "lang": "en",
            "source": {
                "id": "00e8b3d988b9e44beed452c70bcbf59f",
                "name": "Business Insider Africa",
                "url": "https://africa.businessinsider.com"
            }
        },
        {
            "id": "9d374adb0d477e1cf650dbf0c8d25a77",
            "title": "Trump, White House post video of UK man killed by tiger",
            "description": "US President Donald Trump posted disturbing footage on his Truth Social account Tuesday of a man being fatally mauled by a tiger in Britain, sparking backlash on social media.",
            "content": "US President Donald Trump posted disturbing footage on his Truth Social account Tuesday of a man being fatally mauled by a tiger in Britain, sparking backlash on social media.\nThe 41-second clip of the UK man being attacked Saturday in a wildlife par... [1688 chars]",
            "url": "https://iol.co.za/news/world/2026-10-14-trump-white-house-post-video-of-uk-man-killed-by-tiger/",
            "image": "https://iol-prod.appspot.com/image/d11cd3d1f1e247a5ca8e8a2c647cb7c690d2e134/1000/jpeg",
            "publishedAt": "2026-10-14T06:21:00Z",
            "lang": "en",
            "source": {
                "id": "08c84a5b4f8cff00c8564f66cd359e72",
                "name": "IOL",
                "url": "https://iol.co.za"
            }
        }
    ]
}

Missing a publisher from South Africa? Suggest a source.

South Africa World News API

Categories

Request and live response