Bulgaria Nation News API

Get the live top nation headlines from Bulgaria 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 nation headlines from Bulgaria. 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=nation&country=bg&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=nation" \
  --data-urlencode "country=bg" \
  --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": "nation", "country": "bg", "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: "nation",
    country: "bg",
    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" => "nation",
    "country"  => "bg",
    "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=nation&country=bg&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": 56190,
    "articles": [
        {
            "id": "1fde9629e4490e155246619d903155e0",
            "title": "Шест самолета в Европа, два от тях за София, с бомбени заплахи",
            "description": "Пътнически самолет от Лондон извърши днес непредвидено кацане на летище “Модлин” във Варшава след бомбена заплаха, а летището бе затворено до второ нареждане, съобщиха летищните власти, цитирани от Ройтерс. Междувременно друг самолет от Копенхаген се проверява на летище “Шопен” във Варшава.  Службите за сигурност проверяват сигнала за заплахата на летище…",
            "content": "Шест пътнически самолета бяха проверени във вторник в Италия, Испания, Полша и България след анонимни сигнали за бомби на борда. Взривни устройства не са открити в нито един от тях, предаде Би Би Си. Два от полетите са излетели от Великобритания. Зас... [2960 chars]",
            "url": "https://www.mediapool.bg/evropa/shest-samoleta-v-evropa-dva-ot-tyah-za-sofiya-s-bombeni-zaplahi/",
            "image": "https://www.mediapool.bg/evropa/shest-samoleta-v-evropa-dva-ot-tyah-za-sofiya-s-bombeni-zaplahi/social-image.jpg/",
            "publishedAt": "2026-11-03T23:03:54Z",
            "lang": "bg",
            "source": {
                "id": "d7c0a225633d43579003333b0be0bfce",
                "name": "Mediapool.bg",
                "url": "https://www.mediapool.bg"
            }
        },
        {
            "id": "918b9338df76b749b46f2f95b1892932",
            "title": "Петър Волгин: Има политици, които искат война",
            "description": "Те знаят, че войната като свърши, са аут, казва той",
            "content": "Няма договорка между \"Възраждане\" и \"Прогресивна България\" за подкрепата на Илияна Йотова, тя говореше директно между първия и втория тур и ние споделяхме тези виждания, че България трябва да има независима политика.\nТова заяви евродепутатът и кандид... [3325 chars]",
            "url": "https://www.dnes.bg/a/1-bulgaria/741100-petar-volgin-ima-polititsi-koito-iskat-voyna-takiva-sa-zelenski-ursula",
            "image": "https://www.dnes.bg/media/files/resized/article/1280x720/fe2/addf53da1de54578229781a73901efe2-77bf86bc-80b5-4faa-b6e9-d4d07f2461b5.jpeg",
            "publishedAt": "2026-11-03T20:50:00Z",
            "lang": "bg",
            "source": {
                "id": "d7f91265ddb9fbf1024b4ef7e4af7f36",
                "name": "Dnes.bg",
                "url": "https://www.dnes.bg"
            }
        },
        {
            "id": "cd77ce6045438255d874d3ba6b34fe3d",
            "title": "Александър Йорданов: България трябва да изпрати военнослужещи в Украйна",
            "description": "Как изпратихме свои войници в Ирак, в Камбоджа, но не можем в Одеса, пита той",
            "content": "България трябва да изпрати военнослужещи в Украйна като част от евентуална мироопазваща мисия и да участва активно в \"Коалицията на желаещите\". Това заяви бившият председател на Народното събрание и знакова фигура на СДС Александър Йорданов в предава... [4715 chars]",
            "url": "https://www.dnes.bg/a/1-bulgaria/741099-aleksandar-yordanov-balgariya-tryabva-da-izprati-voennosluzheshti-v-ukrayna",
            "image": "https://www.dnes.bg/media/files/resized/article/1280x720/e0e/5acbf801f66bf65a35b4356c65f2ce0e-a88a6034-51e6-4dec-ae22-bf55b7ef839d.jpeg",
            "publishedAt": "2026-11-03T20:30:00Z",
            "lang": "bg",
            "source": {
                "id": "d7f91265ddb9fbf1024b4ef7e4af7f36",
                "name": "Dnes.bg",
                "url": "https://www.dnes.bg"
            }
        }
    ]
}

Missing a source from Bulgaria? Suggest a source.

Bulgaria Nation News API

Categories

Request and live response