Alve API Access Application no longer accepts requests.

Category Edit the file on GitHub

Categories are organized in a tree-like structure.

An SKU always belongs to a leaf (ending) category.

Leaf categories have children_count equal to 0.

Table of Contents

List all categories

  GET /categories

GET https://api.alve.com/categories

View Response
Description: Lists all categories
Params
{
  "page": 1,
  "per": 5
}
Show Headers
Status: 200
{
  "categories": [
    {
      "id": 1,
      "name": "Alve",
      "children_count": 7,
      "image_url": "https://alve-d.scdn.gr/ds/categories/1/1.jpg",
      "parent_id": 0,
      "fashion": false,
      "layout_mode": "list",
      "web_uri": "https://www.alve.com/c/1/root.html",
      "code": "root",
      "path": "1",
      "show_specifications": false,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 2,
      "name": "Τeknoloji",
      "children_count": 8,
      "image_url": "https://alve-c.scdn.gr/ds/categories/2/2.jpg",
      "parent_id": 1,
      "fashion": false,
      "layout_mode": "list",
      "web_uri": "https://www.alve.com/c/2/teknoloji.html",
      "code": "technology",
      "path": "1,2",
      "show_specifications": false,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 3,
      "name": "Moda",
      "children_count": 7,
      "image_url": "https://alve-c.scdn.gr/ds/categories/3/20160328125843_4941742a.jpg",
      "parent_id": 1,
      "fashion": false,
      "layout_mode": "list",
      "web_uri": "https://www.alve.com/c/3/moda.html",
      "code": "fashion",
      "path": "1,3",
      "show_specifications": false,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 4,
      "name": "Çocuk - Bebek",
      "children_count": 7,
      "image_url": "https://alve-a.scdn.gr/ds/categories/4/4.jpg",
      "parent_id": 1,
      "fashion": false,
      "layout_mode": "list",
      "web_uri": "https://www.alve.com/c/4/cocuk-bebek.html",
      "code": "baby-kids",
      "path": "1,4",
      "show_specifications": false,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 5,
      "name": "Hobi - Spor",
      "children_count": 8,
      "image_url": "https://alve-a.scdn.gr/ds/categories/5/5.jpg",
      "parent_id": 1,
      "fashion": false,
      "layout_mode": "list",
      "web_uri": "https://www.alve.com/c/5/hobi-spor.html",
      "code": "hobbies-sports",
      "path": "1,5",
      "show_specifications": false,
      "manufacturer_title": "Markalar"
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 932,
      "total_pages": 187,
      "page": 1,
      "per": 5
    }
  }
}

Retrieve a single category

  GET /categories/:id

GET https://api.alve.com/categories/33

View Response
Show Headers
Status: 200
{
  "category": {
    "id": 33,
    "name": "Cep Telefonu",
    "children_count": 0,
    "image_url": "https://alve-b.scdn.gr/ds/categories/33/20150622142746_9efad8e8.jpg",
    "parent_id": 32,
    "fashion": false,
    "layout_mode": "list",
    "web_uri": "https://www.alve.com/c/33/cep-telefonu.html",
    "code": "mobile",
    "path": "1,2,12,32,33",
    "show_specifications": true,
    "manufacturer_title": "Markalar"
  }
}

Retrieve the parent of a category

  GET /categories/:id/parent

GET https://api.alve.com/categories/33/parent

View Response
Show Headers
Status: 200
{
  "category": {
    "id": 32,
    "name": "Cep Telefonu Dünyası",
    "children_count": 10,
    "image_url": "https://alve-a.scdn.gr/ds/categories/32/32.jpg",
    "parent_id": 12,
    "fashion": false,
    "layout_mode": "list",
    "web_uri": "https://www.alve.com/c/32/cep-telefonu-dunyasi.html",
    "code": "cep-telefonu-dunyasi",
    "path": "1,2,12,32",
    "show_specifications": false,
    "manufacturer_title": "Markalar"
  }
}

