Shop Edit the file on GitHub

Table of Contents

Retrieve a single shop

  GET /shops/:id

GET http://api.skroutz.gr/shops/452

View Response
Show Headers
Status: 200
{
  "shop": {
    "id": 452,
    "name": "Kotsovolos",
    "link": "http://www.kotsovolos.gr",
    "phone": "2102899999",
    "image_url": "https://b.scdn.gr/ds/shops/logos/452/mid_20160829183952_bfbba903.jpeg",
    "thumbshot_url": "https://d.scdn.gr/ds/shops/screenshots/452/20150731105054_75756119.png",
    "reviews_count": 492,
    "latest_reviews_count": 127,
    "review_score": 4.3,
    "payment_methods": {
      "credit_card": true,
      "paypal": false,
      "bank": true,
      "spot_cash": true,
      "installments": "Εώς 12 άτοκες δόσεις μέσω πιστωτικής κάρτας για αγορές άνω των 60 Ευρω.\r\nΕώς 48 δόσεις μέσω δανειοδότησης Κωτσόβολου."
    },
    "shipping": {
      "free": true,
      "free_from": 85,
      "free_from_info": "",
      "min_price": "3.99",
      "shipping_cost_enabled": true
    },
    "web_uri": "http://skroutz.gr/m/452/Kotsovolos",
    "extra_info": {
      "time_on_platform": "3+ χρόνια",
      "orders_per_week": "500+"
    },
    "top_positive_reasons": [
      "Καταρτισμένο προσωπικό",
      "Προσεγμένη συσκευασία προϊόντων",
      "Φιλική εξυπηρέτηση"
    ]
  }
}

Retrieve a shop's reviews

Linked resources

  GET /shops/:id/reviews

GET http://api.skroutz.gr/shops/452/reviews

View Response
Show Headers
Status: 200
{
  "reviews": [
    {
      "id": 93026,
      "user_id": 208832,
      "review": "Έκανα την παραγγελία στις 26/1/17 - 14:45 , την ίδια μέρα το απόγευμα στέλνω mail ζητώντας να κρατηθεί το προϊόν αλλη μια μέρα αφού θα έλειπα εκτός Αθηνών. Λίγο αργότερα τηλεφωνώ ζητώντας το ίδιο πράγμα . Η ευγενέστατη υπάλληλος μου είπε πως αυτό δεν γινεται γιατι το σύστημα απο μόνο του μετά απο 72 ώρες ακυρώνει αυτόματα την παραγγελία. Εντάξει της λέω ,θα κάνω μια νέα παραγγελία την επόμενη μέρα για να παραλάβω το προϊόν στην πόλη της Χαλκίδας όπου και θα βρισκόμουν. Πηγαίνω λοιπόν στο κατάστημα για να το παραλάβω αλλά το προϊόν δεν υπήρχε , μου πρότειναν να πάρω το εκθεσιακό κομμάτι ,πράγμα το οποίο δεν δέχτηκα και μου είπαν να περιμένω 3 μέρες μέχρι να έρθει. Μετά απο όλη αυτή την περιπέτεια παρήγγειλα το προϊόν απο άλλο κατάστημα και ησύχασα. \r\nΝα σημειώσω οτι δέχτηκα τηλεφώνημα 4 μέρες μετά απο την εταιρία να με ρωτήσουν αν επικοινώνησε κανείς μαζί μου για το αίτημά που είχα κάνει.",
      "rating": 1.0,
      "shop_reply": null,
      "created_at": "2017-01-31T17:30:09+02:00",
      "negative": true,
      "reasons": [
        "Έλλειψη ενημέρωσης για την εξέλιξη της παραγγελίας",
        "Λανθασμένη διαθεσιμότητα",
        "Προβληματική επικοινωνία"
      ]
    },
    {
      "id": 93667,
      "user_id": 644178,
      "review": "Το παιχνιδι για την κονσολα PS4 ηρθε 2 ημερες μετα την παραγγελια. Ενημερωθηκα εγκαιρως και με ακριβεια. ++++",
      "rating": 5.0,
      "shop_reply": null,
      "created_at": "2017-02-04T17:44:03+02:00",
      "negative": false,
      "reasons": [
        "Ενημέρωση για την εξέλιξη της παραγγελίας",
        "Έγκαιρη παραλαβή",
        "Προσεγμένη συσκευασία"
      ]
    },
    {
      "id": 91511,
      "user_id": 634587,
      "review": "10 εργάσιμες το πολύ μου είπαν. 1 μήνας και μισός μέχρι τώρα χωρίς ενημέρωση και στο κατάστημα δεν βγάζω άκρη. Έβγαλαν προσφορά χωρις να υπάρχει διαθεσιμότητα . Δεν το περίμενα από μία τόσο μεγάλη αλυσίδα καταστημάτων.",
      "rating": 1.0,
      "shop_reply": null,
      "created_at": "2017-01-21T17:42:57+02:00",
      "negative": true,
      "reasons": [
        "Έλλειψη ενημέρωσης για την εξέλιξη της παραγγελίας",
        "Λανθασμένη διαθεσιμότητα",
        "Προβληματική επικοινωνία"
      ]
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 492,
      "total_pages": 164,
      "page": 1,
      "per": 3
    }
  }
}

