Ukraine Nation News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=nation" \
  --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": "nation", "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: "nation",
    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" => "nation",
    "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=nation&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": 579754,
    "articles": [
        {
            "id": "3a79873426e429ccb0feec16b39d0391",
            "title": "США заказывают для Украины более тысячи новых крылатых ракет ERAM, - СМИ",
            "description": "Воздушные силы США ищут подрядчиков для производства новых крылатых ракет ERAM, предназначенных для Украины. Ракета должна лететь более 460 км и попад...",
            "content": "ERAM (Extended Range Attack Munition) - это небольшая крылатая ракета воздушного базирования, рассчитанная на массовое производство. В ВВС США его описывают как доступное оружие для высокоточных ударов по важным стационарным целям с безопасного расст... [1121 chars]",
            "url": "https://www.rbc.ua/ukr/news/ssha-zamovlyayut-ukrayini-ponad-tisyachu-1793744000.html",
            "image": "https://www.rbc.ua/static/img/f/a/facebook_com_831_brigada_taktichnoi___aviatsii__2_66c406070526f3348c378e452424df25_1300x820.jpg",
            "publishedAt": "2026-11-03T22:13:20Z",
            "lang": "ru",
            "source": {
                "id": "6f1ead09126f1f4738a48957e22f789c",
                "name": "РБК-Україна",
                "url": "https://www.rbc.ua"
            }
        },
        {
            "id": "5c3d0653f0d7fb496998eda2c794b4f4",
            "title": "в США ищут поставщиков",
            "description": "ВВС США обратились к оборонным подрядчикам с запросом о возможности поставки новой крылатой ракеты, предназначенной для Украины. Подробнее читайте на УНИАН.",
            "content": "ВВС США обратились к оборонным подрядчикам с запросом о возможности поставки новой крылатой ракеты, предназначенной для Украины. Потенциальным подрядчикам предлагается подробно описать свои возможности по поставке ракет большой дальности в рамках про... [2305 chars]",
            "url": "https://www.unian.net/weapons/ukraina-poluchit-bolee-1000-krylatyh-raket-eram-v-ssha-ishchut-postavshchikov-13549005.html",
            "image": "https://images.unian.net/photos/2025_06/thumb_files/620_324_1748771795-1348.jpg?1",
            "publishedAt": "2026-11-03T21:39:00Z",
            "lang": "ru",
            "source": {
                "id": "2dfc6c04cf2ef31e2ca6196dd2b0e0d1",
                "name": "УНИАН",
                "url": "https://www.unian.net"
            }
        },
        {
            "id": "3cb8a1a34f9ddab7663a03bce26e7545",
            "title": "Трамп прокоментував",
            "description": "Перші результати проміжних виборів у США надійшли з Гуаму — тихоокеанської території, де голосування починається найраніше. На острові обрали губернатора та конгресменку",
            "content": "Про повідомило The Guardian.\nЗа попередніми даними виборчої комісії Гуаму, республіканці здобули перемогу в боротьбі за посаду губернатора острова, тоді як демократи повернули собі місце делегата в Конгресі США.\nЗокрема, новим губернатором, за неофіц... [1428 chars]",
            "url": "https://espreso.tv/svit-pershi-rezultati-viboriv-u-ssha-nadiyshli-z-ostrova-guam-tramp-pobachiv-u-nikh-signal-dlya-respublikantsiv",
            "image": "https://static.espreso.tv/uploads/photobank/436000_437000/436464_Trump3_gettyimages.jpg?id=1793749903",
            "publishedAt": "2026-11-03T20:57:00Z",
            "lang": "uk",
            "source": {
                "id": "646641322db12cbee1c7c430eeba86aa",
                "name": "Espreso.tv",
                "url": "https://espreso.tv"
            }
        }
    ]
}

Missing a source from Ukraine? Suggest a source.

Ukraine Nation News API

Categories

Request and live response