Botswana News API

Get the live top headlines from Botswana 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 Botswana. 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=bw&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --data-urlencode "country=bw" \
  --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": "bw", "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: "bw",
    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"  => "bw",
    "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=bw&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": 64276,
    "articles": [
        {
            "id": "acc823c404e7f5a52fff7fdb156b350e",
            "title": "Accused magistrate barred from Mahalapye Magistrate Court",
            "description": "Senior Magistrate Kedirileng Moruakgomo who faces two counts of threat to kill for threatening to kill her co-workers has been barred from entering Mahalapye Magistrate Court, as one of her bail conditions.",
            "content": "Moruakgomo is accused of threatening to kill judicial officersTshoganetso Atlamelang and Lebogang Kebeetsweng through a WhatsApp text. Appearing before Broadhurst Magistrate Goabaone Rammapudi-Lesedi today, Magistrate Moruakgomo who has been in the c... [1445 chars]",
            "url": "https://www.mmegi.bw/news/accused-magistrate-barred-from-mahalapye-magistrate-court/news",
            "image": "https://www.mmegi.bw/mmegi/uploads/images/2026/11/04/183271.jpg",
            "publishedAt": "2026-11-04T07:24:13Z",
            "lang": "en",
            "source": {
                "id": "d07390b4a618f08e49c4b4a467db70ad",
                "name": "Mmegi Online",
                "url": "https://www.mmegi.bw"
            }
        },
        {
            "id": "14b85111f1b6ff133f71826fa2748165",
            "title": "I’m being blocked from visiting friends in prison, Lubinda laments",
            "description": "FORMER PF vice-president Given Lubinda says correctional authorities have repeatedly stopped him from visiting his friends in prison, including opposition leaders Brian Mundubile and Makebi Zulu.\nLubinda says he has written to the Zambia Correctional Service to complain about being denied access",
            "content": "FORMER PF vice-president Given Lubinda says correctional authorities have repeatedly stopped him from visiting his friends in prison, including opposition leaders Brian Mundubile and Makebi Zulu. Lubinda says he has written to the Zambia Correctional... [563 chars]",
            "url": "https://diggers.news/local/2026/11/04/im-being-blocked-from-visiting-friends-in-prison-lubinda-laments/",
            "image": "https://diggers.news/wp-content/uploads/2026/01/WhatsApp-Image-2025-12-31-at-20.33.02-e1767206094789.jpeg",
            "publishedAt": "2026-11-04T06:40:02Z",
            "lang": "en",
            "source": {
                "id": "e7b7da8b43da232f158f06feb2456e46",
                "name": "News Diggers!",
                "url": "https://diggers.news"
            }
        },
        {
            "id": "a2f107eb2d1c8a0c5c587f33aef5d555",
            "title": "Herts paramedic walks final London Marathon mile six months on",
            "description": "Gareth Hopkins suffered a cardiac arrest at the 25th mile of the London Marathon in April.",
            "content": "Man walks final London Marathon mile six months on\nA runner who suffered a cardiac arrest at the 25th mile of the London Marathon has finally \"finished what I started\" - by walking the last mile, six months later.\nGareth Hopkins, 43, a paramedic from... [2979 chars]",
            "url": "https://www.bbc.com/news/articles/cmq8n9y8ex55o",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/4059/live/d30fac10-d7b8-11f1-8a3d-5320e3fab176.jpg",
            "publishedAt": "2026-11-04T05:53:05Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Missing a source from Botswana? Suggest a source.

Botswana News API

Categories

Request and live response