Ukraine News API

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

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" => "general",
    "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=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": 505672,
    "articles": [
        {
            "id": "b8d6690378466864318e8a24447044a3",
            "title": "Проміжні вибори в США: ЗМІ оприлюднили попередні прогнози голосування",
            "description": "Після закриття виборчих дільниць, ситуація на проміжних виборах у США динамічно змінюється в різні напрямки. Демократи відібрали місця в Сенаті від двох штатів, а республіканці мають мінімальну перевагу у Палаті представників.",
            "content": "На проміжних виборах до Конгресу США прогнозується, що Демократична партія щонайменше отримає контроль над Палатою представників, здобувши більшість місць. Наразі відомо, що також демократи відібрали в республіканців місця два ключові місця в Сенаті ... [3064 chars]",
            "url": "https://www.slovoidilo.ua/2026/11/04/novyna/svit/promizhni-vybory-ssha-zmi-oprylyudnyly-poperedni-prohnozy-holosuvannya",
            "image": "https://media.slovoidilo.ua/media/scimage/247/246517-uk.png",
            "publishedAt": "2026-11-04T03:53:08Z",
            "lang": "uk",
            "source": {
                "id": "15797505fcdbf49191263455ed070cbb",
                "name": "Слово і Діло",
                "url": "https://www.slovoidilo.ua"
            }
        },
        {
            "id": "04d37e8718a4bd90dfcf0a12d3791e6c",
            "title": "ЄК розділяє Україну та Молдову на шляху вступу до ЄС",
            "description": "Єврокомісія обирає більш обережний шлях на шляху вступу України до Євросоюзу.",
            "content": "За даними Politico, Європейська комісія готує більш обережну \"дорожню карту\" для переговорів щодо вступу України до ЄС із зазначеними обмеженими цілями щодо прогресу на 2027 рік без будь-яких зобов'язань щодо дати вступу.\nДжерело: Politico із посилан... [6186 chars]",
            "url": "https://www.pravda.com.ua/news/2026/11/04/8061148/",
            "image": "https://uimg.pravda.com.ua/buckets/upstatic/images/doc/4/3/950181/4302dd646cd1b920ed392175d4f536cc.jpeg?w=1200&q=85&stamp=1793763988",
            "publishedAt": "2026-11-04T03:40:00Z",
            "lang": "uk",
            "source": {
                "id": "f22da91c498603eb4d447ae38063cc99",
                "name": "Українська правда",
                "url": "https://www.pravda.com.ua"
            }
        },
        {
            "id": "3502713eb05a7a67c43ce5f6355bd617",
            "title": "Зеленський у Берліні попередив Європу, що Росія вважає її ворогом",
            "description": "Росія розглядає мирну та об'єднану Європу як свого ворога, а її військова інфраструктура надто масштабна, щоб бути спрямованою лише проти України....",
            "content": "На думку Зеленського, Москва ухвалила своє рішення щодо Європи, і ця загроза не зникне найближчим часом.\n\"Ми бачимо, що Росія вже визначилася. Вона вирішила, що мирна й об'єднана Європа - її ворог. І ця ситуація не зникне просто так за рік\", - сказав... [1346 chars]",
            "url": "https://www.rbc.ua/rus/news/ukrayina-nikoli-zdastsya-ale-shcho-bude-tut-1793759983.html",
            "image": "https://www.rbc.ua/static/img/_/z/_zelenskiy_2026_gettyimages_2291827508_dada03ef51eeee698db86648c1011bf6_1300x820.jpg",
            "publishedAt": "2026-11-04T02:39:43Z",
            "lang": "uk",
            "source": {
                "id": "6f1ead09126f1f4738a48957e22f789c",
                "name": "РБК-Україна",
                "url": "https://www.rbc.ua"
            }
        }
    ]
}

Missing a source from Ukraine? Suggest a source.

Ukraine News API

Categories

Request and live response