Meta

You may choose to include extra meta information using the following parameter:

shop_rating_breakdown
Review stats. Contains the impression (positive or negative), the total count for that impression and a percentage to help the client draw a rating bar.

GET http://api.skroutz.gr/shops/452/reviews?include_meta=shop_rating_breakdown

View Response
Show Headers
Status: 200
{
  "reviews": [
    {
      "id": 75724,
      "user_id": 51807,
      "review": "Μια ακόμα παραγγελία οικιακών συσκευών από το ιντερνετομάγαζο του κωτσοβολου, σε όλα άψογοι, ταχύτητα εκτέλεσης-αποστολή παραγγελίας, πολύ καλές τιμές σε προϊόντα που βρήκα σε -πραγματική- προσφορά...",
      "rating": 5.0,
      "shop_reply": null,
      "created_at": "2016-10-05T16:17:03+03:00",
      "negative": false,
      "reasons": [
        "friendly",
        "ontime",
        "good_packaging"
      ]
    },
    {
      "id": 74103,
      "user_id": 283559,
      "review": "25/08/2016 κάνω ηλεκτρονικά παραγγελία ένα πλυντήριο ρούχων το οποίο βρήκα σε ανταγωνιστική τιμή. Την ίδια μέρα έκανα και ηλεκτρονικά την τραπεζική κατάθεση ολόκληρου το ποσού.  Την ίδια μέρα κάλεσα στο τηλεφωνικό κέντρο και ενημερώθηκα πως το συγκεκριμένο πλυντήριο δεν ήταν διαθέσιμο για άμεση παράδοση στον χώρο μου και πως η παράδοση θα γινόταν μετά τις 05/09/2016. Στις 05/09/2016 το προϊόν φαινόταν ως μη διαθέσιμο. Στις 12/09/2016 το προϊόν άλλαξε πάλι κατάσταση και φαινόταν ως διαθέσιμο για παράδοση στον χώρο μου. Σχεδόν κάθε 2 μέρες επικοινωνούσα με το κέντρο τηλεφωνικής εξυπηρέτησης και με ενημέρωναν πως η αντιπροσωπεία δεν τους έχει ακόμα παραδώσει το πλυντήριο στις αποθήκες τους. Το πλυντήριο συνέχιζε να φαίνεται διαθέσιμο παρόλα αυτά. Τελικά στις 19/09/2016 μετά από τηλεφώνημα που έκανα και πάλι ο ίδιος, με ενημέρωσαν πως ακόμα τους καθυστερεί η αντιπροσωπεία. Μα, τους λέω, στην ιστοσελίδα σας φαίνεται διαθέσιμο. Τότε υπάλληλος το ξανακοίταξε και μου είπε πως στις 20/09/2016 (την επόμενη μέρα) θα έχω το πλυντήριο. Σε κάθε τηλεφωνική επικοινωνία που είχα πάντα μου έλεγαν πως θα με καλέσουν εκείνοι για την παράδοση. Την ημέρα της παράδοσης μου είπαν πως θα λάβω μήνυμα στο κινητό για την εκτίμηση της ώρας παράδοσης. Ποτέ δεν έλαβα κλήση τηλεφωνική, ποτέ δεν έλαβα μήνυμα στο κινητό, ποτέ δεν έλαβα κάποιο email σχετικά με την ημέρα και ώρα παράδοσης του προϊόντος. Λίγες ακόμα ημέρες και θα κλείναμε μήνα για παράδοση ενός προϊόντος που είναι είδος πρώτης ανάγκης!",
      "rating": 1.0,
      "shop_reply": null,
      "created_at": "2016-09-21T11:33:55+03:00",
      "negative": true,
      "reasons": [
        "order_status_absent",
        "wrong_availability"
      ]
    },
    {
      "id": 73770,
      "user_id": 529941,
      "review": "πήγα στο κατάστημα για να αγοράσω μια 50άρα τηλεόραση Samsung με την ελπίδα ότι θα υπήρχε αλλά τελικά δεν στάθηκα τυχερός 14/9 έκανα την παραγγελία και τσεκαροντας η πωλητρια την διαθεσιμότητα μου είπε πως παραλαβανε εκείνη την ημέρα αλλά δεν είχαν προλάβει να τα περάσουν στο σύστημα και δίνοντας τον λόγο της πως μέχρι της 16 θα παραλάβω αν όχι το αργότερο στης 19/9 πέρασε η 16/9 και περνώ τηλέφωνο να μάθω για την εξέλιξη της παραγγελίας. η απάντηση που πήρα είναι πως δεν είναι διαθέσιμη και πως θα παραλάβουν τέλος του μήνα!!! ακούγοντας αυτό έφυγα για το κατάστημα όπου και βρίσκω την πωλητρια και μου λέει με μια φυσικοτητα πως έπρεπε να τουλάχιστον να είχα ενημερωθεί για το πότε θα παραλάβω...μετά από ένα μεγάλο χαμό ασυνενωησιας όλου του προσωπικού καταλήξανε πως θα παραλάβω μέσα στην βδομάδα επειδή δεν με επησαν οι απαντήσεις τους σκέφτηκα να ξαναπάρω τηλ να το επιβεβαιώσω και μου έδωσαν πάλι την απάντηση πως θα παραλάβω τέλος του μήνα!!! αποτέλεσμα να έχω εξόφληση την συσκευή μέσω πιστωτικής και να μην ξέρω πότε θα παραλάβω και περιμένοντας μπας και μου έρθει κάποιο μνμ!!! απαραδεκτοι! θέλω να ακυρώσω την παραγγελία και δεν μπορώ!!!",
      "rating": 1.0,
      "shop_reply": null,
      "created_at": "2016-09-18T00:21:36+03:00",
      "negative": true,
      "reasons": [
        "order_status_absent",
        "wrong_availability",
        "bad_communication"
      ]
    }
  ],
  "meta": {
    "shop_rating_breakdown": [
      {
        "impression": "positive",
        "percentage": 45,
        "count": 46
      },
      {
        "impression": "negative",
        "percentage": 55,
        "count": 56
      }
    ],
    "pagination": {
      "total_results": 417,
      "total_pages": 139,
      "page": 1,
      "per": 3
    }
  }
}

