Ethiopia News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --data-urlencode "country=et" \
  --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": "et", "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: "et",
    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"  => "et",
    "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=et&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": 57444,
    "articles": [
        {
            "id": "50b8b299f17b852cd42b42b5c8c3f7f5",
            "title": "Real Madrid remain perfect thanks to Dumfries’ assist and another Valverde stunner in stoppage time",
            "description": "Real Madrid have also won their fourth match of the Champions League league phase, but only by the narrowest of margins. The Royal club took the lead for the first time only in stoppage time. Federico Valverde’s stunning goal immediately proved to be the winner: 2-3. Denzel Dumfries had played an important role moments earlier with his assists for Kylian Mbappé’s goal to make it 2-2.",
            "content": "Real Madrid made it four wins from four in the Champions League league phase, edging AEK 2-3 in Athens. Madrid took the lead for the first time only in stoppage time, when Federico Valverde's stunning strike settled it. Moments earlier, Denzel Dumfri... [1465 chars]",
            "url": "https://www.goal.com/en/news/real-madrid-remain-perfect-in-champions-league-thanks-to-denzel-dumfries-assist-and-a-new-federico-valverde-stunner-in-stoppage-time/blt511374fe8283b486",
            "image": "https://assets.goal.com/images/v3/blt3ab4940c0dbaf036/crop/MM5DGNZRGA5DEMBYG45G433XMU5DAORRHE2A====/GettyImages-2303037862.jpg",
            "publishedAt": "2026-11-04T19:52:03Z",
            "lang": "en",
            "source": {
                "id": "90ada3ade3c66a756d5cd36c7829c359",
                "name": "Goal.com",
                "url": "https://www.goal.com"
            }
        },
        {
            "id": "141249906cd9a5c6825420a2e0f13c9d",
            "title": "Player Ratings: Alisson Becker struggles as Liverpool are beaten by Fenerbahce",
            "description": "Fenerbahce 3-2 Liverpool: Reds Surrender Two Leads in Costly Champions League DefeatLiverpool suffered another frustrating Champions League setback as Fenerbahce came from behind twice to secure a 3-2...",
            "content": "Fenerbahce 3-2 Liverpool: Reds Surrender Two Leads in Costly Champions League Defeat\nLiverpool suffered another frustrating Champions League setback as Fenerbahce came from behind twice to secure a 3-2 victory in Istanbul, exposing familiar defensive... [3495 chars]",
            "url": "https://sports.yahoo.com/articles/player-ratings-alisson-becker-struggles-195100135.html",
            "image": "https://s.yimg.com/lo/mysterio/api/e5f5b8b495057e6efab1078aa50633d5637535ad8b99c4d744f492ee98c47023/lightyear_networkapi/resizefill_w1200_h675%3Bquality_80%3Bformat_webp/https%3A%2F%2Fmedia.zenfs.com%2Fen%2Fepl_index_articles_253%2F3f0e93896b9c22ea828efb761cdd912b.jpg",
            "publishedAt": "2026-11-04T19:51:00Z",
            "lang": "en",
            "source": {
                "id": "1213ab3f5e360256b89d3b205e3e8e48",
                "name": "Yahoo Sports",
                "url": "https://sports.yahoo.com"
            }
        },
        {
            "id": "e8f695f5fcaf05d76a82ab22fbb75164",
            "title": "Chucky Creator Don Mancini Slams Nicki Minaj for 'Vote Red' Post",
            "description": "Don Mancini fired back at Nicki Minaj after she used his creator Chucky to encourage people to \"Vote Red\" on Election Day.",
            "content": "Nicki Minaj marked Election Day with a seemingly AI-created graphic of horror movie icon Chucky in a pink suit with a pin that reads: “Vote Red.” The Republican messaging was hardly a surprise given the rapper has closely aligned herself with Donald ... [1430 chars]",
            "url": "https://variety.com/2026/film/news/chucky-nicki-minaj-vote-red-post-election-night-1236939470/",
            "image": "https://variety.com/wp-content/uploads/2026/11/MCDCUOF-EC181-Charity-Day-2026-Hosted-by-the-Cantor-Fitzgerald-Relief-Fund-at-Cantor-1000.jpg?w=1000&h=563&crop=1",
            "publishedAt": "2026-11-04T19:02:00Z",
            "lang": "en",
            "source": {
                "id": "c96d85bc8a846b5845a5420fe892ac16",
                "name": "Variety",
                "url": "https://variety.com"
            }
        }
    ]
}

Missing a source from Ethiopia? Suggest a source.

Ethiopia News API

Categories

Request and live response