Bulgaria World News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --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": "world", "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: "world",
    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" => "world",
    "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=world&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": 64504,
    "articles": [
        {
            "id": "3075136e9db30892ec37a165ea281420",
            "title": "Хаос обхвана Тирана след ожесточени протести",
            "description": "Хаос обхвана столицата на Албания след днешните протести на ученици и студенти. Протестиращите блокираха движението на автомобили в Тирана, те поставиха камъни и метални заграждения на пътните платна и влязоха в битка с полицията.",
            "content": "Хаос обхвана столицата на Албания след днешните протести на ученици и студенти. Протестиращите блокираха движението на автомобили в Тирана, те поставиха камъни и метални заграждения на пътните платна и влязоха в битка с полицията.\nОпожарени са сгради... [1923 chars]",
            "url": "https://www.segabg.com/hot/category-foreign-country/haos-obhvana-tirana-sled-ozhestocheni-protesti",
            "image": "https://www.segabg.com/sites/default/files/_sega/styles/article_sega_bar/public/2026/10/albaniya2026-10-14_22.42.41.jpg",
            "publishedAt": "2026-10-14T20:10:29Z",
            "lang": "bg",
            "source": {
                "id": "3f3bb6a9529617737fb87f102c12c24c",
                "name": "Новини СЕГА",
                "url": "https://www.segabg.com"
            }
        },
        {
            "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"
            }
        },
        {
            "id": "5b0bab468ec261aa62b13ad5138bed9e",
            "title": "Зеленски се срещна с крал Чарлз III в Лондон",
            "description": "Президентът на Украйна Володимир Зеленски проведе среща днес, 14 октомври, с краля на Обединеното кралство Чарлз III.",
            "content": "Президентът на Украйна Володимир Зеленски проведе среща днес, 14 октомври, с краля на Обединеното кралство Чарлз III. За срещата съобщи самият Зеленски с публикация в социалната мрежа X.\n\"Благодаря на Негово Величество Крал Чарлз III за аудиенцията. ... [327 chars]",
            "url": "https://www.focus-news.net/novini/mejdunarodni/Zelenski-se-sreshtna-s-kral-Charlz-III-v-London-3039802",
            "image": "https://i.id24.bg/i/3039802.webp",
            "publishedAt": "2026-10-14T17:33:02Z",
            "lang": "bg",
            "source": {
                "id": "91061f815f6eb6f98e16060e95951f97",
                "name": "ФОКУС",
                "url": "https://www.focus-news.net"
            }
        }
    ]
}

Missing a publisher from Bulgaria? Suggest a source.

Bulgaria World News API

Categories

Request and live response