Product Edit the file on GitHub

Retrieve a single product
Retrieve an SKU's products
Retrieve an SKU's products grouped in cards
Show Personalization info
Update Personalization info
Search for products

Retrieve a single product

  GET /products/:id

GET https://api.skroutz.gr/products/29878439

View Response

Show Headers

Status: 200

Access-Control-Allow-Origin: *
Access-Control-Request-Method: *
Cache-Control: max-age=300, private
Connection: close
Content-Length: 790
Content-Type: application/json; charset=utf-8
Date: Fri, 26 Jan 2018 16:43:42 GMT
Etag: W/"27bd8ba3e38cbb9164f349bae418b3dc"
Server: WEBrick/1.3.1 (Ruby/2.3.3/2016-11-21)
Set-Cookie: locale=el_GR; path=/
X-Request-Id: 97f90b8e-b612-4ea9-bdf4-1a82a77a10b9
X-Runtime: 0.439096

{
  "product": {
    "id": 29878439,
    "name": "Apple iPhone 5S Space Grey 16 GB EU ( ✔ΔΩΡΟ ΘΗΚΗ + ✔TEMPERED GLASS )",
    "sku_id": 3783654,
    "shop_id": 4102,
    "category_id": 40,
    "availability": "Παράδοση 1 έως 3 ημέρες",
    "click_url": "https://www.skroutz.gr/products/show/29878439?client_id=XIbz2_n2p94JTskRpHu9wQ%3D%3D&from=api",
    "shop_uid": "548",
    "expenses": null,
    "web_uri": "http://skroutz.gr:3000/products/show/29878439",
    "sizes": [

    ],
    "blp": {
      "shipping_cost": 4.41,
      "payment_method_cost": 3.5,
      "final_price": 297.81
    },
    "price": 289.9,
    "immediate_pickup": false
  },
  "meta": {
    "personalization": {
      "location": {
        "address_id": 25522,
        "label": "Αλέκου Παναγούλη 91, Νέα Ιωνία",
        "lat": "38.043322",
        "lng": "23.760006",
        "type": "address",
        "country_code": "GR"
      },
      "payment_method": {
        "type": "spot_cash"
      }
    }
  }
}

Retrieve an SKU's products

GET /skus/:id/products

GET https://api.skroutz.gr/skus/3783654/products

View Response

Show Headers

Status: 200

Access-Control-Allow-Origin: *
Access-Control-Request-Method: *
Cache-Control: max-age=300, private
Connection: close
Content-Length: 5406
Content-Type: application/json; charset=utf-8
Date: Thu, 25 Jan 2018 11:14:25 GMT
Etag: W/"2b744e61701515c24b8f05f903b52c87"
Server: WEBrick/1.3.1 (Ruby/2.3.3/2016-11-21)
Set-Cookie: locale=el_GR; path=/
X-Request-Id: db3eee22-49c0-47a4-9d2b-818b11d81320
X-Runtime: 0.302806

