BestPrice.gr API: τιμές, προσφορές και barcode σε JSON

Η λίστα αποτελεσμάτων μιας αναζήτησης ή κατηγορίας, τα καταστήματα που πουλούν ένα προϊόν με τις τιμές τους, η χαμηλότερη και η υψηλότερη τιμή του σε ευρώ: τα δημόσια στοιχεία του bestprice.gr έρχονται εδώ σε JSON, χωρίς εγγραφή στο BestPrice. Αν ο κατάλογός σας έχει barcode, η ενέργεια `barcode` βρίσκει απευθείας το αντίστοιχο προϊόν του BestPrice, εφόσον ο κωδικός υπάρχει στο ευρετήριό του, και γλιτώνετε την αντιστοίχιση με βάση τα ονόματα. Δεν απευθύνεται σε εμπόρους: δεν ανεβάζει XML feed και δεν συνδέεται με λογαριασμό εμπόρου στο BestPrice. Είναι η πλευρά του αγοραστή, όπως φαίνεται τη στιγμή της κλήσης.

Παράδειγμα που δουλεύει

Το BestPrice δεν έκανε αναζήτηση κειμένου: ανακατεύθυνε το ερώτημα στην κατηγορία «Κλιματιστικά με Inverter» (2442), οπότε οι 16 γραμμές είναι η λίστα αυτής της κατηγορίας, όπως δηλώνει το `redirected_to`. Σε κάθε γραμμή το `price_eur` αντιστοιχεί στο φθηνότερο κατάστημα· τις τιμές των υπόλοιπων τις φέρνει το `product` με το ίδιο `product_id`. Για το Toyotomi Umi παρακάτω, το `product` μέτρησε 47 καταστήματα, με τιμές από 417 έως 669 €.

curl -X POST https://api.reefapi.com/bestprice/v1/search \
  -H "x-api-key: ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ" \
  -H "content-type: application/json" \
  -d '{"query": "κλιματιστικό inverter"}'

{
  "ok": true,
  "data": {
    "products": [
      {
        "listing_type": "product",
        "product_id": "2159736789",
        "title": "Morris Terra WFIN-35180 Κλιματιστικό Inverter 12000 BTU A+++/A+++ με Ιονιστή και Wi-Fi",
        "price_eur": 223.87,
        "currency": "EUR",
        "category_id": "2442",
        "shop_count": 14
      },
      ...
      {
        "listing_type": "product",
        "product_id": "2159740957",
        "title": "Toyotomi Umi UTN-12CH/UTG-12CH Κλιματιστικό Inverter 12000 BTU A+++/A+++ με Ιονιστή και Wi-Fi",
        "price_eur": 417.0,
        "currency": "EUR",
        "category_id": "2442",
        "shop_count": 47
      },
      ...
    ],
    "page": 1,
    "limit": 24,
    "query": "κλιματιστικό inverter",
    "redirected_to": {
      "type": "category",
      "id": "2442",
      "title": "Κλιματιστικά με Inverter",
      "url": "https://www.bestprice.gr/cat/2442/air-condition/f/71_1/inverter.html"
    }
  },
  "meta": { "record_count": 16, "cache_hit": false, "mode": "live" }
}

Όρια και ειλικρινείς σημειώσεις

• Η υπηρεσία δεν προέρχεται από το BestPrice.gr: δεν είναι επίσημο API του, ούτε συνεργαζόμαστε μαζί του.
• Επιστρέφεται μόνο η πρώτη σελίδα κάθε λίστας, δηλαδή έως 16 προϊόντα· το `page` πάνω από 1 δεν φέρνει νέα. Για περισσότερα προϊόντα, κάντε την αναζήτηση πιο συγκεκριμένη ή ζητήστε μια πιο στενή κατηγορία.
• Το `product` φέρνει όσες προσφορές φορτώνει αρχικά η σελίδα του προϊόντος (30 σε κάθε προϊόν που μετρήσαμε, βλ. `offers_listed`), ενώ το `offer_count` μετράει όλη την αγορά: για το ψυγείο LG GBB566PZHMN, 48 καταστήματα και 30 στη λίστα. Το `price_high_eur` (εκεί 1.218,99 €) μπορεί να μην αντιστοιχεί σε καμία γραμμή του `offers[]`· στο ίδιο ψυγείο η ακριβότερη προσφορά της λίστας ήταν 849 €.
• Το `url` κάθε προσφοράς έρχεται null: σύνδεσμος προς τη σελίδα του καταστήματος δεν επιστρέφεται (60 στις 60 προσφορές σε δύο προϊόντα που ελέγξαμε).
• Το `barcode` δεν καλύπτει κάθε κωδικό: από 36 barcode που πήραμε από σελίδες του BestPrice βρέθηκαν τα 25. Στα ηλεκτρονικά και στις οικιακές συσκευές βρέθηκαν 3 στα 3, στο σούπερ μάρκετ και στα καλλυντικά 1 στα 3, στην κατηγορία PlayStation 0 στα 3. Κενή απάντηση σημαίνει ότι ο κωδικός δεν υπάρχει στο ευρετήριο barcode του BestPrice, όχι σφάλμα. Τότε μένει η διαδρομή `search` → `product`· το `product` επιστρέφει το `gtin`, που υπήρχε σε 36 από τις 36 σελίδες προϊόντων που ελέγξαμε.
• Η διαθεσιμότητα δεν έχει παντού το ίδιο λεξιλόγιο: στο `product` είναι `InStock` / `BackOrder`, στο `barcode` είναι `available`.