Filter, Sortierung und Seiten
Finden Sie mit Filtern und Facetten die Items, die Sie brauchen, sortieren Sie sie und blättern Sie durch die Ergebnisse.
/items liefert die Items Ihrer Datasets, Seite für Seite. Filter grenzen sie ein; /facets sagt, welche Filterwerte
es gibt.
Filter
| Parameter | Beispiel | Liefert Items … |
|---|---|---|
dataset | 12 | aus einem Ihrer Datasets |
site | 4 | von einer Website (ids aus /facets) |
category | computers-laptops | aus dieser Kategorie oder darunter |
q | thinkpad x1 | mit all diesen Wörtern, in beliebiger Reihenfolge, in Titel, Marke, Codes oder anderen Werten (auch Wortteile) |
minPrice, maxPrice | 500, 1500 | in diesem Preisbereich (in der Währung des Items) |
currency | EUR | in dieser Währung |
gtin | 0196802123456 | mit diesem Produktcode (dasselbe Produkt in jedem Shop) |
status | active | active (jetzt gelistet, Standard), removed oder all |
changedSince | 2026-10-01T00:00:00Z | die sich nach diesem Zeitpunkt geändert haben |
Filter lassen sich kombinieren: Jeder angegebene Filter muss zutreffen.
curl -H "Authorization: Bearer $PRICANA_KEY" \
"https://pricana.io/api/v1/items?category=computers-laptops&maxPrice=1000&sort=price"Facetten
/facets listet die Websites, Kategorien und Währungen Ihrer Datasets mit der Zahl der jetzt gelisteten Items, zum
Beispiel für Filtermenüs:
curl -H "Authorization: Bearer $PRICANA_KEY" https://pricana.io/api/v1/facetsKategorien bilden einen Baum (parentId); die Zahl einer Kategorie schließt ihre Unterkategorien ein.
Sortierung
sort nimmt price, -price (höchster Preis zuerst), -lastChanged (Standard: zuletzt geänderte zuerst),
-lastSeen, -firstSeen (neueste Listings zuerst) oder title. Items mit gleichem Wert behalten eine feste
Reihenfolge (nach id), damit beim Blättern keines übersprungen oder doppelt geliefert wird, solange sich die Daten nicht
ändern.
Seiten
page zählt ab 0, size liegt zwischen 1 und 500 (Standard 50). Die Antwort sagt, wie viele es insgesamt sind:
{ "content": [ … ], "page": 0, "size": 50, "totalElements": 1804, "totalPages": 37 }Seiten werden bei jeder Anfrage neu berechnet: Ändern sich Items zwischen zwei Anfragen, kann sich eine spätere Seite verschieben. Um alles auf einmal zu lesen, nutzen Sie einen Export; um Änderungen zu folgen, den Change-Feed.
Entfernte Items
Standardmäßig bekommen Sie die jetzt gelisteten Items. status=removed liefert die, die ein Shop nicht mehr listet (mit
removedAt), status=all beide. Entfernte Items bleiben lesbar, solange die Historie Ihres Plans so weit zurückreicht.