Bulgaria News API

Get the live top headlines from Bulgaria with one request to the Top Headlines endpoint of GNews API. Stories are selected by Google News rankings and returned as clean JSON.

Get your free 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);
}

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "general",
    "country"  => "bg",
    "apikey"   => $apiKey,
]);

$response = file_get_contents("https://gnews.io/api/v4/top-headlines?" . $query);
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": 98684,
    "articles": [
        {
            "id": "1d713e31e240d66e9d9265facf595307",
            "title": "Не ми е нужен мъж у дома: Как войната променя нагласите на руските феминистки?",
            "description": "В Русия има все по-малко мъже",
            "content": "Оксана, феминистка и активистка от Челябинска област в Урал, очакваше животът на руските жени \"да става все по-тежък“, след като през 2022 г. президентът Владимир Путин започна пълномащабна война срещу Украйна.\nОттогава някогашната оживена феминистка... [6127 chars]",
            "url": "https://www.dnes.bg/a/2-svyat/738507-ne-mi-e-nuzhen-mazh-u-doma-kak-voynata-promenya-naglasite-na-ruskite-feministki",
            "image": "https://www.dnes.bg/media/files/resized/article/1280x720/85a/6e34403d8a094b9e8d136bb74c38085a-2026-09-22t151601z-1440035676-rc26gnas2dq6-rtrmadp-3-russia-czech-protester.JPG",
            "publishedAt": "2026-10-14T20:00:00Z",
            "lang": "bg",
            "source": {
                "id": "d7f91265ddb9fbf1024b4ef7e4af7f36",
                "name": "Dnes.bg",
                "url": "https://www.dnes.bg"
            }
        },
        {
            "id": "0f7103efe23ae8d7fe78cc95b268908e",
            "title": "Проф. Чуков: Черно море и Ормузкият проток са заложници на две големи войни",
            "description": "Тази вълна от нападения с морски и въздушни дронове срещу търговски кораби в изключителната икономическа зона на България се наблюдава през последните две седмици.",
            "content": "Тази вълна от нападения с морски и въздушни дронове срещу търговски кораби в изключителната икономическа зона на България се наблюдава през последните две седмици. Само за годината са ударени дронове над 200 търговски кораба в плавателната част на Че... [3731 chars]",
            "url": "https://www.focus-news.net/novini/Bylgaria/Prof-Chukov-Cherno-more-i-Ormuzkiyat-protok-sa-zalozhnici-na-dve-golemi-voini-3039808",
            "image": "https://i.id24.bg/i/3039808.webp",
            "publishedAt": "2026-10-14T18:19:40Z",
            "lang": "bg",
            "source": {
                "id": "91061f815f6eb6f98e16060e95951f97",
                "name": "ФОКУС",
                "url": "https://www.focus-news.net"
            }
        },
        {
            "id": "e1cfe5676fd02c9ff1995e1857de848b",
            "title": "Кои са потенциалните кандидати за президентския пост на Зеленски в Украйна?",
            "description": "Фаворит е Валерий Залужни",
            "content": "Володимир Зеленски отговори на Доналд Тръмп, след като той заяви, че Украйна се нуждае от нов президент. Лидерът в Киев незабавно прие предизвикателството - избори могат да се проведат по всяко време, стига Русия да спре огъня за 60 дни.\nВъпреки че н... [2696 chars]",
            "url": "https://www.dnes.bg/a/2-svyat/738450-koi-sa-potentsialnite-kandidati-za-prezidentskiya-post-na-zelenski-v-ukrayna",
            "image": "https://www.dnes.bg/media/files/resized/article/1280x720/bbe/11a3903240b0702ffaf1f99f82dbcbbe-b40711f0-fa9f-4f79-9ee9-66ceb77191e9.jpeg",
            "publishedAt": "2026-10-14T18:00:00Z",
            "lang": "bg",
            "source": {
                "id": "d7f91265ddb9fbf1024b4ef7e4af7f36",
                "name": "Dnes.bg",
                "url": "https://www.dnes.bg"
            }
        }
    ]
}

Missing a publisher from Bulgaria? Suggest a source.

Bulgaria News API

Categories

Request and live response