Grundbegriffe
Datasets, Items, Änderungen, Produkte, Kategorien und Sites und wie sie zusammenhängen.
Dataset
Ein Dataset ist ein Thema (Laptops, Reifen, Drogerie …), gesammelt von mehreren Websites. Ihr Plan enthält eine
bestimmte Zahl von Datasets; Sie wählen sie im Portal. Jede Anfrage lässt sich mit dataset=<id> auf eines davon
eingrenzen; ohne diesen Parameter gilt sie für alle Ihre Datasets. /datasets listet sie mit Größe und Aktualität.
Site und Quelle
Eine Site ist eine Website, von der die Daten stammen, eine Quelle (Source) ein Listing davon (zum Beispiel
eine Kategorieseite). Pricana liest jede Quelle regelmäßig und repariert sie selbst, wenn sich die Website ändert. Items
nennen beides (site, source). Daten aus offenen Quellen tragen ihre Lizenz in site.attribution: Geben Sie diese
Angabe mit den Daten weiter.
Item
Ein Item ist ein Listing: ein Produkt, das ein Shop anbietet, mit Titel, Preis, Währung, Link, Bild, Kategorie und
den übrigen Werten des Shops (attributes, etwa Verfügbarkeit oder Versand). Es behält seine id, solange der Shop es
listet. Listet der Shop es nicht mehr, gilt das Item als entfernt (removedAt ist gesetzt), bleibt aber mit seiner
Historie lesbar; listet der Shop es wieder, ist es wieder gelistet.
Änderung
Wann immer sich an einem Item etwas ändert, hält Pricana eine Änderung (Change) fest:
| kind | bedeutet |
|---|---|
NEW | das Item ist neu aufgetaucht |
CHANGED | ein Wert hat sich geändert (changes sagt, welcher: alt und neu); bei einer Preisänderung gibt es zusätzlich previousPrice |
REMOVED | der Shop listet es nicht mehr |
RELISTED | es ist wieder da |
Änderungen haben aufsteigende ids. Der Change-Feed listet sie der Reihe nach, Webhooks schicken sie Ihnen, und die Historie eines Items sind seine Änderungen im Zeitverlauf.
Produkt
Ein Produkt fasst die Items verschiedener Shops zusammen, die dasselbe verkaufen: über die GTIN (EAN/UPC), sonst über Marke und Herstellerartikelnummer (MPN). Produkte liefern die Preisspanne und die Zahl der Shops je Produkt.
Kategorie
Pricana ordnet Items in eine einheitliche Taxonomie ein (category.slug, category.path), egal wie der Shop seine
Kategorien nennt. category.source sagt, wer sie gewählt hat: AI oder MANUAL (ein Mensch).
Aktualität und Plan
Wie aktuell die Daten sind und wie weit ihre Historie zurückreicht, hängt von Ihrem Plan ab: Free zeigt die Beispieldaten mit dem Stand von vor 24 Stunden und sieben Tagen Historie; bezahlte Pläne sind aktuell. Einzelheiten stehen unter Limits und Kontingente.