{
  "products": [
    {
      "id": 14315533,
      "name": "APPLE IPHONE 5S 16GB SPACE GREY",
      "sku_id": 3783654,
      "shop_id": 670,
      "category_id": 40,
      "availability": "Παράδοση 1 έως 3 ημέρες",
      "click_url": "https://www.skroutz.gr/products/show/14315533?client_id=XIbz2_n2p94JTskRpHu9wQ%3D%3D&from=api",
      "shop_uid": "220004753",
      "expenses": null,
      "web_uri": "http://skroutz.gr:3000/products/show/14315533",
      "sizes": [

      ],
      "blp": {
        "shipping_cost": 0.0,
        "payment_method_cost": 0.0,
        "final_price": 275.77
      },
      "price": 275.77,
      "immediate_pickup": false
    },
    {
      "id": 29878439,
      "name": "Apple iPhone 5S Space Grey 16 GB EU ( ✔ΔΩΡΟ ΘΗΚΗ + ✔TEMPERED GLASS )",
      "sku_id": 3783654,
      "shop_id": 4102,
      "category_id": 40,
      "availability": "Παράδοση 1 έως 3 ημέρες",
      "click_url": "https://www.skroutz.gr/products/show/29878439?client_id=XIbz2_n2p94JTskRpHu9wQ%3D%3D&from=api",
      "shop_uid": "548",
      "expenses": null,
      "web_uri": "http://skroutz.gr:3000/products/show/29878439",
      "sizes": [

      ],
      "blp": {
        "shipping_cost": 4.41,
        "payment_method_cost": 3.5,
        "final_price": 297.81
      },
      "price": 289.9,
      "immediate_pickup": false
    },
    {
      "id": 24067693,
      "name": "Apple Apple iPhone 5S 16GB Gold",
      "sku_id": 3783654,
      "shop_id": 3194,
      "category_id": 40,
      "availability": "Άμεση παραλαβή / Παράδοση 1 έως 3 ημέρες",
      "click_url": "https://www.skroutz.gr/products/show/24067693?client_id=XIbz2_n2p94JTskRpHu9wQ%3D%3D&from=api",
      "shop_uid": "82392",
      "expenses": null,
      "web_uri": "http://skroutz.gr:3000/products/show/24067693",
      "sizes": [

      ],
      "blp": {
        "shipping_cost": 2.75,
        "payment_method_cost": 2.0,
        "final_price": 294.75
      },
      "price": 290.0,
      "immediate_pickup": true
    },
    {
      "id": 27290469,
      "name": "Apple iPhone 5S 16GB Gold EU",
      "sku_id": 3783654,
      "shop_id": 4057,
      "category_id": 40,
      "availability": "Άμεση παραλαβή / Παράδοση 1 έως 3 ημέρες",
      "click_url": "https://www.skroutz.gr/products/show/27290469?client_id=XIbz2_n2p94JTskRpHu9wQ%3D%3D&from=api",
      "shop_uid": "103",
      "expenses": null,
      "web_uri": "http://skroutz.gr:3000/products/show/27290469",
      "sizes": [

      ],
      "blp": {
        "shipping_cost": 4.0,
        "payment_method_cost": 4.0,
        "final_price": 307.9
      },
      "price": 299.9,
      "immediate_pickup": true
    },
    {
      "id": 33344738,
      "name": "Apple iPhone 5S 16GB Silver",
      "sku_id": 3783654,
      "shop_id": 4724,
      "category_id": 40,
      "availability": "Άμεση παραλαβή / Παράδοση 1 έως 3 ημέρες",
      "click_url": "https://www.skroutz.gr/products/show/33344738?client_id=XIbz2_n2p94JTskRpHu9wQ%3D%3D&from=api",
      "shop_uid": "319",
      "expenses": null,
      "web_uri": "http://skroutz.gr:3000/products/show/33344738",
      "sizes": [

      ],
      "blp": {
        "shipping_cost": 4.0,
        "payment_method_cost": 2.0,
        "final_price": 396.0
      },
      "price": 390.0,
      "immediate_pickup": true
    },
    {
      "id": 20815392,
      "name": "Apple iPhone 5S 16GB Silver - (EU)",
      "sku_id": 3783654,
      "shop_id": 1294,
      "category_id": 40,
      "availability": "Κατόπιν παραγγελίας",
      "click_url": "https://www.skroutz.gr/products/show/20815392?client_id=XIbz2_n2p94JTskRpHu9wQ%3D%3D&from=api",
      "shop_uid": "21463",
      "expenses": null,
      "web_uri": "http://skroutz.gr:3000/products/show/20815392",
      "sizes": [

      ],
      "blp": {
        "shipping_cost": 4.0,
        "payment_method_cost": 0.0,
        "final_price": 403.0
      },
      "price": 399.0,
      "immediate_pickup": false
    },
    {
      "id": 25844011,
      "name": "iPhone 5s Silver 16Gb",
      "sku_id": 3783654,
      "shop_id": 3882,
      "category_id": 40,
      "availability": "Κατόπιν παραγγελίας",
      "click_url": "https://www.skroutz.gr/products/show/25844011?client_id=XIbz2_n2p94JTskRpHu9wQ%3D%3D&from=api",
      "shop_uid": "238",
      "expenses": null,
      "web_uri": "http://skroutz.gr:3000/products/show/25844011",
      "sizes": [

      ],
      "blp": {
        "shipping_cost": 0.0,
        "payment_method_cost": 3.8,
        "final_price": 413.8
      },
      "price": 410.0,
      "immediate_pickup": false
    },
    {
      "id": 25843947,
      "name": "iPhone 5s Space Gray 16Gb",
      "sku_id": 3783654,
      "shop_id": 3882,
      "category_id": 40,
      "availability": "Κατόπιν παραγγελίας",
      "click_url": "https://www.skroutz.gr/products/show/25843947?client_id=XIbz2_n2p94JTskRpHu9wQ%3D%3D&from=api",
      "shop_uid": "237",
      "expenses": null,
      "web_uri": "http://skroutz.gr:3000/products/show/25843947",
      "sizes": [

      ],
      "blp": {
        "shipping_cost": 0.0,
        "payment_method_cost": 3.8,
        "final_price": 413.8
      },
      "price": 410.0,
      "immediate_pickup": false
    },
    {
      "id": 23995042,
      "name": "Apple iPhone 5s 16GB Space Gray (ME432GB/A)",
      "sku_id": 3783654,
      "shop_id": 3077,
      "category_id": 40,
      "availability": "Παράδοση 1 έως 3 ημέρες",
      "click_url": "https://www.skroutz.gr/products/show/23995042?client_id=XIbz2_n2p94JTskRpHu9wQ%3D%3D&from=api",
      "shop_uid": "4052",
      "expenses": null,
      "web_uri": "http://skroutz.gr:3000/products/show/23995042",
      "sizes": [

      ],
      "blp": {
        "shipping_cost": 0.0,
        "payment_method_cost": null,
        "final_price": null
      },
      "price": 410.0,
      "immediate_pickup": false
    },
    {
      "id": 28666504,
      "name": "Apple iPhone 5s 16GB | Silver (ME433GB/A)",
      "sku_id": 3783654,
      "shop_id": 3077,
      "category_id": 40,
      "availability": "Κατόπιν παραγγελίας",
      "click_url": "https://www.skroutz.gr/products/show/28666504?client_id=XIbz2_n2p94JTskRpHu9wQ%3D%3D&from=api",
      "shop_uid": "4880",
      "expenses": null,
      "web_uri": "http://skroutz.gr:3000/products/show/28666504",
      "sizes": [

      ],
      "blp": {
        "shipping_cost": 0.0,
        "payment_method_cost": null,
        "final_price": null
      },
      "price": 410.0,
      "immediate_pickup": false
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 10,
      "total_pages": 1,
      "page": 1,
      "per": 25
    },
    "ordered_by": "net_price",
    "personalization": {
      "location": {
        "address_id": 25522,
        "label": "Αλέκου Παναγούλη 91, Νέα Ιωνία",
        "lat": "38.043322",
        "lng": "23.760006",
        "type": "address",
        "country_code": "GR"
      },
      "payment_method": {
        "type": "spot_cash"
      }
    }
  }
}

