Nigeria News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --data-urlencode "country=ng" \
  --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": "ng", "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: "ng",
    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"  => "ng",
    "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=ng&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": 90026,
    "articles": [
        {
            "id": "302c2a43452f2ec0badfe1b30a3627f3",
            "title": "Persistent Headaches May Signal Brain Tumour - Neurosurgeon Warns",
            "description": "A neurosurgeon, Dr Charles Ugwuanyi, has warned Nigerians against dismissing persistent headaches as ordinary pain.",
            "content": "He said they could sometimes be symptoms of serious medical conditions, including brain tumours and aneurysms. Ugwuanyi, the chief medical director of Wellington Hospital, Abuja, said people who experience recurring headaches, particularly those that... [2336 chars]",
            "url": "https://ng.headtopics.com/news/persistent-headaches-may-signal-brain-tumour-neurosurgeon-89526473",
            "image": "https://i.headtopics.com/images/2026/11/4/leadershipnga/persistent-headaches-may-signal-brain-tumour-neuro-persistent-headaches-may-signal-brain-tumour-neuro-7B5FF3CEF3DEAF9CB6F717B828ACB614-16x9.webp",
            "publishedAt": "2026-11-04T07:49:00Z",
            "lang": "en",
            "source": {
                "id": "ee8b2a702775bd42738e710a6722f6bb",
                "name": "Head Topics",
                "url": "https://ng.headtopics.com"
            }
        },
        {
            "id": "b0e116f8f425429a635745a90f481198",
            "title": "Abdul El-Sayed becomes first Muslim elected US senator",
            "description": "Democrat Abdul El-Sayed has made history as the first Muslim elected to the US Senate after defeating Republican Mike Rogers in Michigan's midterm election",
            "content": "Democrat Abdul El-Sayed has made history as the first Muslim elected to the United States Senate after defeating former Republican Representative Mike Rogers in Michigan’s closely watched midterm election.\nEl-Sayed’s victory, projected by US media on... [2821 chars]",
            "url": "https://punchng.com/democrat-abdul-el-sayed-becomes-first-muslim-elected-us-senator/",
            "image": "https://cdn.punchng.com/wp-content/uploads/2026/11/04083224/IMG_8922_1793777544.webp",
            "publishedAt": "2026-11-04T07:35:44Z",
            "lang": "en",
            "source": {
                "id": "2881b10152726230ad56a8b1c0fa1653",
                "name": "Punch Newspapers",
                "url": "https://punchng.com"
            }
        },
        {
            "id": "3c87fb8f35380619ebf59fde9d155e29",
            "title": "Barcelona star Lamine Yamal breaks Kylian Mbappe's teenage Champions League goalscoring record after Aston Villa masterclass",
            "description": "Lamine Yamal has become the highest-scoring teenager in Champions League history, surpassing Kylian Mbappe's record with his 14th goal against Aston Villa.",
            "content": "Yamal rewrites European history\nBarca star Yamal made history against Aston Villa on Tuesday evening, officially becoming the highest-scoring player under the age of 20 in the history of the Champions League.\nHis crucial latest strike took his impres... [1966 chars]",
            "url": "https://www.goal.com/en/news/barcelona-lamine-yamal-breaks-kylian-mbappe-champions-league-goal-record/blt2cb89fea4387675b",
            "image": "https://assets.goal.com/images/v3/getty-2302923274/crop/MM5DIMBQGA5DEMRVGA5G433XMU5DMNRUHI3TGNQ=/GettyImages-2302923274.jpg",
            "publishedAt": "2026-11-04T07:34:30Z",
            "lang": "en",
            "source": {
                "id": "90ada3ade3c66a756d5cd36c7829c359",
                "name": "Goal.com",
                "url": "https://www.goal.com"
            }
        }
    ]
}

Missing a source from Nigeria? Suggest a source.

Nigeria News API

Categories

Request and live response