Alve API Access Application no longer accepts requests.

Shop Edit the file on GitHub

Table of Contents

Retrieve a single shop

  GET /shops/:id

GET https://api.alve.com/shops/42

View Response
Show Headers
Status: 200
{
  "shop": {
    "id": 42,
    "name": "İstanbul Bilişim",
    "link": "http://www.istanbulbilisim.com.tr/",
    "phone": "08503330912",
    "image_url": "https://alve-a.scdn.gr/ds/shops/logos/42/mid_a5c34f50-e5ff-4389-8b33-afda9cb774b6.jpg",
    "thumbshot_url": "https://alve-b.scdn.gr/ds/shops/screenshots/42/0d9cc7c7-9e72-416a-93b3-163f9931af46.png",
    "reviews_count": 2,
    "latest_reviews_count": 2,
    "review_score": 5.0,
    "payment_methods": {
      "credit_card": true,
      "paypal": false,
      "bank": true,
      "spot_cash": false,
      "installments": "",
      "bkm": true,
      "ipara": false
    },
    "shipping": {
      "free": false,
      "free_from": null,
      "free_from_info": null,
      "min_price": "4.17",
      "shipping_cost_enabled": true
    },
    "web_uri": "https://www.alve.com/m/42/%C4%B0stanbul-Bili%C5%9Fim",
    "extra_info": {
      "time_on_platform": "3+ yıl",
      "orders_per_week": null
    },
    "top_positive_reasons": [
      "Zamanında teslim"
    ]
  }
}

Retrieve a shop's reviews

Linked resources

  GET /shops/:id/reviews

GET https://api.alve.com/shops/42/reviews

