Ukraine World News API

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

<?php

$apiKey = "YOUR_API_KEY";

$query = http_build_query([
    "category" => "world",
    "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=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": 563472,
    "articles": [
        {
            "id": "0e8116e392bcd6f551b27f76cfa6a426",
            "title": "У Польщі різко скоротилася кількість українців із тимчасовим захистом: яка ситуація в інших країнах ЄС",
            "description": "У Польщі за серпень 2026 року кількість отримувачів тимчасового захисту скоротилася на 13,7 тисячі. Де в ЄС українців побільшало та які країни лідирують.",
            "content": "У Польщі зафіксували найбільше серед країн Європейського Союзу скорочення кількості людей, які отримали тимчасовий захист після виїзду з України. Протягом серпня 2026 року їхня чисельність зменшилася на 13 665 осіб, або 1,4%. Водночас у більшості дер... [2468 chars]",
            "url": "https://vsviti.com.ua/news/184884",
            "image": "https://vsviti.com.ua/wp-content/uploads/2026/10/ukrayintsi-u-polshchi.webp",
            "publishedAt": "2026-10-14T21:35:23Z",
            "lang": "uk",
            "source": {
                "id": "0f668779086e3806937f3ea1040e37ea",
                "name": "ВСВІТІ",
                "url": "https://vsviti.com.ua"
            }
        },
        {
            "id": "1569e79ba3785982b5345edac86400a2",
            "title": "ФБР ліквідувало 40 північнокорейських ферм ноутбуків у США • Межа",
            "description": "У вересні ФБР зруйнувало розгалужену мережу посередників у США, звинувачених у допомозі Північної Кореї з отриманням віддалених робочих місць в американському IT. Вилучені понад 200 комп'ютерів.",
            "content": "У вересні ФБР зруйнувало розгалужену мережу посередників у США, звинувачених у допомозі Північної Кореї з отриманням віддалених робочих місць в американському IT. Про це повідомляє The New York Times з посиланням на офіційних осіб.\nПід час операції Ф... [2765 chars]",
            "url": "https://mezha.ua/news/fbi-shuts-down-40-north-korean-laptop-farms-316179/",
            "image": "https://img.mezha.ua/mezha/images/doc/8/e/330340/8e6a7a1a92bd779ec45c43e9954a3585.jpeg?w=1200&q=85&stamp=1792010998",
            "publishedAt": "2026-10-14T20:53:00Z",
            "lang": "uk",
            "source": {
                "id": "6b0257d31504a630dde7752eed4e1e39",
                "name": "Mezha",
                "url": "https://mezha.ua"
            }
        },
        {
            "id": "e50d63f02e3a19492a75d0347923869f",
            "title": "Появились спутниковые снимки дата-центра \"Яндекса\" в Сасово после удара дронов",
            "description": "Осинтеры изучили спутниковые снимки дата-центра \"Яндекса\" в Сасово после ударов украинских дронов. Пожар уничтожил треть здания....",
            "content": "Сгорела треть дата-центра в Сасово\nПожар после удара дронов повредил треть здания дата-центра \"Яндекса\" в Сасово Рязанской области России. Об этом свидетельствуют спутниковые снимки Airbus, изученные \"Агентством\".\nСпутниковые снимки территории станко... [1075 chars]",
            "url": "https://www.rbc.ua/ukr/news/z-yavilisya-suputnikovi-znimki-data-tsentru-1792004897.html",
            "image": "https://www.rbc.ua/static/img/w/i/wildberries__pozhezha_29_lipnya_202_b8d0e7544275fe8631b1a0e12cfb2ca1_1300x820.jpg",
            "publishedAt": "2026-10-14T19:11:14Z",
            "lang": "ru",
            "source": {
                "id": "6f1ead09126f1f4738a48957e22f789c",
                "name": "РБК-Україна",
                "url": "https://www.rbc.ua"
            }
        }
    ]
}

Missing a publisher from Ukraine? Suggest a source.

Ukraine World News API

Categories

Request and live response