Ukraine World News API

Get the live top world headlines from Ukraine 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 Ukraine. 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=ua&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --data-urlencode "country=ua" \
  --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": "ua", "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: "ua",
    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"  => "ua",
    "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=ua&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": 588844,
    "articles": [
        {
            "id": "dc998bf0a6a9075c594a410b8230b9de",
            "title": "Атака на склад Ozon в Адигейську 4 листопада",
            "description": "Логістичний центр Ozon в Адигейську атакували дрони 4 листопада 2026 року. На місці виникла пожежа. Наслідки удари по Озону сьогодні - деталі на 24 Каналі.",
            "content": "Про це повідомляють ASTRA та російські пропагандистські ЗМІ.\nпопулярні відео\nЩо відомо про наслідки атаки\nЗа інформацією компанії, усіх працівників логістичного центру оперативно евакуювали. За попередніми даними, ніхто не постраждав. Через атаку Ozo... [789 chars]",
            "url": "https://24tv.ua/ataka-sklad-ozon-adigeysku-4-listopada-shho-vidomo-vibuhi-rosiyi_n3173385",
            "image": "https://24tv.ua/resources/photos/news/202611/3173385.jpg?v=1793748560000&w=1200&h=675&fit=cover",
            "publishedAt": "2026-11-03T23:36:00Z",
            "lang": "uk",
            "source": {
                "id": "e737a8e76b161ef4526698e2ec5f60c9",
                "name": "24 Канал",
                "url": "https://24tv.ua"
            }
        },
        {
            "id": "c958c9cc1829269cc55b70c63cecd4cb",
            "title": "В США проходят промежуточные выборы (обновляется)",
            "description": "На промежуточных выборах 3 ноября граждане США переизберут депутатов Палаты представителей и треть сенаторов. DW следит за ходом событий.",
            "content": "Первые избирательные участки закрылись в штатах Индиана и Кентукки. Голосование завершилось в 18:00 по восточному времени (02:00 мск 4 ноября). Через час (в 19:00 по местному времени, 03:00 мск 4 ноября), участки прекратят работу в штатах Джорджия, Ю... [3583 chars]",
            "url": "https://www.dw.com/ru/v-ssa-prohodat-promezutocnye-vybory-v-sesti-statah-zakrylis-ucastki/live-79835610",
            "image": "https://static.dw.com/image/79779177_6.jpg",
            "publishedAt": "2026-11-03T23:08:49Z",
            "lang": "ru",
            "source": {
                "id": "67e0c40c5e24b3fec372ab75763abad9",
                "name": "DW.com",
                "url": "https://www.dw.com"
            }
        },
        {
            "id": "db1dd9ced7c1598bfc2a7bb6f058cd71",
            "title": "Король Карл III в речи на саммите Содружества назвал работорговлю позорной главой истории",
            "description": "Перед турне королевской четы по Карибам некоторые в Британии призывали короля официально принести извинения за работорговлю, но Букингемский дворец заранее объявил, что формальных извинений не будет.",
            "content": "Автор, Отдел новостей\nМесто работы, Русская служба Би-би-си\nОпубликовано 4 часа назад\nВремя чтения: 3 мин\nКороль Великобритании Карл III в речи на открытии саммита Содружества, как и ожидалось, не стал просить прощения за участие Британии в трансатла... [2017 chars]",
            "url": "https://www.bbc.com/russian/articles/ckg5jljp10e3o",
            "image": "https://ichef.bbci.co.uk/news/1200/branded_russian/3cf3/live/42789f10-d7c0-11f1-b441-2b33b063138f.jpg",
            "publishedAt": "2026-11-03T21:17:32Z",
            "lang": "ru",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        }
    ]
}

Missing a source from Ukraine? Suggest a source.

Ukraine World News API

Categories

Request and live response