View Response Params
{
  "per": 3
}
Show Headers
Status: 200
{
  "reviews": [
    {
      "id": 79,
      "user_id": 9138,
      "review": "Hem uygun fiyat hem de hızlı kargo. Ürünü siparişimden bir gün sonra teslim ettiler, çok memnun kaldım.",
      "rating": 5.0,
      "shop_reply": null,
      "created_at": "2016-10-13T15:35:39+03:00",
      "negative": false,
      "reasons": [
        "Zamanında teslim"
      ]
    },
    {
      "id": 77,
      "user_id": 1437,
      "review": "Saat siparişi verdim , 1 gün sonra elime geçti.Gerçekten çok hızlı bir kargo süreci oldu.Ayrıca en uygun fiyata da satın alma şansım oldu.Fatura ile birlikte ürün sorunsuz elime ulaştı.Tekrar sipariş verirsem bu mağaza aklımda olucak.",
      "rating": 5.0,
      "shop_reply": null,
      "created_at": "2016-10-11T14:42:39+03:00",
      "negative": false,
      "reasons": [
        "Sipariş takibi",
        "Zamanında teslim",
        "Genel değerlendirme"
      ]
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 2,
      "total_pages": 1,
      "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 https://api.alve.com/shops/138/reviews?include_meta=shop_rating_breakdown

View Response Params
{
  "per": 3
}
Show Headers
Status: 200
{
  "reviews": [
    {
      "id": 70,
      "user_id": 16,
      "review": "internet üzerinden aldığım fotoğraf makinesi çantası 1 gün sonra elime ulaştı.Kargo hızlı ve paketleme de başarılı idi.Zaten bir çok mağazası bulunan bir yer.Bazı ürünler bazen ucuza bulunabiliyor , tavsiye edebileceğim bir mağaza.",
      "rating": 5.0,
      "shop_reply": null,
      "created_at": "2016-07-19T14:08:07+03:00",
      "negative": false,
      "reasons": [
        "order_status_present",
        "ontime",
        "good_packaging"
      ]
    },
    {
      "id": 50,
      "user_id": 7976,
      "review": "Mediamarkt'den blender satın aldım. Güzel bir şekilde ürün teslim edildi. Herhangi bir sıkıntı yaşamadım.",
      "rating": 4,
      "shop_reply": null,
      "created_at": "2015-09-04T14:39:16+03:00",
      "negative": false,
      "reasons": [

      ]
    },
    {
      "id": 23,
      "user_id": 2335,
      "review": "23 Aralıkta monitör siparişi verdim. Ürün kısa süre içerisinde kargolanıp,  eksiksiz ve sorunsuz bir şekilde tarafıma ulaştı. Tavsiye ederim, güvenli bir şekilde alışverişlerinizi yapabilirsiniz.",
      "rating": 5,
      "shop_reply": null,
      "created_at": "2014-12-26T12:31:43+02:00",
      "negative": false,
      "reasons": [

      ]
    }
  ],
  "meta": {
    "shop_rating_breakdown": [
      {
        "impression": "positive",
        "percentage": 100,
        "count": 1
      },
      {
        "impression": "negative",
        "percentage": 0,
        "count": 0
      }
    ],
    "pagination": {
      "total_results": 3,
      "total_pages": 1,
      "page": 1,
      "per": 3
    }
  }
}

List shop locations

Linked resources

  GET /shops/:shop_id/locations

GET https://api.alve.com/shops/42/locations

View Response Params
{
  "per": 2
}
Show Headers
Status: 200
{
  "locations": [
    {
      "id": 211,
      "headquarter": true,
      "phones": [
        "08503330912"
      ],
      "pickup_point": true,
      "store": true,
      "full_address": "Darülaceze 2, P.Κ. 34381, Şişli, İstanbul",
      "format": "unstructured",
      "lat": "41.06224",
      "lng": "28.968421",
      "info": "Merkez Mah. Darülaceze Cad. Anıttepe Sit. Nadide Sok. No:2 Çağlayan - Şişli / İstanbul"
    },
    {
      "id": 250,
      "headquarter": false,
      "phones": [
        "08503330912"
      ],
      "pickup_point": true,
      "store": true,
      "full_address": "Londra Asfaltı 11, P.Κ. 34158, Bakırköy, Ataköy, İstanbul",
      "format": "unstructured",
      "lat": "40.991691",
      "lng": "28.829927",
      "info": "Londra Asfaltı Kuleli Mevkii E-5 Karayolu Üzeri AirportAvm Kat -1 NO:11 Bakırköy / İstanbul"
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 2,
      "total_pages": 1,
      "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 https://api.alve.com/shops/42/locations?embed=address

View Response Params
{
  "per": 2
}
Show Headers
Status: 200
{
  "locations": [
    {
      "id": 211,
      "headquarter": true,
      "phones": [
        "08503330912"
      ],
      "pickup_point": true,
      "store": true,
      "full_address": "Darülaceze 2, P.Κ. 34381, Şişli, İstanbul",
      "format": "unstructured",
      "lat": "41.06224",
      "lng": "28.968421",
      "info": "Merkez Mah. Darülaceze Cad. Anıttepe Sit. Nadide Sok. No:2 Çağlayan - Şişli / İstanbul",
      "address": {
        "id": 211,
        "street_number": null,
        "street": null,
        "postcode": null,
        "city": null,
        "region": null,
        "country": null
      }
    },
    {
      "id": 250,
      "headquarter": false,
      "phones": [
        "08503330912"
      ],
      "pickup_point": true,
      "store": true,
      "full_address": "Londra Asfaltı 11, P.Κ. 34158, Bakırköy, Ataköy, İstanbul",
      "format": "unstructured",
      "lat": "40.991691",
      "lng": "28.829927",
      "info": "Londra Asfaltı Kuleli Mevkii E-5 Karayolu Üzeri AirportAvm Kat -1 NO:11 Bakırköy / İstanbul",
      "address": {
        "id": 250,
        "street_number": null,
        "street": null,
        "postcode": null,
        "city": null,
        "region": null,
        "country": null
      }
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 2,
      "total_pages": 1,
      "page": 1,
      "per": 2
    }
  }
}

Retrieve a single shop location

Linked resources

  GET /shops/:shop_id/locations/:id

GET https://api.alve.com/shops/42/locations/250

View Response
Show Headers
Status: 200
{
  "location": {
    "id": 250,
    "headquarter": false,
    "phones": [
      "08503330912"
    ],
    "pickup_point": true,
    "store": true,
    "full_address": "Londra Asfaltı 11, P.Κ. 34158, Bakırköy, Ataköy, İstanbul",
    "format": "unstructured",
    "lat": "40.991691",
    "lng": "28.829927",
    "info": "Londra Asfaltı Kuleli Mevkii E-5 Karayolu Üzeri AirportAvm Kat -1 NO:11 Bakırköy / İstanbul"
  }
}

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 https://api.alve.com/shops/42/locations/250?embed=address

View Response
Show Headers
Status: 200
{
  "location": {
    "id": 250,
    "headquarter": false,
    "phones": [
      "08503330912"
    ],
    "pickup_point": true,
    "store": true,
    "full_address": "Londra Asfaltı 11, P.Κ. 34158, Bakırköy, Ataköy, İstanbul",
    "format": "unstructured",
    "lat": "40.991691",
    "lng": "28.829927",
    "info": "Londra Asfaltı Kuleli Mevkii E-5 Karayolu Üzeri AirportAvm Kat -1 NO:11 Bakırköy / İstanbul",
    "address": {
      "id": 250,
      "street_number": null,
      "street": null,
      "postcode": null,
      "city": null,
      "region": null,
      "country": null
    }
  }
}

Search for shops

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

GET https://api.alve.com/shops/search?q=%C4%B0stanbul

View Response
Show Headers
Status: 200
{
  "shops": [
    {
      "id": 42,
      "name": "İstanbul Bilişim",
      "link": "http://www.istanbulbilisim.com.tr/",
      "phone": "08503330912",
      "image_url": "https://alve-a.scdn.gr/ds/shops/logos/42/mid_a5c34f50-e5ff-4389-8b33-afda9cb774b6.jpg",
      "thumbshot_url": "https://alve-b.scdn.gr/ds/shops/screenshots/42/0d9cc7c7-9e72-416a-93b3-163f9931af46.png",
      "reviews_count": 0,
      "latest_reviews_count": 0,
      "review_score": 0.0,
      "payment_methods": {
        "credit_card": true,
        "paypal": false,
        "bank": true,
        "spot_cash": false,
        "installments": "",
        "bkm": true,
        "ipara": false
      },
      "shipping": {
        "free": false,
        "free_from": null,
        "free_from_info": null,
        "min_price": "4.17"
      },
      "web_uri": "https://www.alve.com/m/42/%C4%B0stanbul-Bili%C5%9Fim",
      "extra_info": {
        "time_on_platform": "3+ yıl",
        "orders_per_week": "10+"
      },
      "top_positive_reasons": [

      ]
    },
    {
      "id": 676,
      "name": "Uğur İstanbul",
      "link": "http://www.uguristanbul.com/",
      "phone": "02163792905",
      "image_url": "https://alve-a.scdn.gr/ds/shops/logos/676/mid_20160407170242_7e46a560.png",
      "thumbshot_url": "https://alve-b.scdn.gr/ds/shops/screenshots/676/20160407165024_a98c787e.png",
      "reviews_count": 0,
      "latest_reviews_count": 0,
      "review_score": 0.0,
      "payment_methods": {
        "credit_card": true,
        "paypal": false,
        "bank": true,
        "spot_cash": false,
        "installments": "",
        "bkm": false,
        "ipara": true
      },
      "shipping": {
        "free": false,
        "free_from": null,
        "free_from_info": null,
        "min_price": ""
      },
      "web_uri": "https://www.alve.com/m/676/U%C4%9Fur-%C4%B0stanbul",
      "extra_info": {
        "time_on_platform": "6 ay",
        "orders_per_week": null
      },
      "top_positive_reasons": [

      ]
    }
  ],
  "meta": {
    "pagination": {
      "total_results": 2,
      "total_pages": 1,
      "page": 1,
      "per": 25
    }
  }
}