Skroutz API Access Application no longer accepts requests.

Product Edit the file on GitHub

Table of Contents

Retrieve a single product

  GET /products/:id

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

View Response
Show Headers
Status: 200
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
{
  "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
    }
  }
}