Nachrichtensuche

Zuletzt aktualisiert July 20, 2026

Nachrichten-Suchergebnisse als JSON.

TEXT

GET /v1/news

Erfordert einen gültigen API-Schlüssel, eine aktive Mitgliedschaft und verfügbares API-Guthaben.

Suchparameter

Name	Typ	Erforderlich	Vorgabe	Beschreibung
`q`	string	ja	—	Die Suchanfrage.
`safe`	string	nein	`on`	Stufe der sicheren Suche: `off` oder `on`.
`gl`	string	nein	(auto)	Zweibuchstabiger Regions-/Ländercode (z. B. `us`, `gb`).
`hl`	string	nein	(auto)	Zweibuchstabiger Sprachcode (z. B. `en`, `fr`).
`time`	string	nein	`any`	Aktualitätsfilter: `any`, `hour`, `day`, `week`, `month`, `year`. Besonders nützlich für Nachrichten.
`num`	integer	nein	(Anbietervorgabe)	Gewünschte Ergebnisanzahl. Auf 5–100 begrenzt (außerhalb des Bereichs → 20).

Antwort

JSON

{
  "query": "mars mission",
  "kind": "news",
  "results": [
    {
      "title": "New rover lands on Mars",
      "url": "https://news.example.com/mars-rover",
      "description": "The spacecraft touched down early this morning…",
      "thumbnail": "https://news.example.com/mars-thumb.jpg",
      "price": null,
      "meta": "Example News",
      "extra": "2 hours ago"
    }
  ]
}

Feld	Typ	Beschreibung
`query`	string	Die ausgeführte Suchanfrage.
`kind`	string	Für diesen Endpunkt stets `news`.
`results[].title`	string	Schlagzeile.
`results[].url`	string	URL des Artikels.
`results[].description`	string \| null	Auszug des Artikels.
`results[].thumbnail`	string \| null	URL des Vorschaubildes, sofern verfügbar.
`results[].meta`	string \| null	Herausgeber / Quelle.
`results[].extra`	string \| null	Veröffentlichungsdatum / relative Zeit, sofern verfügbar.
`results[].price`	string \| null	Wird für Nachrichten nicht verwendet.

Beispiele

cURL

curl -G "https://api.suede.io/v1/news" \
  -H "Authorization: Bearer $SUEDE_API_KEY" \
  --data-urlencode "q=mars mission" \
  --data-urlencode "time=day"

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization =
    new("Bearer", Environment.GetEnvironmentVariable("SUEDE_API_KEY"));
var url = "https://api.suede.io/v1/news?q=" + Uri.EscapeDataString("mars mission") + "&time=day";
Console.WriteLine(await http.GetStringAsync(url));

JavaScript

const params = new URLSearchParams({ q: "mars mission", time: "day" });
const res = await fetch(`https://api.suede.io/v1/news?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SUEDE_API_KEY}` },
});
const data = await res.json();
for (const r of data.results) console.log(r.meta, "—", r.title, `(${r.extra})`);