Flag of South Africa

South Africa News API

Get the live top headlines from South Africa with our JSON API.

Get API key for the South Africa News API

API Demonstration

This example demonstrates the HTTP request to make and the JSON response you will receive when you use the news api to get the top headlines from South Africa.

GET
https://gnews.io/api/v4/top-headlines?country=za&category=general&apikey=API_KEY
{
    "totalArticles": 10978,
    "articles": [
        {
            "id": "22030eaa5e02b8f45c53a80d466d0e13",
            "title": "thin smartwatch lands locally next month",
            "description": "The OPPO Watch S is expected in South Africa by the middle of February, but no recommended pricing has been shared as yet.",
            "content": "This week, OPPO debuted two new smartphones as part of the Reno15 series. While the new phones drew most of the attention, OPPO South Africa has another device on the way in the form of a wearable – the Watch S.\nAs the S in the name denotes, this sma... [1580 chars]",
            "url": "https://htxt.co.za/2026/01/oppos-ultra-thin-smartwatch-lands-locally-next-month/",
            "image": "https://htxt.co.za/wp-content/uploads/2026/01/oppo-watch-s-silver-gleam-header.jpg",
            "publishedAt": "2026-01-29T06:53:33Z",
            "lang": "en",
            "source": {
                "id": "ce7de280245d7e28af6bcbdfef72b8ab",
                "name": "htxt.co.za",
                "url": "https://htxt.co.za"
            }
        },
        {
            "id": "1f3755d1854d13e65545d3d36c71013a",
            "title": "Real Madrid star labelled 'the worst' after shock Benfica loss",
            "description": "Real Madrid fans have furiously hit out at Dean Huijsen and demanded he be dropped after a 4-2 loss to Benfica.",
            "content": "Real Madrid's resurgance under Alvaro Arbeloa lasted three games after a disastrous 4-2 defeat to Benfica in the Champions League on Wednesday. A shocking night at the Estadio da Luz saw Los Blancos surrender an automatic place in the last 16 of the ... [2514 chars]",
            "url": "https://therealchamps.com/real-madrid-star-huijsen-the-worst-after-shock-benfica-loss",
            "image": "https://images2.minutemediacdn.com/image/upload/c_crop,x_0,y_0,w_3611,h_2031/c_fill,w_1440,ar_1440:810,f_auto,q_auto,g_auto/images/GettyImages/mmsport/384/01kg3gc5ecyqdc6tjd2e.jpg",
            "publishedAt": "2026-01-28T23:55:12Z",
            "lang": "en",
            "source": {
                "id": "f1c3107ef939d2dfb3115998a0f9f97c",
                "name": "The Real Champs",
                "url": "https://therealchamps.com"
            }
        },
        {
            "id": "80bf8afc3ad36afc8aa0b250c0681f06",
            "title": "Liverpool, Man City and Barcelona reach Champions League last 16",
            "description": "Liverpool, Manchester City and Barcelona booked last-16 places in the Champions League on Wednesday, as holders Paris Saint-Germain and Real Madrid missed out on the top eight.",
            "content": "Liverpool, Manchester City and Barcelona booked last-16 places in the Champions League on Wednesday, as holders Paris Saint-Germain and Real Madrid missed out on the top eight.\nPremier League champions Liverpool thrashed Qarabag 6-0 in the eighth and... [4495 chars]",
            "url": "https://supersport.com/football/news/17901fb2-1075-4c6a-84b1-5165478b1e9f/liverpool-man-city-and-barcelona-reach-champions-league-last-16",
            "image": "http://localhost:8080/media/2w2pc15y/liverpool-team-260128g1920.jpg",
            "publishedAt": "2026-01-28T23:26:15Z",
            "lang": "en",
            "source": {
                "id": "d1d8af7869508e78a0a1086727334e38",
                "name": "Super Sport",
                "url": "https://supersport.com"
            }
        }
    ]
}

Categories