Ireland World News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --data-urlencode "country=ie" \
  --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": "ie", "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: "ie",
    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"  => "ie",
    "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=ie&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": 135836,
    "articles": [
        {
            "id": "8dfa638462eaee4dad76922459f4879a",
            "title": "Spain's transport minister resigns days after train crash",
            "description": "Spain's transport minister, Oscar Puente, has announced his resignation over last week's deadly train crash, the country's second this year, hours after laying out the government's emergency aid package for victims and new safety measures.",
            "content": "Spain's transport minister, Oscar Puente, has announced his resignation over last week's deadly train crash, the country's second this year, hours after laying out the government's emergency aid package for victims and new safety measures.\n\"A transpo... [3160 chars]",
            "url": "https://www.rte.ie/news/2026/1103/1597878-spain-transport-minister/",
            "image": "https://www.rte.ie/images/00253faa-1600.jpg",
            "publishedAt": "2026-11-03T22:20:23Z",
            "lang": "en",
            "source": {
                "id": "8bcb1c163b5eb62b4cdfdafb99503799",
                "name": "RTE.ie",
                "url": "https://www.rte.ie"
            }
        },
        {
            "id": "abf266dc1609297f5ca3ae63fd43b085",
            "title": "Speeding Lamborghini driver jailed for killing friend in M62 crash",
            "description": "Humaira Batool, 26, is sentenced for causing for the death of 20-year-old Mohammed Shaan Hussain.",
            "content": "A driver who caused the death of her friend when she lost control of a rented Lamborghini and crashed into a motorway barrier has been jailed for 10 years.\nMohammed Shaan Hussain, 20, died when Humaira Batool crashed the £200,000 supercar on the M62,... [3268 chars]",
            "url": "https://www.bbc.com/news/articles/c6dxw8r7rd1go",
            "image": "https://ichef.bbci.co.uk/news/1024/branded_news/75aa/live/495fc600-ac5f-11f1-be57-03729df1d736.jpg",
            "publishedAt": "2026-11-03T17:27:43Z",
            "lang": "en",
            "source": {
                "id": "f331a5ed3965fb59761dfcecfc7e7a34",
                "name": "BBC",
                "url": "https://www.bbc.com"
            }
        },
        {
            "id": "06df2a803e6d232866f13c56f602ca24",
            "title": "Vincent Sweeney of 76 Magheramore Road, Dungiven, Co Derry",
            "description": "Regrettably the death has taken place of Vincent Sweeney of 76 Magheramore Road, Dungiven, Co Derry who passed away peacefully on 3rd of November 2026 at Altnagelvin Hospital surrounded by his loving family. May he rest in peace. Beloved husband of Eileen, loving father of Geraldine (Rory) Caroline (Liam) Pauline (Sean) Vincent (Brenda) Elaine (Owen) […]",
            "content": "Regrettably the death has taken place of Vincent Sweeney of 76 Magheramore Road, Dungiven, Co Derry who passed away peacefully on 3rd of November 2026 at Altnagelvin Hospital surrounded by his loving family. May he rest in peace.\nBeloved husband of E... [1041 chars]",
            "url": "https://highlandradio.com/obituaries_test/vincent-sweeney-of-76-magheramore-road-dungiven-co-derry/",
            "image": "https://highlandradio.com/wp-content/uploads/2026/11/late-Vincent-Sweeney.png",
            "publishedAt": "2026-11-03T16:48:23Z",
            "lang": "en",
            "source": {
                "id": "cd36f1e4d0425097b78dfc5f0d1ec2bd",
                "name": "Highland Radio",
                "url": "https://highlandradio.com"
            }
        }
    ]
}

Missing a source from Ireland? Suggest a source.

Ireland World News API

Categories

Request and live response