Germany News API

Get the live top 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 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);
}

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"  => "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=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": 461148,
    "articles": [
        {
            "id": "8f8f6ea7370fcb0d1ed6f8784e10a219",
            "title": "Brigitte Bardot rechnete vor ihrem Tod mit Lebenspartner ab",
            "description": "Brigitte Bardot hat wenige Jahre vor ihrem Tod bittere Worte an ihren langjährigen Partner Bernard d'Ormale gerichtet.",
            "content": "Brigitte Bardot hat wenige Jahre vor ihrem Tod bittere Worte an ihren langjährigen Partner Bernard d'Ormale gerichtet. Ein jetzt veröffentlichter Brief offenbart tiefe Enttäuschung.\nFrankreichs verstorbene Filmikone Brigitte Bardot hat wenige Jahre v... [2107 chars]",
            "url": "https://web.de/magazine/unterhaltung/stars/brigitte-bardot-rechnete-tod-lebenspartner-42908276",
            "image": "https://i0.web.de/image/302/42908302,pd=4,f=opengraph/brigitte-bardot-bernard-dormale.jpg",
            "publishedAt": "2026-11-04T04:46:57Z",
            "lang": "de",
            "source": {
                "id": "62f3ff5e77de86cbd502d3c35d3321c3",
                "name": "WEB.DE",
                "url": "https://web.de"
            }
        },
        {
            "id": "4c09314ab8b869a05d3340f1bfaea21f",
            "title": "Midterms 2026: ++ Trumps Republikaner verlieren Repräsentantenhaus ++ Liveticker",
            "description": "Midterms 2026 in den USA: Alle aktuellen Entwicklungen zur US-Wahl, Umfragen, Prognosen und Ergebnisse sowie die Folgen für Donald Trump im Liveticker.",
            "content": "US-Präsident Donald Trump hat sich am Abend der Zwischenwahlen über die Berichterstattung des Fernsehsenders Fox News beschwert. Auf seiner Plattform Truth Social kritisierte er, der Sender widme den Demokraten „zu viel Zeit“. Trump verfolgte die ers... [6544 chars]",
            "url": "https://www.welt.de/politik/ausland/article6ae86c76b3f0fa60211d5fd2/midterms-2026-trumps-republikaner-verlieren-repraesentantenhaus-liveticker.html",
            "image": "https://images.welt.de/6ae86c76b3f0fa60211d5fd2/950df36b689640dae3c56e83ccdac27c/ci16x9-w1200/dpa-com-261103-935-1718343-jpg",
            "publishedAt": "2026-11-04T04:17:55Z",
            "lang": "de",
            "source": {
                "id": "cf546071db42a61c713f08ef551e8103",
                "name": "WELT",
                "url": "https://www.welt.de"
            }
        },
        {
            "id": "9fa60372603957e8fef39eaa603ed9fa",
            "title": "In der ARD: Kai Pflaume knackt bei \"Wer weiß den sowas?\" live Weltrekord",
            "description": "Moderator Kai Pflaume hat live im TV einen Weltrekord aufgestellt. Jetzt reagieren Spitzensportler und Promis mit überschwänglichen Worten.",
            "content": "\"Du bist eine Maschine\"\nKai Pflaume knackt Weltrekord und löst Begeisterung aus\nVon t-online, sow\nAktualisiert am 04.11.2026 - 03:05 UhrLesedauer: 2 Min.\nModerator Kai Pflaume hat live im TV einen Weltrekord aufgestellt. Jetzt reagieren Spitzensportl... [2878 chars]",
            "url": "https://www.t-online.de/unterhaltung/stars/id_101509902/in-der-ard-kai-pflaume-knackt-bei-wer-weiss-den-sowas-live-weltrekord-.html",
            "image": "https://images.t-online.de/2026/11/KPNzlkqlohzm/0x183:4380x2464/fit-in/1200x0/kai-pflaume-der-moderator-hat-in-seiner-ard-show-einen-dauerlauf-hingelegt.jpg",
            "publishedAt": "2026-11-04T02:05:00Z",
            "lang": "de",
            "source": {
                "id": "612c5db1403481c848de8fa06aae6928",
                "name": "T-Online",
                "url": "https://www.t-online.de"
            }
        }
    ]
}

Missing a source from Germany? Suggest a source.

Germany News API

Categories

Request and live response