Finland World News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --data-urlencode "country=fi" \
  --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": "fi", "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: "fi",
    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"  => "fi",
    "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=fi&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": 62658,
    "articles": [
        {
            "id": "7b0b16a6c25d77c9d8f07127209fcc58",
            "title": "Grönlanti kiistää Trumpin väitteet ”massiivisista” öljy- ja kaasuetsinnöistä",
            "description": "Grönlantilaisministerin mukaan monia pienempiä etsintöjä on käynnissä, mutta niiden muuttaminen varsinaiseksi tuotannoksi voi kestää vuosia.",
            "content": "Grönlannin hallitus torjui keskiviikkona presidentti Donald Trumpin väitteet, joiden mukaan Grönlannissa on käynnistymässä ”massiivinen” öljyn, kaasun ja mineraalien etsintä.\nGrönlannin kaivosasioiden apulaisministeri Jørgen Hammeken-Holm myönsi CNN:... [879 chars]",
            "url": "https://yle.fi/a/74-20251543",
            "image": "https://img.img-cdn.yle.fi/crop_extract,w_5500,h_3093,x_0,y_192/crop_fill,w_1200,h_628/f_auto/39-17222266acf2990a8d12/1791961649",
            "publishedAt": "2026-10-14T22:15:34Z",
            "lang": "fi",
            "source": {
                "id": "cfe7454266eb1d785df8b156748deaca",
                "name": "Yle",
                "url": "https://yle.fi"
            }
        },
        {
            "id": "19f970bf402d0eaecab7e1b5a3747684",
            "title": "Zelenskyi: Trump petti minut",
            "description": "On sääli, että menetämme vahvan kumppanin, Zelenskyi kommentoi brittijournalisti Piers Morganin ohjelmassa.",
            "content": "Ukrainan presidentti Volodymyr Zelenskyi kokee tulleensa petetyksi.\nZelenskyi kommentoi asiaa brittitoimittaja Piers Morganin Piers Morgan Uncensored -ohjelmassa.\nMorgan kysyi, kokeeko Zelenskyi viimeaikaisten tapahtumien valossa, että hänet on petet... [2318 chars]",
            "url": "https://www.is.fi/ulkomaat/art-2000012343443.html",
            "image": "https://images.sanoma-sndp.fi/301a2babd23cee0a81c86101d5968a58/some/is-default.jpg",
            "publishedAt": "2026-10-14T21:02:00Z",
            "lang": "fi",
            "source": {
                "id": "dc6f5c9196f0edd195331bc5b2314e89",
                "name": "Ilta-Sanomat",
                "url": "https://www.is.fi"
            }
        },
        {
            "id": "762ec74dba2cd61c2cdf661e77c169f5",
            "title": "Trump julkaisi videon tiikerin tappamasta miehestä - nyt puhuu tämän perhe",
            "description": "Britanniassa tiikerin hyökkäyksessä kuolleen miehen omaiset ovat järkyttyneet tapahtuneesta leviävistä videoista. Yksi niitä jakaneista on Yhdysvaltain presidentti Donald Trump.",
            "content": "Yhdysvaltain presidentti Donald Trump on herättänyt pahennusta julkaisemalla videon tiikerin kuoliaaksi raatelemasta miehestä. Nyt miehen perhe vetoaa sosiaalisen median käyttäjiin, kertoo The Guardian.\nTrump jakoi tiistaina Truth Social -tilillään v... [2155 chars]",
            "url": "https://www.is.fi/ulkomaat/art-2000012343428.html",
            "image": "https://images.sanoma-sndp.fi/be9a8aab22e7a7d6fdc20fb875781e22/some/is-default.jpg",
            "publishedAt": "2026-10-14T20:32:00Z",
            "lang": "fi",
            "source": {
                "id": "dc6f5c9196f0edd195331bc5b2314e89",
                "name": "Ilta-Sanomat",
                "url": "https://www.is.fi"
            }
        }
    ]
}

Missing a publisher from Finland? Suggest a source.

Finland World News API

Categories

Request and live response