Tagesschau v2 API Dokumentation (inoffiziell)

docs.md

VERALTET, BITTE HIER GUCKEN: https://github.com/bundesAPI/tagesschau-api

Tagesschau v2 API

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

TODO

• Responses fehlen
• Nicht alle Parameter dokumentiert (?)
• Weitere Endpunkte? (/channels)

1. Homepage

Endpunkt: /homepage

1.1 Parameter

N/A (keine bekannt)

Endpunkt liefert von der Tagesschau kuratierte News, die auch auf der Startseite der App zu sehen sind (inkl. Eilmeldungen)

2. News

Endpunkt: /news/

Antwort: RegionalNews

2.1 Parameter

Parameter	Wert	Bedeutung
	N/A	Alle Resorts und Länder
regions	1 bis 16 (kombinierbar, durch Komma abgetrennt)	Bundesland (s. unten)
ressort	inland, ausland, wirtschaft, sport, video	Themengebiet

2.1.1 regions

Wert	Bundesland	Lieferant
1	Baden-Württemberg	SWR
2	Bayern	BR24
3	Berlin	RBB24
4	Brandenburg	RBB24
5	Bremen	buten un binnen
6	Hamburg	NDR
7	Hessen	Hessenschau
8	Mecklenburg-Vorpommern	NDR
9	Niedersachsen	NDR
10	Nordrhein-Westfalen	WDR
11	Rheinland-Pfalz	SWR
12	Saarland	SR
13	Sachsen	MDR
14	Sachsen-Anhalt	MDR
15	Schleswig-Holstein	NDR
16	Thüringen	MDR

3. Suche

Endpunkt: /search/

3.1 Parameter

Parameter	Wert	Bedeutung
searchText	str	Suchbegriff
resultPage	int: totalItemCount / pageSize	Seite der Suchergebnisse
pageSize	int: 1 bis 30 (empfohlen: 10)	Anzahl der Suchergebnisse pro Seite

Ab einer pageSize von 30 wird die Suche instabil und liefert weniger Ergebnisse zurück.

elements.md

VERALTET, BITTE HIER GUCKEN: https://github.com/bundesAPI/tagesschau-api

Tagesschau v2 API Elemente

Haupt-Elementnamen (wie "RegionalNews") sind frei erfunden.

TODO

• Alles

RegionalNews

Beschreibt regionale News

story

Feld	Typ	Beschreibung
sophoraId	String	ID des Beitrags; wird auch für URL verwendet (Sophora = CMS)
externalId	String
title	String	Titel des Beitrags
teaserImage	Image	Teaser-Bild
date	String	Veröffentlichungszeitpunkt (Datum, Zeit, Zeitzone +00:00 oder +01:00)
tracking	Array mit Tracking	Array mit Tracking-Daten
tags	Array mit Tags	Array mit Tags
updateCheckUrl	String	URL zu JSON mit true/false, ob sich seit dem letzten state etwas geändert hat (TODO)
regionId	Integer	Regions-ID (siehe 2.1.1)
details	String	URL zu Beitrags-JSON
detailsweb	String	URL zum Beitrag im Web (intern)
shareURL	String	URL zum Beitrag im Web (ohne /ardimport)
geotags	Array mit Geotags	Array mit Geotags
ressort	String	Beitrags-Ressort (siehe 2.1)
brandingImage	BrandingImage	Optional: Anstalt-Branding (bspw. NDR)
type	String	story

VideoWeb

Bild - eigentlich als Standbild für Videos gedacht.

Feld	Typ	Beschreibung
imageurl	String	URL zum Bild

Tag

Feld	Typ	Beschreibung
tag	String	Tag

Geotag

Gibt den Ort der News an.

Feld	Typ	Beschreibung
tag	String	Ort der News

BrandingImage

Branding-Bild der öffentlichen Anstalt.

Feld	Typ	Beschreibung
title	String	Titel des Bildes ("Logo" + Anstalt)
copyright	String	(c) Text
alttext	String	Alternativer Text (entspricht title)
type	String	image
videowebm	VideoWeb	Link zum Bild
videowebs	VideoWeb	Link zum Bild (entspricht videowebm)

Kann es sein, dass die in ihrem JSON neuerdings einen Fehler eingebaut haben? Ich bekomme über Python ein JSON Decode Error und auf der Seite wird mir: "SyntaxError: JSON.parse: expected ',' or ']' after array element at line 7041 column 2 of the JSON data" angezeigt? Danke!

@Flammlachs Das passiert denen öfters, deren CMS ist irgendwie buggy bei der JSON-Erstellung. Fixt sich nach einiger Zeit von selbst, am besten einfach ein try-catch um das Parsen rumbauen

ah dann liegt es immerhin nicht an mir, vielen dank

Würde gern mittels mpv und nem kleinen Script einfach die letzte Tagesschau Sendung abspielen wollen.
Kann ich irgendwo abfragen, wie die URL der letzten Sendung ist, sodass ich diese in mpv füttern kann?

Da müsstest du glaube ich über die Mediathek gehen oder? Dafür gibt es meines Wissenstands nach keine fertige API.

@Brawl345 Kann es sein, dass die API seit März keine neuen Inhalte mehr lädt?