List shop locations

Linked resources

  GET /shops/:shop_id/locations

GET http://api.skroutz.gr/shops/452/locations

View Response
Show Headers
Status: 200
{
  "locations": [
    {
      "id": 2500,
      "headquarter": true,
      "phones": [
        "2102899999"
      ],
      "pickup_point": false,
      "store": false,
      "full_address": "14ο ΧΛΜ ΕΟ ΑΘΗΝΩΝ ΛΑΜΙΑΣ 14, Τ.Κ. 14452, ΜΕΤΑΜΟΡΦΩΣΗ, Αττικής",
      "format": "structured",
      "lat": "38.062297",
      "lng": "23.75991",
      "info": ""
    },
    {
      "id": 1696,
      "headquarter": false,
      "phones": [
        "2102899999"
      ],
      "pickup_point": true,
      "store": true,
      "full_address": "ΛΕΩΦΟΡΟΣ ΗΡΑΚΛΕΙΟΥ 271, Τ.Κ. 14231, ΝΕΑ ΙΩΝΙΑ, Αττικής",
      "format": "structured",
      "lat": "38.044771",
      "lng": "23.756156",
      "info": ""
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 69,
      "total_pages": 35,
      "page": 1,
      "per": 2
    }
  }
}

Addresses can be included / embedded using the address value. Addresses are expanded versions of the full_address field. If the format of the Location is structured then the address fields will be populated. If the format is unstructured then the fields will be null.

  GET /shops/:shop_id/locations?embed=address

GET http://api.skroutz.gr/shops/452/locations?embed=address

