South Africa Sports News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=sports" \
  --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": "sports", "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: "sports",
    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" => "sports",
    "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=sports&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": 58874,
    "articles": [
        {
            "id": "8fed3d4b6a341a69c746a16e562ef29a",
            "title": "UCL WRAP: United ease troubles with sensational Roma comeback, PSG rampant",
            "description": "Manchester United fought back from two goals down to beat Roma 3-2 in the Champions League on Tuesday to hand beleaguered manager Michael Carrick a reprieve, while holders Paris Saint-Germain continued their perfect start in the competition by hitting Villarreal for six.",
            "content": "Manchester United fought back from two goals down to beat Roma 3-2 in the Champions League on Tuesday to hand beleaguered manager Michael Carrick a reprieve, while holders Paris Saint-Germain continued their perfect start in the competition by hittin... [4088 chars]",
            "url": "https://supersport.com/football/news/622c941b-5470-4983-85db-92e08d9fd057/ucl-wrap-united-ease-troubles-with-sensational-roma-comeback-psg-rampant",
            "image": "https://images.supersport.com/media/13yoheby/matheus-cunha-celebrates-2611-g-1920.jpg",
            "publishedAt": "2026-11-03T23:27:39Z",
            "lang": "en",
            "source": {
                "id": "d1d8af7869508e78a0a1086727334e38",
                "name": "SuperSport",
                "url": "https://supersport.com"
            }
        },
        {
            "id": "d8bf82f31066f7a3b75fe75f8178f87f",
            "title": "Michael Carrick reaction: What did Man United boss say after stunning comeback to beat Roma?",
            "description": "Michael Carrick may have been 45 minutes from losing his job with Manchester United down 2-0 to Roma at halftime, but the Red Devils turned it all around to win 3-2 in the UFEA Champions League on Tuesday.",
            "content": "Michael Carrick may have been 45 minutes from losing his job with Manchester United down 2-0 to Roma at halftime, but the Red Devils turned it all around to win 3-2 in the UFEA Champions League on Tuesday.\nMAN UNITED 3-2 ROMA — Highlights & recap\nBel... [4309 chars]",
            "url": "https://www.nbcsports.com/soccer/news/michael-carrick-reaction-what-did-man-united-boss-say-after-stunning-comeback-to-beat-roma",
            "image": "https://nbcsports.brightspotcdn.com/dims4/default/250f63b/2147483647/strip/true/crop/4839x2722+0+231/resize/1440x810!/quality/90/?url=https%3A%2F%2Fnbc-sports-production-nbc-sports.s3.us-east-1.amazonaws.com%2Fbrightspot%2Fd8%2F61%2Fb71aa1174946b70d17e46db76ca0%2F2303375511.jpg",
            "publishedAt": "2026-11-03T23:26:15Z",
            "lang": "en",
            "source": {
                "id": "dc8f73f077072c35626eba314ee483bd",
                "name": "NBC Sports",
                "url": "https://www.nbcsports.com"
            }
        },
        {
            "id": "7ed28f6e67c10a5fee932f1b8f220a4b",
            "title": "Man Utd fightback can be 'start of something good' - Fernandes",
            "description": "Bruno Fernandes said a rally from 2-0 down to beat Roma in the Champions League can turn around Manchester United's season as he took aim at \"lies\" about his relationship with under-fire manager Michael Carrick.",
            "content": "Bruno Fernandes said a rally from 2-0 down to beat Roma in the Champions League can turn around Manchester United's season as he took aim at \"lies\" about his relationship with under-fire manager Michael Carrick.\nFernandes kickstarted the Red Devils' ... [1918 chars]",
            "url": "https://supersport.com/football/news/96878193-76c2-475d-8435-2b432dc212b5/man-utd-fightback-can-be-start-of-something-good-fernandes",
            "image": "https://images.supersport.com/media/wvofwqmx/bruno-fernandes-celebrates-2611-g-1920.jpg",
            "publishedAt": "2026-11-03T23:00:05Z",
            "lang": "en",
            "source": {
                "id": "d1d8af7869508e78a0a1086727334e38",
                "name": "SuperSport",
                "url": "https://supersport.com"
            }
        }
    ]
}

Missing a source from South Africa? Suggest a source.

South Africa Sports News API

Categories

Request and live response