Bulgaria News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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" => "general",
    "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=general&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": 90816,
    "articles": [
        {
            "id": "113d9a5ebf95d47a15553fde5439a983",
            "title": "Куня вдъхнови Манчестър Юнайтед за луд обрат срещу Рома и спаси Карик",
            "description": "Манчестър Юнайтед постигна впечатляващ обрат от 0:2 до 3:2 срещу Рома на „Олд Трафорд“ в двубой от четвъртия кръг на основната фаза в",
            "content": "Манчестър Юнайтед постигна впечатляващ обрат от 0:2 до 3:2 срещу Рома на „Олд Трафорд“ в двубой от четвъртия кръг на основната фаза в Шампионската лига. Матиас Суле откри в 11-ата минута, а Дониел Мален удвои от дузпа в 17-ата. След почивката Бруно Ф... [10649 chars]",
            "url": "https://gong.bg/football-sviat/shampionska-liga/kunia-vdyhnovi-manchestyr-iunajted-za-lud-obrat-sreshtu-roma-i-spasi-karik-912141",
            "image": "https://m3.netinfo.bg/media/images/51406/51406705/960-600-manchestyr-iunajted-roma.jpg",
            "publishedAt": "2026-11-03T22:27:36Z",
            "lang": "bg",
            "source": {
                "id": "79f783bf1f2e1071735bea55f7ffcfa4",
                "name": "Gong.bg",
                "url": "https://gong.bg"
            }
        },
        {
            "id": "82d29929f981689c137a4d192f05a628",
            "title": "Юнайтед сложи край на черната серия с откачен еврообрат за едно полувреме",
            "description": "3:2 за \"дяволите\" срещу Рома в мач с пребита дузпа и червен картон",
            "content": "Манчестър Юнайтед постигна впечатляващ и драматичен успех с 3:2 над Рома в мач от четвъртия кръг в Шампионската лига.\nПо този начин английският гранд прекъсна серията си от девет последователни мача без победа, като също така спаси мениджъра си Майкъ... [812 chars]",
            "url": "https://corner.dir.bg/futbol/yunayted-slozhi-kray-na-chernata-seriya-s-otkachen-evroobrat-za-edno-poluvreme",
            "image": "https://static.dir.bg/uploads/images/2026/11/03/3044004/800x480.jpg?_=1793746095",
            "publishedAt": "2026-11-03T22:15:38Z",
            "lang": "bg",
            "source": {
                "id": "1c119d7ad1eaab96922a0a0c23a63e37",
                "name": "Dir.bg",
                "url": "https://corner.dir.bg"
            }
        },
        {
            "id": "a208e3adcd49fec430928eb180e0ab9e",
            "title": "Всичи резултати и голмайстори от Шампионска лига",
            "description": "Мачовете от вторник вечер в основната фаза на Шампионската лига вече са в историята, а четвъртият кръг на турнира предложи очакваното зрелище и доста",
            "content": "Мачовете от вторник вечер в основната фаза на Шампионската лига вече са в историята, а четвъртият кръг на турнира предложи очакваното зрелище и доста изразителни резултати. Европейските колоси не допуснаха изненади и записаха категорични победи в сво... [546 chars]",
            "url": "https://gong.bg/football-sviat/shampionska-liga/vsichi-rezultati-i-golmajstori-ot-shampionska-liga-912127",
            "image": "https://m4.netinfo.bg/media/images/51406/51406622/960-600-shampionska-liga.jpg",
            "publishedAt": "2026-11-03T21:56:15Z",
            "lang": "bg",
            "source": {
                "id": "79f783bf1f2e1071735bea55f7ffcfa4",
                "name": "Gong.bg",
                "url": "https://gong.bg"
            }
        }
    ]
}

Missing a source from Bulgaria? Suggest a source.

Bulgaria News API

Categories

Request and live response