View Response
Show Headers
Status: 200
{
  "locations": [
    {
      "id": 2500,
      "headquarter": true,
      "phones": [
        "2102899999"
      ],
      "pickup_point": false,
      "store": false,
      "full_address": "14ο ΧΛΜ ΕΟ ΑΘΗΝΩΝ ΛΑΜΙΑΣ 14, Τ.Κ. 14452, ΜΕΤΑΜΟΡΦΩΣΗ, Αττικής",
      "format": "structured",
      "lat": "38.062297",
      "lng": "23.75991",
      "info": "",
      "address": {
        "id": 2500,
        "street_number": "14",
        "street": "14ο ΧΛΜ ΕΟ ΑΘΗΝΩΝ ΛΑΜΙΑΣ",
        "postcode": "14452",
        "city": "ΜΕΤΑΜΟΡΦΩΣΗ",
        "region": "Αττικής",
        "country": "Ελλάδα"
      }
    },
    {
      "id": 1696,
      "headquarter": false,
      "phones": [
        "2102899999"
      ],
      "pickup_point": true,
      "store": true,
      "full_address": "ΛΕΩΦΟΡΟΣ ΗΡΑΚΛΕΙΟΥ 271, Τ.Κ. 14231, ΝΕΑ ΙΩΝΙΑ, Αττικής",
      "format": "structured",
      "lat": "38.044771",
      "lng": "23.756156",
      "info": "",
      "address": {
        "id": 1696,
        "street_number": "271",
        "street": "ΛΕΩΦΟΡΟΣ ΗΡΑΚΛΕΙΟΥ",
        "postcode": "14231",
        "city": "ΝΕΑ ΙΩΝΙΑ",
        "region": "Αττικής",
        "country": "Ελλάδα"
      }
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 69,
      "total_pages": 35,
      "page": 1,
      "per": 2
    }
  }
}

Retrieve a single shop location

Linked resources

  GET /shops/:shop_id/locations/:id

GET http://api.skroutz.gr/shops/452/locations/2500

View Response
Show Headers
Status: 200
{
  "location": {
    "id": 2500,
    "headquarter": true,
    "phones": [
      "2102899999"
    ],
    "pickup_point": false,
    "store": false,
    "full_address": "14ο ΧΛΜ ΕΟ ΑΘΗΝΩΝ ΛΑΜΙΑΣ 14, Τ.Κ. 14452, ΜΕΤΑΜΟΡΦΩΣΗ, Αττικής",
    "format": "structured",
    "lat": "38.062297",
    "lng": "23.75991",
    "info": ""
  }
}

Addresses can be included / embedded using the address value. Addresses are expanded versions of the full_address field.

  GET /shops/:shop_id/locations/:id?embed=address

GET http://api.skroutz.gr/shops/452/locations/2500?embed=address

View Response
Show Headers
Status: 200
{
  "location": {
    "id": 2500,
    "headquarter": true,
    "phones": [
      "2102899999"
    ],
    "pickup_point": false,
    "store": false,
    "full_address": "14ο ΧΛΜ ΕΟ ΑΘΗΝΩΝ ΛΑΜΙΑΣ 14, Τ.Κ. 14452, ΜΕΤΑΜΟΡΦΩΣΗ, Αττικής",
    "format": "structured",
    "lat": "38.062297",
    "lng": "23.75991",
    "info": "",
    "address": {
      "id": 2500,
      "street_number": "14",
      "street": "14ο ΧΛΜ ΕΟ ΑΘΗΝΩΝ ΛΑΜΙΑΣ",
      "postcode": "14452",
      "city": "ΜΕΤΑΜΟΡΦΩΣΗ",
      "region": "Αττικής",
      "country": "Ελλάδα"
    }
  }
}

Search for shops

  GET /shops/search?q=value
Name Type Description
q String Search with the value of this parameter

GET http://api.skroutz.gr/shops/search?q=spartoo

View Response
Show Headers
Status: 200
{
  "shops": [
    {
      "id": 1449,
      "name": "Spartoo",
      "link": "http://www.spartoo.gr",
      "phone": "2111987531",
      "image_url": "https://b.scdn.gr/ds/shops/logos/1449/mid_a38a900f-c94a-46c0-ac35-07cc8f82e4b3.jpg",
      "thumbshot_url": "https://a.scdn.gr/ds/shops/screenshots/1449/20160914165438_0b016179.jpeg",
      "reviews_count": 38,
      "latest_reviews_count": 16,
      "review_score": 4.9,
      "payment_methods": {
        "credit_card": true,
        "paypal": true,
        "bank": false,
        "spot_cash": true,
        "installments": ""
      },
      "shipping": {
        "free": true,
        "free_from": null,
        "free_from_info": "",
        "min_price": ""
      },
      "web_uri": "http://skroutz.gr/m/1449/Spartoo",
      "extra_info": {
        "time_on_platform": "3+ χρόνια",
        "orders_per_week": "500+"
      },
      "top_positive_reasons": [
        "order_status_present"
      ]
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 1,
      "total_pages": 1,
      "page": 1,
      "per": 25
    }
  }
}