Retrieve an SKU's products grouped in cards

GET /skus/:id/product_cards

GET https://api.skroutz.gr/skus/3783654/product_cards

View Response

Show Headers

Status: 200

Accept-Ranges: bytes
Access-Control-Allow-Methods: HEAD, GET, POST, PUT, DELETE
Access-Control-Allow-Origin: *
Age: 0
Cache-Control: max-age=300, private
Connection: close
Content-Security-Policy-Report-Only: default-src https: data: gsa: wss://ws.inspectlet.com; script-src https: data: asset: about: 'unsafe-inline' 'unsafe-eval'; style-src https: 'unsafe-inline'; child-src *; report-uri https://f30d08e43da6ef6d7fb9c3dd5486561c.report-uri.io/r/default/csp/reportOnly
Content-Type: application/json; charset=utf-8
Date: Fri, 11 May 2018 13:37:00 GMT
Etag: W/"732915de4fa5e8c04268a76f9929327a"
Server: h2o (Debian)
Strict-Transport-Security: max-age=15768000;
Transfer-Encoding: chunked
Vary: Accept-Encoding
Via: 1.1 varnish (Varnish/5.0)
X-App: rontok_ssl
X-Cache: MISS
X-Cached: skroutz miss(0)
X-Dns-Prefetch-Control: off
X-Origin: lb1
X-Ratelimit-Limit: 100
X-Ratelimit-Remaining: 99
X-Ratelimit-Reset: 1526045880
X-Request-Id: 512839625
X-Runtime: 0.105341
X-Varnish: 512839624

