Germany World News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=world" \
  --data-urlencode "country=de" \
  --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": "de", "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: "de",
    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"  => "de",
    "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=de&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": 235564,
    "articles": [
        {
            "id": "63f5987ddc6db006fd5e5124b65fbff8",
            "title": "Krieg: Wolodymyr Selenskyj erklärt, er fühle sich von Donald Trump verraten",
            "description": "Erst der Dieseldeal mit Putin, dann offenbar die Drosselung des SpaceX-Satellitensystems: Der ukrainische Präsident beklagt den Verlust der USA als Partner. Auch Elon Musk schaltet sich ein – mit Schuldzuweisung gen Washington.",
            "content": "Selenskyj beklagt Verlust der USA als Partner\nSelenskyj sagte im Interview mit Morgan nun, es sei schade, »dass wir einen starken Partner verlieren«. Die Ukraine könne sich keine Schwäche erlauben. »Wir verkaufen unser Land nicht.« Es gehe nicht ums ... [2113 chars]",
            "url": "https://www.spiegel.de/ausland/russland-ukraine-krieg-wolodymyr-selenskyj-erklaert-er-fuehle-sich-von-donald-trump-verraten-a-154bfb87-108f-4784-a45e-10610f43d8f9",
            "image": "https://cdn.prod.www.spiegel.de/images/c8033c92-ac1a-4107-8444-00753120dace_w1200_r1.778_fpx51_fpy44.jpg",
            "publishedAt": "2026-10-15T00:10:00Z",
            "lang": "de",
            "source": {
                "id": "365c85aec04c4c32e1d48d798c33545d",
                "name": "Spiegel",
                "url": "https://www.spiegel.de"
            }
        },
        {
            "id": "fbed3a60d72ee3fa7a0c9d890c72841d",
            "title": "Schlechte Umfragen trotz teurem Wahlkampf: „Den Republikanern steht das Schicksal von Trumps Unternehmen bevor - der Zusammenbruch“",
            "description": "Vor den US-Zwischenwahlen pumpen Republikaner und ihre Unterstützer Millionenbeträge in Schmutzkampagnen gegen Demokraten. Gewinnt das Geld am Ende die Midterms?",
            "content": "Er ist ihnen nicht mehr lieb, aber teuer. Während Präsident Donald Trump mit seiner Politik die Wähler verprellt und seine Partei in den Umfragen abstürzen lässt, pumpen konservative Großspender Rekordsummen in den Wahlkampf. Die Midterms am 3. Novem... [6574 chars]",
            "url": "https://www.tagesspiegel.de/internationales/schlechte-umfragen-trotz-teurem-wahlkampf-den-republikanern-steht-das-schicksal-von-trumps-unternehmen-bevor--der-zusammenbruch-16153610.html",
            "image": "https://www.tagesspiegel.de/images/16160026/alternates/BASE_16_9_W1400/1791967783000/us-politics-trump.jpeg",
            "publishedAt": "2026-10-14T20:26:00Z",
            "lang": "de",
            "source": {
                "id": "34ce797aba515136eb943360b267f681",
                "name": "Tagesspiegel",
                "url": "https://www.tagesspiegel.de"
            }
        },
        {
            "id": "ced6c055960afcf3f5259a88bba1f2fa",
            "title": "Krieg: „Nicht die richtige Seite der Geschichte“ – Selenskyj zeigt sich enttäuscht von Trumps Diesel",
            "description": "Ukraines Präsident Selenskyj fühlt sich durch den Diesel-Deal zwischen den USA und Russland betrogen. „Wir verkaufen unser Land nicht“, sagt er und wirbt in London für mehr Luftabwehr.",
            "content": "Audioplayer wird geladen\nGoogle\nKlicken Sie hier, um sich Artikel von WELT in der Google-Suche bevorzugt anzeigen zu lassen.\nAnzeige\nDer ukrainische Präsident Wolodymyr Selenskyj fühlt sich durch den Diesel-Deal von US-Präsident Donald Trump mit Russ... [2432 chars]",
            "url": "https://www.welt.de/politik/article6acfd478f02d3efff477db3f/ukraine-krieg-nicht-die-richtige-seite-der-geschichte-selenskyj-zeigt-sich-enttaeuscht-von-trumps-diesel-deal.html",
            "image": "https://images.welt.de/6acfd478f02d3efff477db3f/fb687ace7d808b6a16c91184c6ff57d6-master/ci16x9-w1200/dpa-com-261013-935-1674449-jpg",
            "publishedAt": "2026-10-14T20:13:10Z",
            "lang": "de",
            "source": {
                "id": "cf546071db42a61c713f08ef551e8103",
                "name": "WELT",
                "url": "https://www.welt.de"
            }
        }
    ]
}

Missing a publisher from Germany? Suggest a source.

Germany World News API

Categories

Request and live response