Botswana World News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --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": "world", "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: "world",
    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" => "world",
    "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=world&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": 15370,
    "articles": [
        {
            "id": "2113189bda44c4ef5fb84ae094191a6b",
            "title": "Nigeria: Cafa Targets N500bn African Fashion Economy, Unveils Growth Roadmap",
            "description": "The Confederation of African Fashion (CAFA) is targeting a major expansion of Africa's fashion economy, with plans to drive investment,",
            "content": "Abuja — The Confederation of African Fashion (CAFA) is targeting a major expansion of Africa's fashion economy, with plans to drive investment,\nfrom an estimated $30 billion to $500 billion at CANEX WKND 2026 in Lagos, with Nigeria positioned as a ke... [1666 chars]",
            "url": "https://allafrica.com/stories/202611040020.html",
            "image": "https://cdn.allafrica.com/static/images/structure/aa-logo-rgba-no-text-square.png",
            "publishedAt": "2026-11-04T02:48:52Z",
            "lang": "en",
            "source": {
                "id": "b2a8a9bf339fa827c13a5a389d64b625",
                "name": "allAfrica.com",
                "url": "https://allafrica.com"
            }
        },
        {
            "id": "24ce5cef5a910cd1c509ee48cc03d231",
            "title": "A national youth development strategy",
            "description": "Opinion: Nigeria needs a national youth development strategy that goes beyond political slogans to reform education and create real economic opportunities.",
            "content": "In any society, young people constitute the bedrock of development, the hope of the future and a critical demographic that should shape the direction and priorities of government policies. They represent the energy, creativity, ambition and productiv... [5654 chars]",
            "url": "https://punchng.com/beyond-empowerment-packages-a-national-youth-development-strategy/",
            "image": "https://punchng.com/wp-content/uploads/2026/06/Nigeria-flag-1_1782260001.webp",
            "publishedAt": "2026-11-04T01:41:15Z",
            "lang": "en",
            "source": {
                "id": "2881b10152726230ad56a8b1c0fa1653",
                "name": "Punch Newspapers",
                "url": "https://punchng.com"
            }
        },
        {
            "id": "1f69a8c492bd643b349111619016e417",
            "title": "Civil Society Groups Urge NASS To Pass Alcohol Control Bill, Cite Child Exposure, Rising Health Risks",
            "description": "Civil society organisations have called on the National Assembly to urgently pass the National Alcohol Control Bill, 2026, warning that increasing exposure of children and young people to alcohol is worsening public health and socio-economic challenges in Nigeria. The groups, under the auspices of the Nigeria Civil Society Convening on Alcohol Policy Advocacy Action, on...",
            "content": "0\nCivil society organisations have called on the National Assembly to urgently pass the National Alcohol Control Bill, 2026, warning that increasing exposure of children and young people to alcohol is worsening public health and socio-economic challe... [6241 chars]",
            "url": "https://independent.ng/civil-society-groups-urge-nass-to-pass-alcohol-control-bill-cite-child-exposure-rising-health-risks/",
            "image": "https://independent.ng/wp-content/uploads/2026/11/IMG-20261103-WA0089.jpg",
            "publishedAt": "2026-11-03T19:09:31Z",
            "lang": "en",
            "source": {
                "id": "0e93b94eb112629a300bade4439d7d91",
                "name": "Independent Newspaper Nigeria",
                "url": "https://independent.ng"
            }
        }
    ]
}

Missing a source from Botswana? Suggest a source.

Botswana World News API

Categories

Request and live response