Retrieve the root category

  GET /categories/root

GET https://api.alve.com/categories/root

View Response
Show Headers
Status: 200
{
  "category": {
    "id": 1,
    "name": "Alve",
    "children_count": 7,
    "image_url": "https://alve-d.scdn.gr/ds/categories/1/1.jpg",
    "parent_id": 0,
    "fashion": false,
    "layout_mode": "list",
    "web_uri": "https://www.alve.com/c/1/root.html",
    "code": "root",
    "path": "1",
    "show_specifications": false,
    "manufacturer_title": "Markalar"
  }
}

List the children categories of a category

  GET /categories/:id/children

GET https://api.alve.com/categories/32/children

View Response
Show Headers
Status: 200
{
  "categories": [
    {
      "id": 33,
      "name": "Cep Telefonu",
      "children_count": 0,
      "image_url": "https://alve-b.scdn.gr/ds/categories/33/20150622142746_9efad8e8.jpg",
      "parent_id": 32,
      "fashion": false,
      "layout_mode": "list",
      "web_uri": "https://www.alve.com/c/33/cep-telefonu.html",
      "code": "mobile",
      "path": "1,2,12,32,33",
      "show_specifications": true,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 34,
      "name": "Cep Telefonu Kılıfı",
      "children_count": 0,
      "image_url": "https://alve-d.scdn.gr/ds/categories/34/34.jpg",
      "parent_id": 32,
      "fashion": false,
      "layout_mode": "tiles",
      "web_uri": "https://www.alve.com/c/34/cep-telefonu-kilifi.html",
      "code": "cep-telefonu-kiliflari",
      "path": "1,2,12,32,34",
      "show_specifications": false,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 647,
      "name": "Akıllı Saat",
      "children_count": 0,
      "image_url": "https://alve-d.scdn.gr/ds/categories/647/20150126145642_1705.jpg",
      "parent_id": 32,
      "fashion": false,
      "layout_mode": "tiles",
      "web_uri": "https://www.alve.com/c/647/akilli-saat.html",
      "code": "akilli_saat",
      "path": "1,2,12,32,647",
      "show_specifications": true,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 673,
      "name": "Powerbank",
      "children_count": 0,
      "image_url": "https://alve-c.scdn.gr/ds/categories/673/20150422120134_4664c94c.jpg",
      "parent_id": 32,
      "fashion": false,
      "layout_mode": "tiles",
      "web_uri": "https://www.alve.com/c/673/powerbank.html",
      "code": "powerbank",
      "path": "1,2,12,32,673",
      "show_specifications": true,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 545,
      "name": "Ekran Koruyucu Film",
      "children_count": 0,
      "image_url": "https://alve-c.scdn.gr/ds/categories/545/545.jpg",
      "parent_id": 32,
      "fashion": false,
      "layout_mode": "tiles",
      "web_uri": "https://www.alve.com/c/545/ekran-koruyucu-film.html",
      "code": "ekran_koruyuculari",
      "path": "1,2,12,32,545",
      "show_specifications": false,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 548,
      "name": "Cep Telefonu Bataryası",
      "children_count": 0,
      "image_url": "https://alve-a.scdn.gr/ds/categories/548/548.jpg",
      "parent_id": 32,
      "fashion": false,
      "layout_mode": "tiles",
      "web_uri": "https://www.alve.com/c/548/cep-telefonu-bataryasi.html",
      "code": "cep_telefonu_pilleri",
      "path": "1,2,12,32,548",
      "show_specifications": false,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 546,
      "name": "Cep Telefonu Şarj Aleti",
      "children_count": 0,
      "image_url": "https://alve-d.scdn.gr/ds/categories/546/546.jpg",
      "parent_id": 32,
      "fashion": false,
      "layout_mode": "tiles",
      "web_uri": "https://www.alve.com/c/546/cep-telefonu-sarj-aleti.html",
      "code": "cep_telefon_sarjlari",
      "path": "1,2,12,32,546",
      "show_specifications": false,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 738,
      "name": "Selfie Çubuğu",
      "children_count": 0,
      "image_url": "https://alve-d.scdn.gr/ds/categories/738/20150904134717_d945d77e.jpg",
      "parent_id": 32,
      "fashion": true,
      "layout_mode": "wide_tiles",
      "web_uri": "https://www.alve.com/c/738/selfie-cubugu.html",
      "code": "selfie-cubugu",
      "path": "1,2,12,32,738",
      "show_specifications": false,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 35,
      "name": "Bluetooth Kulaklık",
      "children_count": 0,
      "image_url": "https://alve-b.scdn.gr/ds/categories/35/35.jpg",
      "parent_id": 32,
      "fashion": false,
      "layout_mode": "tiles",
      "web_uri": "https://www.alve.com/c/35/bluetooth-kulaklik.html",
      "code": "bluetooth",
      "path": "1,2,12,32,35",
      "show_specifications": true,
      "manufacturer_title": "Markalar"
    },
    {
      "id": 969,
      "name": "Sanal Gerçeklik Gözlüğü",
      "children_count": 0,
      "image_url": "https://alve-c.scdn.gr/ds/categories/969/20160815150555_370ad9a7.jpeg",
      "parent_id": 32,
      "fashion": false,
      "layout_mode": "tiles",
      "web_uri": "https://www.alve.com/c/969/sanal-gerceklik-gozlugu.html",
      "code": "vr_glasses",
      "path": "1,2,12,32,969",
      "show_specifications": false,
      "manufacturer_title": "Markalar"
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 10,
      "total_pages": 1,
      "page": 1,
      "per": 25
    }
  }
}

List a category's specifications

  GET /categories/:id/specifications

GET https://api.alve.com/categories/33/specifications

View Response
Show Headers
Status: 200
{
  "specifications": [
    {
      "id": 154,
      "name": "Tip",
      "values": [

      ],
      "order": 10,
      "unit": ""
    },
    {
      "id": 169,
      "name": "SIM Tipi",
      "values": [

      ],
      "order": 15,
      "unit": ""
    },
    {
      "id": 153,
      "name": "Çıkış Tarihi",
      "values": [

      ],
      "order": 20,
      "unit": ""
    },
    {
      "id": 156,
      "name": "Ekran Boyutu",
      "values": [

      ],
      "order": 10,
      "unit": "inç"
    },
    {
      "id": 157,
      "name": "Ekran Çözünürlüğü",
      "values": [

      ],
      "order": 20,
      "unit": "piksel"
    },
    {
      "id": 155,
      "name": "Ekran Türü",
      "values": [

      ],
      "order": 30,
      "unit": ""
    },
    {
      "id": 158,
      "name": "Kullanım Yöntemi",
      "values": [

      ],
      "order": 40,
      "unit": ""
    },
    {
      "id": 161,
      "name": "İşlemci Gücü",
      "values": [

      ],
      "order": 50,
      "unit": "MHz"
    },
    {
      "id": 162,
      "name": "İşlemci Çekirdeği",
      "values": [

      ],
      "order": 60,
      "unit": ""
    },
    {
      "id": 497,
      "name": "Dahili RAM",
      "values": [

      ],
      "order": 70,
      "unit": "MB"
    },
    {
      "id": 166,
      "name": "Dahili Hafıza",
      "values": [

      ],
      "order": 80,
      "unit": "GB"
    },
    {
      "id": 168,
      "name": "Kart Yuvası",
      "values": [

      ],
      "order": 90,
      "unit": ""
    },
    {
      "id": 159,
      "name": "Fotoğraf Makinesi",
      "values": [

      ],
      "order": 100,
      "unit": "MP"
    },
    {
      "id": 930,
      "name": "Selfie Kamerası",
      "values": [

      ],
      "order": 105,
      "unit": "MP"
    },
    {
      "id": 163,
      "name": "İşletim Sistemi",
      "values": [

      ],
      "order": 120,
      "unit": ""
    },
    {
      "id": 164,
      "name": "Ağ Bağlantısı",
      "values": [

      ],
      "order": 10,
      "unit": ""
    },
    {
      "id": 176,
      "name": "SAR İndeksi",
      "values": [

      ],
      "order": 15,
      "unit": "W/kg"
    },
    {
      "id": 170,
      "name": "Wi-Fi",
      "values": [

      ],
      "order": 20,
      "unit": ""
    },
    {
      "id": 171,
      "name": "Arayüz Tipi",
      "values": [

      ],
      "order": 30,
      "unit": ""
    },
    {
      "id": 929,
      "name": "Batarya Kapasitesi",
      "values": [

      ],
      "order": 5,
      "unit": "mAh"
    },
    {
      "id": 931,
      "name": "Değiştirilebilir Batarya",
      "values": [

      ],
      "order": 7,
      "unit": ""
    },
    {
      "id": 172,
      "name": "Bekleme Süresi",
      "values": [

      ],
      "order": 10,
      "unit": "saat"
    },
    {
      "id": 173,
      "name": "Konuşma Süresi",
      "values": [

      ],
      "order": 20,
      "unit": "saat"
    },
    {
      "id": 174,
      "name": "Boyutlar",
      "values": [

      ],
      "order": 30,
      "unit": "mm"
    },
    {
      "id": 175,
      "name": "Ağırlık",
      "values": [

      ],
      "order": 40,
      "unit": "gr"
    }
  ]
}

The specification group can be included / embedded using the group value. Groups represent a logical grouping of specifications.

  GET /categories/:id/specifications?include=group

GET https://api.alve.com/categories/33/specifications?include=group

View Response
Show Headers
Status: 200
{
  "groups": [
    {
      "id": 51,
      "name": "Ana Özellikler",
      "order": 10
    },
    {
      "id": 52,
      "name": "Teknik Özellikler",
      "order": 20
    },
    {
      "id": 53,
      "name": "İşlevsellik & Bağlanabilirlik",
      "order": 30
    },
    {
      "id": 54,
      "name": "Batarya",
      "order": 40
    },
    {
      "id": 371,
      "name": "Boyut & Ağırlık",
      "order": 45
    }
  ],
  "specifications": [
    {
      "id": 154,
      "name": "Tip",
      "values": [

      ],
      "order": 10,
      "unit": "",
      "group_id": 51
    },
    {
      "id": 169,
      "name": "SIM Tipi",
      "values": [

      ],
      "order": 15,
      "unit": "",
      "group_id": 51
    },
    {
      "id": 153,
      "name": "Çıkış Tarihi",
      "values": [

      ],
      "order": 20,
      "unit": "",
      "group_id": 51
    },
    {
      "id": 156,
      "name": "Ekran Boyutu",
      "values": [

      ],
      "order": 10,
      "unit": "inç",
      "group_id": 52
    },
    {
      "id": 157,
      "name": "Ekran Çözünürlüğü",
      "values": [

      ],
      "order": 20,
      "unit": "piksel",
      "group_id": 52
    },
    {
      "id": 155,
      "name": "Ekran Türü",
      "values": [

      ],
      "order": 30,
      "unit": "",
      "group_id": 52
    },
    {
      "id": 158,
      "name": "Kullanım Yöntemi",
      "values": [

      ],
      "order": 40,
      "unit": "",
      "group_id": 52
    },
    {
      "id": 161,
      "name": "İşlemci Gücü",
      "values": [

      ],
      "order": 50,
      "unit": "MHz",
      "group_id": 52
    },
    {
      "id": 162,
      "name": "İşlemci Çekirdeği",
      "values": [

      ],
      "order": 60,
      "unit": "",
      "group_id": 52
    },
    {
      "id": 497,
      "name": "Dahili RAM",
      "values": [

      ],
      "order": 70,
      "unit": "MB",
      "group_id": 52
    },
    {
      "id": 166,
      "name": "Dahili Hafıza",
      "values": [

      ],
      "order": 80,
      "unit": "GB",
      "group_id": 52
    },
    {
      "id": 168,
      "name": "Kart Yuvası",
      "values": [

      ],
      "order": 90,
      "unit": "",
      "group_id": 52
    },
    {
      "id": 159,
      "name": "Fotoğraf Makinesi",
      "values": [

      ],
      "order": 100,
      "unit": "MP",
      "group_id": 52
    },
    {
      "id": 930,
      "name": "Selfie Kamerası",
      "values": [

      ],
      "order": 105,
      "unit": "MP",
      "group_id": 52
    },
    {
      "id": 163,
      "name": "İşletim Sistemi",
      "values": [

      ],
      "order": 120,
      "unit": "",
      "group_id": 52
    },
    {
      "id": 164,
      "name": "Ağ Bağlantısı",
      "values": [

      ],
      "order": 10,
      "unit": "",
      "group_id": 53
    },
    {
      "id": 176,
      "name": "SAR İndeksi",
      "values": [

      ],
      "order": 15,
      "unit": "W/kg",
      "group_id": 53
    },
    {
      "id": 170,
      "name": "Wi-Fi",
      "values": [

      ],
      "order": 20,
      "unit": "",
      "group_id": 53
    },
    {
      "id": 171,
      "name": "Arayüz Tipi",
      "values": [

      ],
      "order": 30,
      "unit": "",
      "group_id": 53
    },
    {
      "id": 929,
      "name": "Batarya Kapasitesi",
      "values": [

      ],
      "order": 5,
      "unit": "mAh",
      "group_id": 54
    },
    {
      "id": 931,
      "name": "Değiştirilebilir Batarya",
      "values": [

      ],
      "order": 7,
      "unit": "",
      "group_id": 54
    },
    {
      "id": 172,
      "name": "Bekleme Süresi",
      "values": [

      ],
      "order": 10,
      "unit": "saat",
      "group_id": 54
    },
    {
      "id": 173,
      "name": "Konuşma Süresi",
      "values": [

      ],
      "order": 20,
      "unit": "saat",
      "group_id": 54
    },
    {
      "id": 174,
      "name": "Boyutlar",
      "values": [

      ],
      "order": 30,
      "unit": "mm",
      "group_id": 371
    },
    {
      "id": 175,
      "name": "Ağırlık",
      "values": [

      ],
      "order": 40,
      "unit": "gr",
      "group_id": 371
    }
  ]
}

