BlipADeal API (v1.1) - Technical Documentation
Please note you will be need a unique token and secret key in order to connect with our API. This can be found here or by clicking on the "Request API" from the menu above.

Sample Code
  • Python Example - view code
  • Javascript Example - view code or see running sample here. Note that javascript examples use JSONP invocation.


Available API Function Calls
  • /api_get_deal_location_near_by_text
    • This function allows the developer to input a city and country name along with radius distance and retrieve cities around the specified location where deals are available
  • /api_get_deal_location_near_by_geo
    • This function allows the developer to input a point as lng & lat coordinates along with radius distance and retrieve cities around the specified points where deals are available.
  • /api_get_category_type
    • This function will provide a suggested category given some free text. As an example you can provide a users preference based on some free text or an uncategorized deal represented as free text and get a suggested category
  • /api_get_category_deals
    • This function will retrieve all the deals based on the country, the city and the category. To use this function you can initially retrieve a category from the /api_get_category_type call or you can use one of the categories returned from the /api_get_category call
  • /api_get_deals
    • This function will retrieve all the deals based on the country and the city. To see which countries and cities are available you can call the /api_get_country and /api_get_location functions respectively
  • /api_get_country
    • This function will retrieve all the countries available within BlipADeal. The countries returned can then be used as a way to reference BlipADeals locational data
  • /api_get_location
    • This function will retrieve all the cities given a country that is available within BlipADeal. If you want to find out which cities contain deals given a country this function will provide the required information
  • /api_get_category
    • This function will retrieve all the categories given a country and a city. To see which countries and cities are available you can call the /api_get_country and /api_get_location functions respectively
  • /api_keyword_search
    • This function will retrieve all the deals given a country, city and keywords to match. To see which countries and cities are available you can call the /api_get_country and /api_get_location functions respectively