Zum Inhalt springen

Preishistorie

Jede Änderung eines Items im Zeitverlauf, so weit die Historie Ihres Plans reicht.

/items/{id}/history listet alles, was mit einem Item passiert ist, das Älteste zuerst: wann es auftauchte, jede Preisänderung und jede andere Änderung, Entfernungen und erneute Listungen.

Shell
curl -H "Authorization: Bearer $PRICANA_KEY" https://pricana.io/api/v1/items/77/history
JSON
[
  { "id": 501, "kind": "NEW", "observedAt": "2026-09-01T10:00:00Z", "price": 1499.0, "previousPrice": null, "changes": null },
  { "id": 812, "kind": "CHANGED", "observedAt": "2026-10-06T21:03:00Z", "price": 1399.0, "previousPrice": 1499.0,
    "changes": { "price": [1499.0, 1399.0] } }
]

Ein Preisdiagramm

Der Preis zu einem bestimmten Zeitpunkt ist der price des letzten Eintrags davor. Für ein Diagramm zeichnen Sie eine Stufe je Eintrag:

Python
import os, requests

r = requests.get("https://pricana.io/api/v1/items/77/history",
                 headers={"Authorization": f"Bearer {os.environ['PRICANA_KEY']}"}, timeout=60)
r.raise_for_status()
points = [(e["observedAt"], e["price"]) for e in r.json() if e["price"] is not None]

observedAt ist der Zeitpunkt, zu dem Pricana die Änderung gesehen hat: höchstens ein Abrufintervall, nachdem sie im Shop passiert ist.

Wie weit zurück

Die Historie reicht so weit zurück, wie Ihr Plan es erlaubt (7 Tage bei Free, 90 bei Starter, 365 bei Pro, alles bei Business und Enterprise; siehe Preise). Ältere Einträge werden nicht angezeigt. Pricana bewahrt die Historie der Items 365 Tage auf.

Viele Items

Für die Historie vieler Items ist der Change-Feed günstiger als eine Anfrage je Item: Er listet alle Änderungen Ihrer Datasets in einem einzigen Strom.