Über die Landau Media API kannst Du alle Meldungen abrufen, die Dir auch in Deinem MediaAccount zur Verfügung stehen.
API Dokumentation
Alle technischen Details findest Du in unserer API-Doku:
https://api.media-account.de/swagger/index.html
Empfehlung zur API-Nutzung: Aktualisierung nach Update-Datum
Wir sind bestrebt, Dir Deine Meldungen schnellstmöglich zur Verfügung zu stellen. Daher werden wir Dir mitunter auch frühe, erste und zum Teil unfertige Versionen ausgespielt, die dann aktualisiert werden.
Zu einer vollständig produzierten Meldung können zum Beispiel ein Screenshot der Website, ein Mitschnitt der TV-Sendung oder die Engangementwerte eines Social Media-Posts gehören. Wenn alle Daten komplett sind, können wir das Medienblatt-PDF erzeugen und Deine Meldung wird um diese Dokumente und Daten ergänzt und aktualisiert.
Von der ersten Version Deines Clippings bis zur aktualisierten Version können ggf. auch einmal mehrere Stunden vergehen, auch wenn wenige Minuten die Regel sind. Die Engagement-Werte von Social-Media-Posts können sich auch nach Tagen noch stark ändern, denn es dauert ein bisschen, bis ein Betrag von jedem Follower gesehen wurde.
Aus diesem Grund empfehlen wir das Abrufen der Landau Media API nur anhand des Update-Datums. So kann sichergestellt werden, dass der User alle, aktuelle und vollständige Daten hat. Das macht erforderlich, dass Du die Meldungen, die Du schon kennst, aktualisieren kannst. Verwende immer das letzte, aktuellste Updatedatum um den nächsten Satz von Meldungen abzurufen.
Importdatum, Selektionsdatum, Erscheinungsdatum
Das Importdatum ist der Zeitpunkt, an dem eine Meldung zum ersten mal in der API abrufbar ist. Er ändert sich durch eine Aktualisierung nicht. Du kannst nach Importdatum abrufen, wenn du jede Meldung nur ein mal abrufen möchtest oder nicht aktualisieren kannst. Achte auf eine große Verzögerung beim Abruf, um möglichst vollständige Meldungen zu bekommen.
Das Selektionsdatum ist der Zeitpunkt, bei dem ein Rechercheur oder ein Rechercheprozess bei Landau Media entscheidet, dass es sich um einen Treffer im Sinne des Suchauftrags handelt und eine Meldung produziert wird. Zwischen dem Zeitpunkt der Selektion und dem ersten Erscheinen in der API vergehen in der Regel einige Minuten. Diese Verzögerung ist technisch bedingt.
Das Erscheinungsdatum ist der Zeitpunkt, der vom Verleger als Erscheinungsdatum geplant wird. Bei TV/Radio-Sendungen ist es der geplante Ausstrahlungszeitpunkt. Landau Media bekommt Publikationen oft Tage vor dem offiziellen Erscheinungsdatum, aber auch nachträgliche Lieferungen sind möglich. Der Abruf nach Erscheinungsdatum sollte nur verwendet werden, wenn die großen Abweichungen zwischen geplantem Erscheinungsdatum und tatsächlichem Fund-Zeitpunkt nicht relevant sind.
Lieferdatum, Digitalisierungsdatum
Nicht alle Meldungen bekommen ein Liefer- oder Digitalisierungsdatum. Diese Felder sind veraltet, werden weiterhin unterstützt und sind zum Abruf der API nicht empfohlen.
Das Lieferdatum ist historisch bedingt und beschreibt den Zeiptunkt, an dem wir eine Meldung gedruckt und postalisch Versandt haben. Bei Kunden, die keinen postalischen Versand haben entspricht es dem Zeitpunkt, an dem wir zum ersten mal ein vollständiges Medienblatt-PDF erzeugt haben.
Das Digitalisierungsdatum ist ebenfalls historisch bedingt und beschreibt den Zeiptunkt, an dem wir eine Meldung vollständig digitalisiert haben. Eine vollständige Digitalisierung erfolgt nur für Kunden, die das Produkt "Digitale Belieferung" bestellt haben, da bei digitaler Belieferung signifikante Lizenzkosten entstehen.
Du kannst die Felder als Hinweis verstehen, dass die Meldung vollständig ist. Aber Du solltest dich nicht darauf verlassen, dass die Zeitpunkte zeitnah oder überhaupt gesetzt werden.
Verzögerung und Überlagerung
Um keine Meldungen oder Updates zu verpassen, sollte die API mit etwas Verzögerung zum aktuellen Zeitpunkt und mit etwas Überlappung zum letzten Abruf erfolgen.
So wird verhindert, dass
Abweichungen in der Systemzeit zwischen Dir und unserer API,
viele Meldungen mit dem geichen Update-/Import-/Selektions-/...-Datum,
technisch bedingte Verzögerungen und Spitzen in der Auslastung unserer Systeme
zu Übersehern führen.
Do's & Don'ts
Do's
Beispiel 1: nach letzter Meldung
Die API wird alle 15 Minuten abgefragt, immer seit dem letzten gefundenen Updatedatum und mit 1 Sekunde Überlappung.
14:13:20 - nach Updatedatum von 00:00:00 bis 14:13:20 -> letztes Updatedatum 13:12:54
14:28:22 - nach Updatedatum von 13:12:53 bis 14:28:22 -> letztes Updatedatum 13:12:54
14:43:21 - nach Updatedatum von 13:12:53 bis 14:43:21 -> letztes Updatedatum 14:40:04
14:58:19 - nach Updatedatum von 14:40:03 bis 14:43:21 -> letztes Updatedatum 14:58:19
...
Beispiel 2: konstant Überlappend
Die API wird alle 5 Minuten abgefragt, immer für die letzten 10 Minuten.
14:13:20 - nach Updatedatum von 14:03:20 bis 14:13:20
14:18:24 - nach Updatedatum von 14:08:24 bis 14:18:24
14:23:27 - nach Updatedatum von 14:13:27 bis 14:23:27
...
Beispiel 3: mit Verzögerung und ohne Überlappung
Die API wird ein mal täglich für den Vortag abgefragt. Um keine Überseher durch Zeitdifferenzen, Zeitumstellungen etc. zu verursachen, mit 2.5h Verzögerung.
14.09.2024 02:30:01 - nach ImportDatum von 13.09.2024 00:00:00 bis 13.09.2024 23:59:59
15.09.2024 02:30:01 - nach ImportDatum von 14.09.2024 00:00:00 bis 14.09.2024 23:59:59
16.09.2024 02:30:01 - nach ImportDatum von 15.09.2024 00:00:00 bis 15.09.2024 23:59:59
...
Don'ts
Beispiel 4: Überseher durch Selektion ausserhalb des Erscheinungsdatums
Die API wird einmal täglich für den Vortag abgefragt. Viele Publikationen werden vor ihrem Erscheinungstag gefunden.
14.09.2024 02:30:01 - nach Erscheinungsdatum von 13.09.2024 00:00:00 bis 13.09.2024 23:59:59
15.09.2024 02:30:01 - nach Erscheinungsdatum von 14.09.2024 00:00:00 bis 14.09.2024 23:59:59
16.09.2024 02:30:01 - nach Erscheinungsdatum von 15.09.2024 00:00:00 bis 15.09.2024 23:59:59
...
Beispiel 5: keine Verzögerung, keine Überlappung
Die API wird alle 5 Minuten abgefragt, immer für die letzten 5 Minuten. Durch technische Verzögerungen kann es passieren, dass Meldungen die um 14:10 selektiert wurden, um 14:13 noch nicht in der Api abgerufen werden können. Durch Schwankungen beim Abruf entstehen zeitliche Lücken, die nicht abgedeckt sind.
14:13:20 - nach Selektionsdatum von 14:08:20 bis 14:13:20
14:18:24 - nach Selektionsdatum von 14:13:24 bis 14:18:24
14:23:27 - nach Selektionsdatum von 14:13:27 bis 14:23:27
...
Beispiel 6: keine Updates
Die API wird alle 5 Minuten abgefragt, immer für die letzten 10 Minuten. Es werden alle Meldungen gefunden, aber nicht alle Updates. Dafür ist die Überlappung zu klein.
14:13:20 - nach ImportDatum von 14:03:20 bis 14:13:20
14:18:24 - nach ImportDatum von 14:08:24 bis 14:18:24
14:23:27 - nach ImportDatum von 14:13:27 bis 14:23:27