/tagesschau-api

Dokumentation zur API der Tagesschau

Primary LanguagePython

[DE]/[EN]

Tagesschau API

Die Tagesschau ist eine Nachrichtensendung der ARD (Abkürzung für Arbeitsgemeinschaft der öffentlich-rechtlichen Rundfunkanstalten der Bundesrepublik Deutschland), die von ARD-aktuell in Hamburg produziert und mehrmals täglich ausgestrahlt wird. ARD-aktuell ist seit 1977 die zentrale Fernsehnachrichtenredaktion der ARD, bei welcher es sich wiederum um einen Rundfunkverbund handelt, der aus den Landesrundfunkanstalten und der Deutschen Welle besteht.

Über die hier dokumentierte API stehen auf www.tagesschau.de aktuelle Nachrichten und Medienbeiträge im JSON-Format zur Verfügung.

API2

URL: https://www.tagesschau.de/api2/

Wichtige Nachrichten und Eilmeldungen, sowie regionale Nachrichten aus dem Pfad '/api2/homepage/'.

API2 tritt die Nachfolge der vorangegangenen API an, die nach eigenen Angaben seit 01.10.2018 obsolet ist (vgl. https://www.tagesschau.de/api/ - obwohl z.B. unter https://www.tagesschau.de/api/inland/, https://www.tagesschau.de/api/ausland/, https://www.tagesschau.de/api/wirtschaft/ und https://www.tagesschau.de/api/regional/ durchaus noch aktuelle Beiträge zu finden sind).

Homepage

URL: https://www.tagesschau.de/api2/homepage/

Ausgewählte Nachrichten und Eilmeldungen, die auf der Startseite der Tagesschau-App zu sehen sind.

News

URL: https://www.tagesschau.de/api2/news/

Aktuelle Nachrichten, die über GET-Parameter gefiltert werden können:

Parameter: regions

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16

Bundesland: 1=Baden-Württemberg, 2=Bayern, 3=Berlin, 4=Brandenburg, 5=Bremen, 6=Hamburg, 7=Hessen, 8=Mecklenburg-Vorpommern, 9=Niedersachsen, 10=Nordrhein-Westfalen, 11=Rheinland-Pfalz, 12=Saarland, 13=Sachsen, 14=Sachsen-Anhalt, 15=Schleswig-Holstein, 16=Thüringen. Mehrere Komma-getrennte Angaben möglich (z.B. regions=1,2).

Parameters: ressort

  • inland
  • ausland
  • wirtschaft
  • sport
  • video

Ressort/Themengebiet

Newsfeed

URL: https://www.tagesschau.de/api2/newsfeed-101~_date-{datumsangabe}.json

Nachrichten und Eilmeldungen zum ausgewählten Datum, gefiltert über den Pfad-Parameter datumsangabe im Format yymmdd (z.B. 220228 für den 28.02.2022").

Search

URL: https://www.tagesschau.de/api2/search/

Parameter: searchText

Suchtext

Parameter: resultPage

Seite

Parameter: pageSize

Suchergebnisse pro Seite (1-30)

Ressorts

URL: https://www.tagesschau.de/api2/{ressort}/

Ressort-spezifische Nachrichten, gefiltert über den Pfad-Parameter ressort (z.B. inland, ausland oder wirtschaft)

Channels

URL: https://www.tagesschau.de/api2/channels/

Aktuelle Kanäle (im Livestream: tagesschau24, tagesschau in 100 Sekunden, tagesschau, tagesschau 20 Uhr, tagesthemen, nachtmagazin, Bericht aus Berlin, tagesschau vor 20 Jahren, tagesschau mit Gebärdensprache)

Multimedia

URL: https://www.tagesschau.de/api2/multimedia/

Multimedia-Beiträge.

Beispiel

tagesschau=$(curl -m 60 https://www.tagesschau.de/api2/homepage/)