{
  "product_cards": [
    {
      "cards": [
        {
          "products": [
            {
              "id": 13888148,
              "name": "ΚΙΝΗΤΟ APPLE IPHONE 5S 16GB SILVER GR",
              "sku_id": 3783654,
              "shop_id": 670,
              "category_id": 40,
              "availability": "Παράδοση 1 έως 3 ημέρες",
              "click_url": "https://www.skroutz.gr/products/show/13888148?client_id=8oZYTomOpA73fxIrDfkTzg%3D%3D&from=api",
              "shop_uid": "220004685",
              "expenses": null,
              "web_uri": "https://www.skroutz.gr/products/show/13888148",
              "sizes": [

              ],
              "color": "SILVER",
              "price": 239.56,
              "immediate_pickup": false
            }
          ],
          "shop": {
            "id": 670,
            "name": "PC1",
            "link": "http://www.pc1.gr",
            "phone": "2106085000",
            "image_url": "https://d.scdn.gr/ds/shops/logos/670/mid_2e30d3bc-6a9c-488c-8d6f-01d34d02f74a.jpg",
            "thumbshot_url": "https://b.scdn.gr/ds/shops/screenshots/670/20180315140243_5ef012b0.jpeg",
            "reviews_count": 445,
            "latest_reviews_count": 79,
            "review_score": 3.8,
            "payment_methods": {
              "credit_card": true,
              "paypal": false,
              "bank": true,
              "spot_cash": true
            },
            "shipping": {
              "free": true,
              "free_from": 120,
              "free_from_info": "",
              "min_price": "3",
              "shipping_cost_enabled": false
            },
            "web_uri": "https://skroutz.gr/m/670/PC1",
            "extra_info": {
              "time_on_platform": "3+ χρόνια",
              "orders_per_week": "100+"
            },
            "top_positive_reasons": [

            ]
          },
          "blp": {
            "shipping_cost": 0.0,
            "payment_method_cost": 0.0,
            "final_price": 239.56
          }
        }
      ]
    },
    {
      "cards": [
        {
          "products": [
            {
              "id": 27290469,
              "name": "Apple iPhone 5S 16GB Gold",
              "sku_id": 3783654,
              "shop_id": 4057,
              "category_id": 40,
              "availability": "Άμεση παραλαβή / Παράδοση 1 έως 3 ημέρες",
              "click_url": "https://www.skroutz.gr/products/show/27290469?client_id=8oZYTomOpA73fxIrDfkTzg%3D%3D&from=api",
              "shop_uid": "103",
              "expenses": null,
              "web_uri": "https://www.skroutz.gr/products/show/27290469",
              "sizes": [

              ],
              "color": "Gold",
              "price": 259.0,
              "immediate_pickup": true
            }
          ],
          "shop": {
            "id": 4057,
            "name": "Metrostore",
            "link": "http://www.metrostore.gr",
            "phone": "2461025525",
            "image_url": "https://a.scdn.gr/ds/shops/logos/4057/mid_20161223160227_c4360d87.jpeg",
            "thumbshot_url": "https://d.scdn.gr/ds/shops/screenshots/4057/20170116114002_5d2c95a5.jpeg",
            "reviews_count": 82,
            "latest_reviews_count": 74,
            "review_score": 4.8,
            "payment_methods": {
              "credit_card": true,
              "paypal": false,
              "bank": true,
              "spot_cash": true
            },
            "shipping": {
              "free": false,
              "free_from": null,
              "free_from_info": null,
              "min_price": "4",
              "shipping_cost_enabled": false
            },
            "web_uri": "https://skroutz.gr/m/4057/Metrostore",
            "extra_info": {
              "time_on_platform": "1 χρόνο",
              "orders_per_week": "50+"
            },
            "top_positive_reasons": [
              "Ενημέρωση για την εξέλιξη της παραγγελίας",
              "Έγκαιρη παράδοση",
              "Φιλική εξυπηρέτηση"
            ]
          },
          "blp": {
            "shipping_cost": 4.0,
            "payment_method_cost": 4.0,
            "final_price": 267.0
          }
        }
      ]
    }
  ],
  "meta": {
    "ordered_by": "net_price",
    "pagination": {
      "total_results": 2,
      "total_pages": 1,
      "page": 1,
      "per": 15
    },
    "personalization": {
      "location": {
        "address_id": null,
        "label": "Πλ. Συντάγματος 210, Αθήνα 105 63, Ελλάδα",
        "lat": "37.9760813",
        "lng": "23.7339751",
        "type": "quick_address",
        "country_code": "GR"
      },
      "payment_method": {
        "type": "spot_cash"
      }
    }
  }
}

