Vorraussetzungen
Um historische Daten zu erhalten, ist ein entsprechender Vertrag für historische Daten nötig. Eine Übersicht aller Verträge stehen auf ITscope.com zur Verfügung.
Historische Daten stehen nur ab der API 2.1 (aktuelle API Version) und nur bei product (products/ean, products/id, products/search) API Requests zur Verfügung. Per Datenexporte werden keine historischen Daten zur Verfügung gestellt.
Request Parameter
Um historische Daten per API zu erhalten sind gewissen Parameter anzugeben, diese sind auch in der interaktiven API 2.1 ersichtlich:
- historyFrom: Der Startzeitpunkt für historische Daten im Format yyyy-MM-dd. Nur wenn dieser Parameter gesetzt ist und die oben genannten Vorraussetzungen erfüllt sind, werden historische Daten der Response hinzugefügt. Es muss nicht immer der Anfang des Monats oder Anfang der Woche übergeben werden, da die entsprechenden Aggregationsmethode automatisch immer den ersten Tag des Monats oder den ersten Tag der Woche ermittelt.
- historyTo: Der Endzeitpunkt für historische Daten im Format yyyy-MM-dd. Wird kein Wert übermittel ist der Defaultwert das aktuelle Datum.
- historyAggregation: Die Granularität der historischen Daten. Mögliche Werte weekly für wochentliche und monthly für monatliche Aggregation. Der Parameter muss gesetzt werden, da es kein Defaultwert gibt.
Auch die Responsezeiten hängen sehr stark von diesen Requestparametern ab, da je nach angefragten Zeiträumen und Aggregation entsprechende historische Daten nachgeladen oder verdichtet werden müssen.
Datenformate
Die historischen Daten sind in den API 2.1 Datenformaten standard und developer vorhanden. In den jeweiligen Datenformaten sind auch die einzelnen Felder und Datentypen beschrieben.
Beispiele
Wöchentliche Preisentwicklung von einem Beispiel Produkt:
Suche nach „IPhone 8 Plus“ historische Preise für ein bestimmtes Datum zum Filtern und Berechnen abzurufen: