Zum Inhalt springen

Preise über Shops hinweg vergleichen

Produkte fassen die Angebote desselben Produkts in verschiedenen Shops zusammen, über die GTIN oder über Marke und Artikelnummer.

Ein Item ist das Angebot eines Shops. Ein Produkt fasst die Items aller Shops zusammen, die dasselbe verkaufen, damit Sie ihre Preise vergleichen können.

Wie aus Items Produkte werden

  • Items mit derselben GTIN (EAN/UPC, die Nummer unter dem Barcode) sind dasselbe Produkt. Pricana behält nur GTINs, die überall dasselbe bedeuten (mit gültiger Prüfziffer; keine ladeninternen Nummern oder Gutscheine).
  • Items ohne GTIN werden nach Marke und Herstellerartikelnummer (MPN) gruppiert. Bekommt eine solche Gruppe später eine GTIN, wird diese ihre id; die alte id antwortet weiterhin.

Die id eines Produkts ist seine GTIN (Ziffern), sonst sein Schlüssel aus Marke und MPN (lenovo.21kc004mge).

Produkte finden

Shell
curl -H "Authorization: Bearer $PRICANA_KEY" \
  "https://pricana.io/api/v1/products?q=thinkpad&minShops=2&sort=price"

minShops=2 behält die Produkte, die mindestens zwei Websites verkaufen: die, die Sie vergleichen können. Jedes Produkt hat seine Preisspanne je Währung, die Zahl seiner Angebote und die Zahl der Shops:

JSON
{
  "id": "0196802123456",
  "gtin": "0196802123456",
  "brand": "Lenovo",
  "title": "Lenovo ThinkPad X1 Carbon Gen 12",
  "offers": 6,
  "shops": 5,
  "prices": [{ "currency": "EUR", "min": 1349.0, "max": 1529.0, "offers": 6 }]
}

Filter: dataset, q, category, brand, gtin, currency, minShops; sort ist -offers (Standard), -shops, price oder -price.

Ein Produkt und seine Angebote

Shell
curl -H "Authorization: Bearer $PRICANA_KEY" https://pricana.io/api/v1/products/0196802123456

Die Antwort enthält das Produkt mit allen Angeboten, die Sie sehen können, die günstigsten zuerst. Jedes Angebot ist ein vollständiges Item, mit Shop und Link.

Gut zu wissen

  • Produkte enthalten nur Angebote, die Sie sehen können: aus Ihren Datasets und von den Websites, deren Daten Pricana weitergeben darf.
  • Derselbe Shop kann ein Produkt zweimal listen (zwei Varianten, ein Händler auf einem Marktplatz); shops zählt Websites, offers Items.
  • Um den Preis eines Produkts über die Zeit zu verfolgen, lesen Sie die Historie seiner Angebote.