Germany World News API

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

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"  => "de",
    "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=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": 270978,
    "articles": [
        {
            "id": "27199857b8e62545b9bd11288504678d",
            "title": "Demokrat Jon Ossoff verteidigt wichtigen Senatssitz in Georgia",
            "description": "Jon Ossoff gilt als Hoffnungsträger für die Zukunft der Demokraten in den USA, manche sehen in ihm sogar einen potenziellen Präsidentschaftskandidaten. Bei den Midterms verteidigt das jüngste Mitglied des Senats seinen Sitz für den Bundesstaat Georgia.",
            "content": "Jon Ossoff gilt als Hoffnungsträger für die Zukunft der Demokraten in den USA, manche sehen in ihm sogar einen potenziellen Präsidentschaftskandidaten. Bei den Midterms verteidigt das jüngste Mitglied des Senats seinen Sitz für den Bundesstaat Georgi... [2027 chars]",
            "url": "https://www.n-tv.de/politik/Demokrat-Jon-Ossoff-verteidigt-wichtigen-Senatssitz-in-Georgia-id31491853.html",
            "image": "https://www.n-tv.de/img/31491847/1793757161/Img_16_9/1200/630592162.jpg",
            "publishedAt": "2026-11-04T01:03:16Z",
            "lang": "de",
            "source": {
                "id": "7688003d7f7a6c79830ebf3093dcb13e",
                "name": "n-tv.de",
                "url": "https://www.n-tv.de"
            }
        },
        {
            "id": "dadf1b4d32e7687aa89964915104c2fb",
            "title": "Mendel reagiert auf Vorwürfe: Kiew beschuldigt Selenskyjs Ex-Sprecherin des Landesverrats",
            "description": "Ukrainische Behörden erheben schwere Vorwürfe gegen Julia Mendel. Die frühere Sprecherin von Präsident Selenskyj soll mit ihren Äußerungen der russischen Propaganda dienen. Die Ex-Journalistin reagiert im Netz auf die Vorwürfe.",
            "content": "Ukrainische Behörden erheben schwere Vorwürfe gegen Julia Mendel. Die frühere Sprecherin von Präsident Selenskyj soll mit ihren Äußerungen der russischen Propaganda dienen. Die Ex-Journalistin reagiert im Netz auf die Vorwürfe.\nNach Kritik an Präside... [3004 chars]",
            "url": "https://www.n-tv.de/politik/Kiew-beschuldigt-Selenskyjs-Ex-Sprecherin-des-Landesverrats-id31491631.html",
            "image": "https://www.n-tv.de/img/31491648/1793739467/Img_16_9/1200/213969056.jpg",
            "publishedAt": "2026-11-03T21:22:17Z",
            "lang": "de",
            "source": {
                "id": "7688003d7f7a6c79830ebf3093dcb13e",
                "name": "n-tv.de",
                "url": "https://www.n-tv.de"
            }
        },
        {
            "id": "570654227b8f144bcbaa6a198c8d6adb",
            "title": "Tausende protestieren gegen tschechische Rundfunk-Pläne",
            "description": "Tschechiens Regierung will den öffentlich-rechtlichen Rundfunk künftig aus dem Staatshaushalt finanzieren. Viele sorgen sich deshalb um die Unabhängigkeit der Sender. Tausende gingen auf die Straße, beim Rundfunk wurde gestreikt.",
            "content": "In Prag und anderen tschechischen Städten haben erneut Tausende Menschen gegen Pläne der Regierung demonstriert, die Finanzierung der öffentlich-rechtlichen Sender zu ändern und zu kürzen. Mitarbeiter des tschechischen Fernsehens und Radios traten in... [2641 chars]",
            "url": "https://www.tagesschau.de/ausland/europa/protest-tschechien-rundfunk-100.html",
            "image": "https://images.tagesschau.de/image/04502483-7cf3-484c-a039-6da250c2b95b/AAABoaL4qxo/AAABnSSvrFg/16x9-big/prag-276.jpg?width=1280",
            "publishedAt": "2026-11-03T19:52:00Z",
            "lang": "de",
            "source": {
                "id": "d1c0148fa2c872d19c85b79c6a996e77",
                "name": "tagesschau.de",
                "url": "https://www.tagesschau.de"
            }
        }
    ]
}

Missing a source from Germany? Suggest a source.

Germany World News API

Categories

Request and live response