Finland News API

Get the live top 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 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=general&country=fi&apikey=YOUR_API_KEY

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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" => "general",
    "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=general&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": 120212,
    "articles": [
        {
            "id": "c6dd36505fe7f0eb8d141b4060849dfd",
            "title": "Remedy Q3'26: Control Resonant myy hyvin, mutta toiveissa oli vielä parempaa",
            "description": "Q3-odotuksemme Control Resonantin osalta olivat liian korkealla ja pelin alkuvaiheen myyntitahti vaikuttaa jonkin verran aiempia odotuksiamme maltillisemmalta.",
            "content": "Lähde: Inderes\nToistamme Remedyn lisää-suosituksen, mutta tarkistamme tavoitehintaa 21,0 euroon (aik. 23,0 EUR). Q3-odotuksemme Control Resonantin osalta olivat liian korkealla ja pelin alkuvaiheen myyntitahti vaikuttaa jonkin verran aiempia odotuksi... [3503 chars]",
            "url": "https://www.inderes.fi/research/remedy-q326-control-resonant-myy-hyvin-mutta-toiveissa-oli-viela-parempaa?utm_source=nordnet&utm_medium=integration",
            "image": "https://www.inderes.se/cdn-cgi/image/format=auto/https://content.inderes.se/assets/03513f67-3429-43bc-878f-ee115b56a22b.png",
            "publishedAt": "2026-11-04T05:08:42Z",
            "lang": "fi",
            "source": {
                "id": "928fb2df8b1188faadc879eb32072dfa",
                "name": "Inderes",
                "url": "https://www.inderes.fi"
            }
        },
        {
            "id": "cb011c5b92ab9bfdada0625c3e28ed8e",
            "title": "ICE: Suomen kansalainen pidätetty epäiltynä vaalivilpistä vuoden 2024 vaaleissa",
            "description": "Maahanmuutto- ja tullivirasto ICE on julkaissut tietoja useista ulkomaan kansalaisista, jotka on pidätetty vaalivilpistä epäiltynä aiemmissa vaaleissa.",
            "content": "Suomen kansalainen on pidätetty Yhdysvalloissa vaalivilpistä epäiltynä, kertoo maan maahanmuutto- ja tullivirasto (ICE) viestipalvelu X:ssä.\nEpäily koskee vuoden 2024 vaaleja. ICE:n mukaan suomalaisen epäillään tuolloin rekisteröityneen äänestäjäksi ... [1728 chars]",
            "url": "https://www.hs.fi/maailma/art-2000012386912.html",
            "image": "https://www.hs.fi/og-1920x1920.png",
            "publishedAt": "2026-11-04T04:51:00Z",
            "lang": "fi",
            "source": {
                "id": "07b283984c8a8338fdd582adff1826f1",
                "name": "HS.fi",
                "url": "https://www.hs.fi"
            }
        },
        {
            "id": "c34ec6d64708c043da2c6ce4a94225f0",
            "title": "Dallas voitti Washingtonin - toisessa erässä nähtiin hattutemppu alle kuudessa minuutissa",
            "description": "Jason Robertson iski vieraille hattutempun toisessa erässä vain alle kuudessa minuutissa. Miro Heiskanen loukkaantui ottelussa.",
            "content": "Dallas Stars voitti Washington Capitalsin yön NHL-kierroksella maalein 6–5.\nDallasin suomalaiset Joel Kiviranta, Mikko Rantanen sekä Roope Hintz onnistuivat maalinteossa. Hintz sai lisäksi kaksi syöttöpistettä. Syöttöpisteet merkkauttivat myös Arttu ... [868 chars]",
            "url": "https://yle.fi/a/74-20254945",
            "image": "https://img.img-cdn.yle.fi/crop_extract,w_4271,h_2402,x_0,y_0/crop_fill,w_1200,h_628/f_auto/39-17226596ad05283ccb55/1792037522",
            "publishedAt": "2026-11-04T04:49:03Z",
            "lang": "fi",
            "source": {
                "id": "cfe7454266eb1d785df8b156748deaca",
                "name": "Yle",
                "url": "https://yle.fi"
            }
        }
    ]
}

Missing a source from Finland? Suggest a source.

Finland News API

Categories

Request and live response