Ukraine News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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);
}

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "general",
    "country"  => "ua",
    "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=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": 518600,
    "articles": [
        {
            "id": "68fdaf125288d8686f249eb150cb57ec",
            "title": "Перші огляди Grand Theft Auto VI з'являться за кілька тижнів до офіційного релізу",
            "description": "Перші оцінки та рецензії на Grand Theft Auto VI вийдуть до кінця поточного місяця, за кілька тижнів до офіційного релізу, що вказує на високу впевненість Rockstar Games як гру.",
            "content": "Ігрові видання та профільні критики зможуть опублікувати повноцінні огляди та виставити підсумкові оцінки кримінальному бойовику Grand Theft Auto VI задовго до офіційного релізу проекту. Згідно з свіжими галузевими звітами та даними інсайдерів, забор... [1570 chars]",
            "url": "https://uk.gamegpu.com/news/igry/pervye-obzory-grand-theft-auto-vi-poyavyatsya-za-neskolko-nedel-do-ofitsialnogo-reliza",
            "image": "https://gamegpu.com/images/1_2026/NEWS/Q4/okt/15/Image_262qls262qls262q_ggpu.webp#joomlaImage://local-images/1_2026/NEWS/Q4/okt/15/Image_262qls262qls262q_ggpu.webp?width=1920&height=1080",
            "publishedAt": "2026-10-14T23:54:37Z",
            "lang": "uk",
            "source": {
                "id": "d4a46ced10b24e9b5fea2a92c9602fa2",
                "name": "GameGPU",
                "url": "https://uk.gamegpu.com"
            }
        },
        {
            "id": "9376d18484bb46cdfac92fb182f65da0",
            "title": "Шахтар здобув першу перемогу в Лізі чемпіонів, здолавши АЕК",
            "description": "Шахтар обіграв грецький АЕК з рахунком 3:1 у другому турі загального етапу Ліги чемпіонів. Гірники здобули першу перемогу в турнірі.",
            "content": "Донецький Шахтар переміг грецький АЕК у межах другого туру загального етапу Ліги чемпіонів-2026/27.\nЗустріч на лондонському стадіоні Стемфорд Брідж завершилася з рахунком 3:1 на користь української команди.\nГості жваво розпочали поєдинок, створивши к... [2046 chars]",
            "url": "https://champion.com.ua/ukr/football/shahtar-peremig-aek-u-drugomu-turi-ligi-chempioniv-2026-27-1088087/",
            "image": "https://static.champion.com.ua/champion/images/doc/c/f/287030/cf9b74b5a04bdcd9674343e3c797cab1.jpeg?q=90&w=1920",
            "publishedAt": "2026-10-14T20:54:00Z",
            "lang": "uk",
            "source": {
                "id": "444fc07ba12d7e100917334c4b1b9708",
                "name": "Champion.com.ua",
                "url": "https://champion.com.ua"
            }
        },
        {
            "id": "dad761605eb63a2138ed966a29714f5d",
            "title": "Росія масовано атакувала Кропивницький та область: є жертви",
            "description": "Російські окупанти масовано атакували дронами-камікадзе Кропивницький та Кіровоградську область, через що загинули люди. Деталі - читайте на УНІАН.",
            "content": "Російські окупанти масовано атакували дронами-камікадзе Кропивницький та область, через що загинули люди. Про це повідомив очільник Кіровоградської ОДА Андрій Райкович.\nОновлено 01:18. Стало відомо про третього загиблого в Кропивницькому внаслідок ро... [1008 chars]",
            "url": "https://www.unian.ua/war/rosiya-masovano-atakuvala-kropivnickiy-ta-oblast-13529118.html",
            "image": "https://images.unian.net/photos/2026_10/thumb_files/620_324_1792009486-3691.jpg?1",
            "publishedAt": "2026-10-14T20:30:00Z",
            "lang": "uk",
            "source": {
                "id": "d4361862486677369ff2ae7719b8d313",
                "name": "УНІАН",
                "url": "https://www.unian.ua"
            }
        }
    ]
}

Missing a publisher from Ukraine? Suggest a source.

Ukraine News API

Categories

Request and live response