@foxgreek Was meinst du? Ich seh die neuesten News und mein EIlmeldungs-Bot sendet auch noch Eilmeldungen. Tagesschau.de lädt seit ner Stunde ca. aber etwas zäh und ich hatte gerade auch einen "Serivce Unavailable" Fehler. Du musst auch aufpassen, auf /api2 zu gehen, nicht nur /api

Offtopic: Erstaunlich wie der Gist noch aktiv kommentiert wird, hab den seit 2018 nie wirklich aktualisiert und auch nicht vor :/ Vielleicht findet sich jemand der eine Repo mit aktuellen Infos erstellt und alle dran mitmachen lässt?

@Brawl345 da hast du schon recht. Der /homepage Endpunkt funktioniert auch noch. Aber der /news Endpunkt hat keine neuen Beiträge mehr seit dem 28.02.
Ich habe jetzt übergangsweise auf den /homepage Endpunkt umgestellt.

Hi,
ich probier auch grad n bissl mit der tagesschau-api rum, aber da es mir auch mehr um Eilmeldungen geht, sind auf https://www.tagesschau.de/api2/ etwas arg viele Nachrichten dabei.

Ich sehe @Brawl345, du hast nen anderen Endpoint/andere API gefunden, die dir nur die Eilmeldungen ausspuckt (https://www.tagesschau.de/ipa/v1/web/headerapp/). Rein interessehalber, wie hast du den/die gefunden? (auf die normale API stößt man ja recht schnell, wenn man allgemein nach Tagesschau API im Internet sucht)
Und kleine weitere Frage (bin kein go Experte), soweit ich das sehe fragst du die API jede Minute einmal an oder? (war mir bisher unsicher bzgl der Zeit, die man warten sollte zwischen den Requests)

@atticus-sullivan: Die API findest du wenn du auf tagesschau.de gehst und alle XHR-Requests in den Browser-Devtools filterst. Wird auch periodisch immer wieder abgefragt, dadurch ist es mir mal ins Auge gestochen. Jup, die API ruf ich jede Minute ab. So viele wie tagesschau.de sicher lesen und wenn da eh im Hintergrund dann immer ein Request gemacht wird sollte das für die kein Problem sein.

EDIT: Du findest hier in dem Issue: Brawl345/tagesschau-eilbot#3 zwei beispiel-JSONs mit und ohne Eilmeldung falls du was zum Testen brauchst.

Ah verstehe 👍 Danke dir

Überholt von

http://tagesschau.api.bund.dev

https://github.com/bundesAPI/tagesschau-api

Überholt von

http://tagesschau.api.bund.dev

github.com/bundesAPI/tagesschau-api

Cool, hab das Gist mal aktualisiert und den Link eingefügt 👍

Bekomm seit heute auf https://www.tagesschau.de/ipa/v1/web/headerapp/ 404er. Der Endpoint scheint auf https://www.tagesschau.de/json/headerapp umgezogen zu sein

Stimmt, scheint heute um ca. 9:35 Uhr umgestellt worden zu sein da ich ab da 404er bekam. Danke dir!

Und hat jetz bissl gedauert bis ichs mir richtig angeschaut hab, die struktur der breakingNews im headerapp endpoint scheint sich in dem Zuge auch geändert zu haben. Hab dazu das hier als Beispiel "aufgezeichnet":

{
  "breakingNews": [
    {
      "headline": "Bürgermeisterwahl in Berlin: Wegner im 1. Wahlgang gescheitert",
      "text": "Der CDU-Politiker Kai Wegner ist bei der Wahl zum neuen Regierenden Bürgermeister von Berlin im ersten Wahlgang gescheitert. Der 50-Jährige verpasste bei der Abstimmung im Abgeordnetenhaus die erforderliche absolute Mehrheit.",
      "url": "/eilmeldung/eilmeldung-7196.html",
      "date": "Stand: 27.04.2023 12:53 Uhr",
      "id": "54ec4992-8048-4308-b5e4-4541e79dfc2f",
      "linkText": "Eilmeldung"
    }
  ]
}

Konkret ist das Datumsformat ein anderes geworden und die breakingNews sind jetzt eine Liste (soweit zumindest von den Infos die ich verwende, sonst sieht die url glaub noch bissl anders aus)

Altes aufgezeichnetes Formatsbeispiel zum Vergleich

{
  "breakingNews": {
    "headline": "Finnland ist offiziell NATO-Mitglied",
    "text": "Finnland ist offiziell der NATO beigetreten. Der finnische Außenminister Haavisto überreichte die Beitrittsurkunde seines Landes an US-Außenminister Blinken und schloss damit den Aufnahmeprozess ab.\r\n",
    "url": "https://www.tagesschau.de/ausland/europa/finnland-nato-mitglied-101.html",
    "date": "04.04.2023 - 15:13 Uhr",
    "id": "c9668947-9a8a-43c6-8fcd-228c36a068f6",
    "linkText": "Eilmeldung"
  }

Ich will einen newsticker auf dem Pi pico machen. Hat irgendwer eine Ahnung ob man dafür das Tagesschau API nutzen kann?

@NerdyPiglin123 Könntest in nem Intervall dir die News aus einigen Kategorien suchen und diese in eine chronologische Liste einpflegen, nach zeit sortieren und dann alles aus einer bestimmten reichweite durchlaufen lassen ($nachrichten[ $nachrichten[-1].zeit - $intervall] ) ... würd ich ma vermuten.

Ah okay danke

Weiß jemand wie man in Python die schriftgröße ändert?