List a category's manufacturers

  GET /categories/:id/manufacturers

GET https://api.alve.com/categories/33/manufacturers

View Response Params
{
  "order_by": "popularity",
  "order_dir": "desc",
  "per": 2
}
Show Headers
Status: 200
{
  "manufacturers": [
    {
      "id": 36,
      "name": "Samsung",
      "image_url": "https://alve-d.scdn.gr/ds/manufacturers/36/samsung-logo.jpg"
    },
    {
      "id": 28,
      "name": "Apple",
      "image_url": "https://alve-a.scdn.gr/ds/manufacturers/28/20150714114455_72bd4df9.png"
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 39,
      "total_pages": 20,
      "page": 1,
      "per": 2
    }
  }
}

Ordering

Name Type Value Description
order_by String name, popularity default Order by name or popularity
order_dir String asc, desc default Order ascending or descending

List a category's favorites

Note

Requires user token with the 'favorites' permission.

  GET /categories/:id/favorites

GET https://api.alve.com/categories/33/favorites

View Response
Show Headers
Status: 200
{
  "favorites": [
    {
      "id": 6301,
      "have_it": false,
      "user_id": 9529,
      "user_notes": null,
      "sku_id": 387159,
      "created_at": "2016-04-19T16:24:05+03:00",
      "updated_at": "2016-04-19T16:24:05+03:00",
      "get_absolute_threshold": null
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 1,
      "total_pages": 1,
      "page": 1,
      "per": 25
    }
  }
}