Ordering

Name	Type	Description
`order_by`	String	`net_price` (default) or `final_price` (includes shipping & payment_method cost).

Filtering

You may supply the optional parameter include_meta[]=filters to get meta information about the filters that can be applied.

{
  "filters": {
      "distance_ranges": {
          "2": "2km",
          "5": "5km",
          "10": "10km"
      },
      "availability_wordings": {
          "0": "Άμεση Παραλαβή",
          "1": "1-3 μέρες",
          "2": "Όλα"
      },
      "size_filter": [
          "36",
          "37",
          "38",
          "39",
          "40",
          "41",
          "42",
          "43",
          "44",
          "45",
          "46",
          "47",
          "48",
          "49",
          "50"
      ],
      "zero_commission_installments": true
  }
}

Applying filters

Name	Type	Description
`size`	String	ex: `40` Sizes of 40 up to (but not including) 41 will be returned
`distance`	String	ex: `2` Only products within 2km's will be returned
`availability`	String	ex: `0` Only products with immediate availability will be returned
`zero_installments`	Boolean	ex: `true` Only products with zero commission installments will be returned

Show Personalization info

GET /personalization

GET https://api.skroutz.gr/personalization

View Response

Show Headers

Status: 200

Access-Control-Allow-Origin: *
Access-Control-Request-Method: *
Cache-Control: max-age=0, private, must-revalidate
Connection: close
Content-Length: 228
Content-Type: application/json; charset=utf-8
Date: Fri, 26 Jan 2018 16:37:47 GMT
Etag: W/"405a125772773abf2f92b1a19f626b42"
Server: WEBrick/1.3.1 (Ruby/2.3.3/2016-11-21)
Set-Cookie: locale=el_GR; path=/
X-Request-Id: 09c1748c-5adf-42c5-ab12-6ccd24843fe6
X-Runtime: 0.052830

