Bulgaria World News API

Get the live top world 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 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);
}

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" => "world",
    "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=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": 71106,
    "articles": [
        {
            "id": "f2757f220be117f4585d957db7f1b496",
            "title": "Сделката на Тод Боели за чуждите активи на „Лукойл“ ще е с размяна на ценни книжа",
            "description": "Консорциум, воден от американския милиардер Тод Боели, подготвя придобиване на международните активи на санкционираната руска петролна компания „Лукойл“ (Lukoil) чрез размяна на ценни книжа, предаде Ройтерс, позовавайки се на четирима източници, близки до процеса. Според тях сделката може да бъде сключена в рамките на няколко седмици. Банка, действаща от името…",
            "content": "Консорциум, воден от американския милиардер Тод Боели, подготвя придобиване на международните активи на санкционираната руска петролна компания \"Лукойл\" (Lukoil) чрез размяна на ценни книжа, предаде Ройтерс, позовавайки се на четирима източници, близ... [3186 chars]",
            "url": "https://www.mediapool.bg/biznes/sdelkata-na-tod-boeli-za-chuzhdite-aktivi-na-lukoil-shte-e-s-razmyana-na-tsenni-knizha/",
            "image": "https://www.mediapool.bg/biznes/sdelkata-na-tod-boeli-za-chuzhdite-aktivi-na-lukoil-shte-e-s-razmyana-na-tsenni-knizha/social-image.jpg/",
            "publishedAt": "2026-11-03T23:05:10Z",
            "lang": "bg",
            "source": {
                "id": "d7c0a225633d43579003333b0be0bfce",
                "name": "Mediapool.bg",
                "url": "https://www.mediapool.bg"
            }
        },
        {
            "id": "47d8f414d6042cff5170fbd7751e54d6",
            "title": "Руснаците бягат от Путин, но се сблъскват със затворените врати на Европа",
            "description": "Шенгенските туристически визи могат да послужат като потенциален вход",
            "content": "Пълномащабното нахлуване в Украйна, предприето от Русия през 2022 г., предизвика масово напускане на руски граждани, които отказват да се подчинят на милитаристичната политика на Владимир Путин. Хората, които емигрират в Европа, бягайки от авторитари... [7166 chars]",
            "url": "https://www.dnes.bg/a/2-svyat/741027-rusnatsite-byagat-ot-putin-no-se-sblaskvat-sas-zatvorenite-vrati-na-evropa",
            "image": "https://www.dnes.bg/media/files/resized/article/1280x720/133/a50d97d675dae8572f0382bf44ef5133-0ce66854-db0c-469c-aaba-758b4f3c9c5a.jpeg",
            "publishedAt": "2026-11-03T19:32:00Z",
            "lang": "bg",
            "source": {
                "id": "d7f91265ddb9fbf1024b4ef7e4af7f36",
                "name": "Dnes.bg",
                "url": "https://www.dnes.bg"
            }
        },
        {
            "id": "8bebb11d125589669b6e2233cab3df34",
            "title": "Почина един от създателите на \"Новичок\"",
            "description": "Владимир Углев, един от създателите на нервнопаралитичното вещество „Новичок\", почина на 80-годишна възраст. За това съобщава изданието The Insider.",
            "content": "Владимир Углев, един от създателите на нервнопаралитичното вещество „Новичок“, почина на 80-годишна възраст. За това съобщава изданието The Insider. Углев е консултира The Insider при разследванията на медията относно използването на „Новичок“ – клас... [2178 chars]",
            "url": "https://www.segabg.com/hot/category-foreign-country/pochina-edin-suzdatelite-na-novichok",
            "image": "https://www.segabg.com/sites/default/files/_sega/styles/article_sega_bar/public/2026/11/viber_image_2026-11-03_21-12-24-245.jpg",
            "publishedAt": "2026-11-03T19:23:05Z",
            "lang": "bg",
            "source": {
                "id": "3f3bb6a9529617737fb87f102c12c24c",
                "name": "Новини СЕГА",
                "url": "https://www.segabg.com"
            }
        }
    ]
}

Missing a source from Bulgaria? Suggest a source.

Bulgaria World News API

Categories

Request and live response