Finland World News API

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

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" => "world",
    "country"  => "fi",
    "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=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": 66584,
    "articles": [
        {
            "id": "22a313075375bda6ba8275f56aef7b88",
            "title": "Tyynenmeren jätelautassa on niin paljon muovia, että vesikin vaihtaa jo väriä",
            "description": "Tutkijoiden mukaan vesi on aiempaa vihreämpi ja sinisempi.",
            "content": "Osa Tyynestämerestä on muuttanut väriään viimeisen kahden vuosikymmenen aikana. Taustalla on luultavasti lisääntynyt muovisaaste, uutisoi CNN.\nVesialue, joka sijaitsee Havaijin ja Kalifornian välissä, on tutkijoiden mukaan merkittävästi sinisempi ja ... [908 chars]",
            "url": "https://www.is.fi/ulkomaat/art-2000012392397.html",
            "image": "https://images.sanoma-sndp.fi/9c5fb34ec18b54f7f9ece290463b92a3/some/is-default.jpg",
            "publishedAt": "2026-11-05T21:30:00Z",
            "lang": "fi",
            "source": {
                "id": "dc6f5c9196f0edd195331bc5b2314e89",
                "name": "Ilta-Sanomat",
                "url": "https://www.is.fi"
            }
        },
        {
            "id": "30a321dc9844da3fee6cb795af5cbdb3",
            "title": "Kalifornian kuvernööri säästää yli 500 kuolemaantuomittua teloitukselta",
            "description": "Kalifornian kuolemaantuomittujen määrä vastaa noin neljäsosaa kuolemaantuomituista koko Yhdysvalloissa.",
            "content": "Yhdysvaltojen Kalifornian kuvernööri Gavin Newsom aikoo lieventää kaikkien osavaltion teloitusjonossa olevien vankien kuolemantuomiota.\nKuvernöörin virasto ilmoitti torstaina, että Newsom muuntaa 548 vangin kuolemantuomion elinkautiseksi vankeudeksi ... [1534 chars]",
            "url": "https://www.hs.fi/maailma/art-2000012392497.html",
            "image": "https://images.sanoma-sndp.fi/3a7c880c668d67d76361bbc980cd249d/some/hs-default.jpg",
            "publishedAt": "2026-11-05T21:25:00Z",
            "lang": "fi",
            "source": {
                "id": "07b283984c8a8338fdd582adff1826f1",
                "name": "HS.fi",
                "url": "https://www.hs.fi"
            }
        },
        {
            "id": "0e90786c03c6797424d83df1fd99992f",
            "title": "Kahdeksan kuollut ampumisissa Turkissa",
            "description": "Epäilty ehti paeta toiseen maakuntaan.",
            "content": "Kahdeksan ihmistä on kuollut Turkissa sattuneessa ampumavälikohtausten sarjassa. Asiasta kertoo Britannian yleisradioyhtiö BBC.\nLisäksi yksi ihminen on loukkaantunut vakavasti. Uhrit löytyivät kolmesta eri ajoneuvosta, jotka olivat eri paikoissa. K... [511 chars]",
            "url": "https://www.is.fi/ulkomaat/art-2000012392533.html",
            "image": "https://images.sanoma-sndp.fi/7200a38c1b4f9c517f3cea6a198bfaf9/some/is-default.jpg",
            "publishedAt": "2026-11-05T20:44:00Z",
            "lang": "fi",
            "source": {
                "id": "dc6f5c9196f0edd195331bc5b2314e89",
                "name": "Ilta-Sanomat",
                "url": "https://www.is.fi"
            }
        }
    ]
}

Missing a source from Finland? Suggest a source.

Finland World News API

Categories

Request and live response