{
  "personalization": {
    "location": {
      "address_id": 25522,
      "label": "Αλέκου Παναγούλη 91, Νέα Ιωνία",
      "lat": "38.043322",
      "lng": "23.760006",
      "type": "address",
      "country_code": "GR"
    },
    "payment_method": {
      "type": "spot_cash"
    }
  }
}

Show the address that is used to calculate shipping & payment_method costs.

Update Personalization info

PUT /personalization

PUT https://api.skroutz.gr/personalization

View Response Params

{
  "personalization": {
    "location": {
      "address_id": 38572
    }
  }
}

Show Headers

Status: 200

Access-Control-Allow-Origin: *
Access-Control-Request-Method: *
Cache-Control: max-age=0, private, must-revalidate
Connection: close
Content-Length: 181
Content-Type: application/json; charset=utf-8
Date: Wed, 31 Jan 2018 16:17:49 GMT
Etag: W/"02f2bd5f078b8eed80fce5b2ea7ae1f1"
Server: WEBrick/1.3.1 (Ruby/2.3.3/2016-11-21)
Set-Cookie: locale=el_GR; path=/
X-Request-Id: 1268bd45-4701-4ffa-b2ef-503feee64681
X-Runtime: 0.107233

{
  "personalization": {
    "location": {
      "address_id": 38572,
      "label": "grafio",
      "lat": "38.043322",
      "lng": "23.760006",
      "type": "address",
      "country_code": "GR"
    },
    "payment_method": {
      "type": "spot_cash"
    }
  }
}

Select a different User Address.

Search for products

  GET /shops/:shop_id/products/search?shop_uid=value

Name	Type	Description
`shop_uid`	Integer	Search with the product identifier as assigned by the shop

GET https://api.skroutz.gr/shops/452/products/search?shop_uid=062276

View Response

Show Headers

Status: 200

Accept-Ranges: bytes
Access-Control-Allow-Methods: HEAD, GET, POST, PUT, DELETE
Access-Control-Allow-Origin: *
Age: 0
Cache-Control: max-age=0, private, must-revalidate
Connection: close
Content-Type: application/json; charset=utf-8
Date: Wed, 15 Feb 2017 17:20:45 GMT
Etag: W/"6c0defcaeb9b8f516860b33ce53e9996"
Server: nginx
Transfer-Encoding: chunked
Vary: Accept-Encoding
Via: 1.1 varnish-v4
X-App: rontok
X-Cache: MISS
X-Cached: skroutz miss(0)
X-Content-Type-Options: nosniff
X-Dns-Prefetch-Control: off
X-Frame-Options: SAMEORIGIN
X-Origin: lb1
X-Ratelimit-Limit: 100
X-Ratelimit-Remaining: 98
X-Ratelimit-Reset: 1487179260
X-Request-Id: 73118612
X-Runtime: 0.021276
X-Varnish: 73118611
X-Xss-Protection: 1; mode=block

{
  "products": [
    {
      "id": 2542077,
      "name": "Verbatim DVD+R 25PK Spindle 16x",
      "sku_id": 4843381,
      "shop_id": 452,
      "category_id": 472,
      "availability": "Άμεση παραλαβή / Παράδοση 1 έως 3 ημέρες",
      "click_url": "https://www.skroutz.gr/products/show/2542077?client_id=NsgROlpU9757wHtXZPmbzA%3D%3D&from=api",
      "shop_uid": "062276",
      "expenses": null,
      "web_uri": "https://www.skroutz.gr/products/show/2542077",
      "sizes": [

      ],
      "price": 8.99,
      "immediate_pickup": true
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 1,
      "total_pages": 1,
      "page": 1,
      "per": 25
    }
  }
}

Search

Developer Documentation

Looking for something else?

Product Edit the file on GitHub

Table of Contents

Retrieve a single product

Retrieve an SKU's products

Retrieve an SKU's products grouped in cards

Ordering

Filtering

Applying filters

Show Personalization info

Update Personalization info

Search for products