Germany News API

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

curl --get "https://gnews.io/api/v4/top-headlines" \
  --data-urlencode "category=general" \
  --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": "general", "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: "general",
    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" => "general",
    "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=general&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": 394290,
    "articles": [
        {
            "id": "232e9d9a37ca0c13d2ab0fab692626e4",
            "title": "Schwanger mit 52: Hilary Swank wird wieder Mama",
            "description": "Hilary Swank schwelgt im Babyglück: Die Schauspielerin wird mit 52 Jahren noch einmal Mama.",
            "content": "Eine Schwangerschaft ist immer ein kleines Wunder – doch mit 52 noch einmal Mama zu werden, dieses Glück wird wohl den Wenigsten zuteil. Klar, dass Schauspielerin Hilary Swank (52) ganz außer sich vor Freude ist. Der Hollywood-Star erwartet derzeit s... [2097 chars]",
            "url": "https://www.bunte.de/stars/stars-im-babyglueck/schwanger-mit-52-hilary-swank-wird-wieder-mama_d8b9cf43-1c9b-407d-86e1-ce99bc1e7a39.html",
            "image": "https://quadro.burda-forward.de/ctf/96809b57-ebec-4f0a-a04e-cd72b7d1107c.08698c48-5c1f-4106-baa6-b6a58be858f0.jpg?im=RegionOfInterestCrop=(1200,630),regionOfInterest=(1529,1426)&hash=c3c1b5ff04ed441ebabd58ed415153c6de5d6452d462a89a5ce3b2776a491e83",
            "publishedAt": "2026-10-14T21:16:00Z",
            "lang": "de",
            "source": {
                "id": "7226f6b6ee736858f6373a8e79e72bcc",
                "name": "BUNTE.de",
                "url": "https://www.bunte.de"
            }
        },
        {
            "id": "c01f69d53c97a8da408627e803f5ee64",
            "title": "Undav trifft erstmals - Stuttgart gewinnt auch in Bratislava",
            "description": "Der VfB Stuttgart gewinnt in Bratislava – und bei Deniz Undav platzt der Knoten endlich.",
            "content": "Der VfB Stuttgart gewinnt in Bratislava – und bei Deniz Undav platzt der Knoten endlich. Zwei Schreckmomente müssen die Schwaben bei den weitgehend harmlosen Gastgebern trotzdem überstehen.\nAuch dank Kapitän Deniz Undav hat der VfB Stuttgart seine Pf... [3839 chars]",
            "url": "https://web.de/magazine/sport/fussball/champions-league/undav-trifft-erstmals-stuttgart-gewinnt-bratislava-42836772",
            "image": "https://i0.web.de/image/774/42836774,pd=2,f=opengraph/slovan-bratislava-vfb-stuttgart.jpg",
            "publishedAt": "2026-10-14T20:57:49Z",
            "lang": "de",
            "source": {
                "id": "62f3ff5e77de86cbd502d3c35d3321c3",
                "name": "WEB.DE",
                "url": "https://web.de"
            }
        },
        {
            "id": "43868493a5d18b734ee547c1971013a6",
            "title": "Antonio Rüdiger besiegelt irrwitziges Real-Comeback in Rom!",
            "description": "Antonio Rüdiger lässt Real Madrid spät jubeln - der einstige deutsche Nationalspieler krönt eine kaum noch für möglich gehaltene Aufholjagd.",
            "content": "Antonio Rüdiger hat Real Madrid in einem irrwitzigen Spiel zum ganz späten Comeback-Sieg geführt. Der ehemalige deutsche Nationalspieler traf beim Duell mit der AS Roma in der Champions League in der 90. Spielminute zum 4:3-Erfolg – es war der dritte... [2884 chars]",
            "url": "https://www.sport1.de/news/fussball/champions-league/2026/10/antonio-ruediger-besiegelt-irrwitziges-real-comeback-in-rom",
            "image": "https://reshape.sport1.de/c/t/5f327990-ec64-4767-a7c4-d0a9d9b015ce/1290x726",
            "publishedAt": "2026-10-14T20:57:00Z",
            "lang": "de",
            "source": {
                "id": "e609ff7b045661b2268d7bc3678b8301",
                "name": "SPORT1",
                "url": "https://www.sport1.de"
            }
        }
    ]
}

Missing a publisher from Germany? Suggest a source.

Germany News API

Categories

Request and live response