API

Skroutz API: προσφορές καταστημάτων σε JSON

Το Skroutz είναι το ίδιο μηχανή σύγκρισης τιμών, και αυτό ακριβώς κάνει χρήσιμη αυτή την πρόσβαση: δεν παίρνετε μία τιμή, αλλά όλες τις προσφορές των καταστημάτων για ένα προϊόν σε μία κλήση. Δεν χρειάζεται λογαριασμός και η απάντηση έρχεται σε JSON.

Αποκτήστε δωρεάν κλειδί Πλήρης τεκμηρίωση: κάθε endpoint, κάθε παράμετρος →

Endpoints

endpoint	Τι επιστρέφει	Υποχρεωτικά
search	Αναζήτηση με λέξη-κλειδί: id προϊόντος Skroutz, τίτλος, εικόνα, χαμηλότερη τιμή και πλήθος καταστημάτων.	query
product/detail	Η πλήρης καρτέλα με `product_id` ή URL: τίτλος, μάρκα, περιγραφή, εικόνες και χαρακτηριστικά.	product_id
product/offers	Ο λόγος που έρχεται κανείς εδώ: κάθε προσφορά ελληνικού καταστήματος για ένα προϊόν, με κατάστημα, τιμή και διαθεσιμότητα.	product_id

Κάθε κλήση χρεώνεται σε credits. Οι αποτυχημένες και μπλοκαρισμένες κλήσεις είναι δωρεάν.

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

Η τιμή που φαίνεται στην αναζήτηση είναι η χαμηλότερη προσφορά, όχι η τιμή ενός μοναδικού πωλητή. Ποιος ανταγωνίζεται ποιον φαίνεται μόνο στο product/offers.

Αίτημα

curl -X POST https://api.reefapi.com/skroutz/v1/product/offers \
  -H "x-api-key: ΤΟ_ΚΛΕΙΔΙ_ΣΑΣ" \
  -H "content-type: application/json" \
  -d '{"product_id": "..."}'

Απάντηση (συντομευμένη)

{
  "ok": true,
  "data": {
    "offers": [
      {
        "shop": "...",
        "price": 349.0,
        "currency": "EUR",
        "availability": "..."
      }
    ]
  },
  "meta": { "record_count": 18, "cache_hit": false, "mode": "live" }
}

Αντί για δικό σας scraper στο Skroutz

Ένας δικός σας scraper για το Skroutz δουλεύει την πρώτη μέρα. Το δύσκολο έρχεται μετά: όταν αλλάξει η δομή της λίστας προσφορών, ο parser επιστρέφει κενή λίστα αντί για σφάλμα, και σε μεγαλύτερη διαδρομή η προστασία από bots κόβει τη ροή στη μέση.

Εδώ τη συντήρηση την αναλαμβάνουμε εμείς: αν αλλάξει το σχήμα διορθώνουμε τη μηχανή, και αν υπάρξει μπλοκάρισμα επιστρέφεται κωδικός σφάλματος χωρίς χρέωση.

Για μία εφάπαξ εξαγωγή το δικό σας script είναι φθηνότερο, και το λέμε ευθέως. Για παρακολούθηση που πρέπει να τρέχει κάθε μέρα, το κόστος δεν είναι ο κώδικας αλλά οι βλάβες που δεν βλέπει κανείς.

This page in English →Πλήρης τεκμηρίωση: κάθε endpoint, κάθε παράμετρος →

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

Δεν είναι το επίσημο API του Skroutz και δεν έχουμε συνεργασία με το Skroutz.
Η τιμή στην αναζήτηση είναι η χαμηλότερη προσφορά· οι υπόλοιπες φαίνονται στο product/offers.
Αν ένα κατάστημα δεν δημοσιεύει διαθεσιμότητα, το πεδίο επιστρέφεται null — δεν συμπληρώνουμε τίποτα.
Χωρίς cache: κάθε κλήση δείχνει την κατάσταση εκείνης της στιγμής.