API Deals

API Deals

Available Requests

  • GET /api/city/
    • Show a list of all launched cities.
  • GET api/deal/
    • Shows a random deal for a city
  • GET /api
    • Show a list of all deals for a city

GET /city/

Show a list of all launched cities.

URL

http://www.bestofboutiquenow.com/api/city/

Formats

JSON (default)

XML

Authentication Required

No

URL Parameters

  • client_id

    The api key that identifies your client

    Example: cee15b12a7518bdf220a92234996195db4639614

  • format

    The response type

    Example: xml

Sample JSON Request

GET http://www.bestofboutiquenow.com/api/city/?client_id=abcd1234567890

OR

GET http://www.bestofboutiquenow.com/api/city/?client_id=abcd1234567890&format=json

Sample JSON Response

{"cities":[{"city":{"cityid":"1","cityname":"Florida","cityurl":"florida","country":"USA"}}, {"city":{"cityid":"2","cityname":"Illinois","cityurl":"illinois","country":"USA"}}, {"city":{"cityid":"3","cityname":"Kansas","cityurl":"kansas","country":"USA"}},{"city":{"cityid":"4","cityname":"New Jersey","cityurl":"new-jersey","country":"USA"}}, {"city":{"cityid":"5","cityname":"New York","cityurl":"new-york","country":"USA"}}, {"city":{"cityid":"6","cityname":"California","cityurl":"california","country":"USA"}}, {"city":{"cityid":"7","cityname":"Alaska","cityurl":"alaska","country":"USA"}}, {"city":{"cityid":"8","cityname":"Michigan","cityurl":"michigan","country":"USA"}}, {"city":{"cityid":"9","cityname":"Mississippi","cityurl":"mississippi","country":"USA"}}, {"city":{"cityid":"10","cityname":"Hawaii","cityurl":"hawaii","country":"USA"}}]}

Sample XML Request

GET http://www.bestofboutiquenow.com/api/city/?client_id=abcd1234567890&format=xml

Sample XML Response

<?xml version="1.0"?>
<response>
<cities>
<city>
<cityid>1</cityid>
<cityname>Florida</cityname>
<cityurl>florida</cityurl>
<country>USA</country>
</city>
<city>
<cityid>2</cityid>
<cityname>Illinois</cityname>
<cityurl>illinois</cityurl>
<country>USA</country>
</city>
<city>
<cityid>3</cityid>
<cityname>Kansas</cityname>
<cityurl>kansas</cityurl>
<country>USA</country>
</city>
<city>
<cityid>4</cityid>
<cityname>New Jersey</cityname>
<cityurl>new-jersey</cityurl>
<country>USA</country>
</city>
<city>
<cityid>5</cityid>
<cityname>New York</cityname>
<cityurl>new-york</cityurl>
<country>USA</country>
</city>
<city>
<cityid>6</cityid>
<cityname>California</cityname>
<cityurl>california</cityurl>
<country>USA</country>
</city>
<city>
<cityid>7</cityid>
<cityname>Alaska</cityname>
<cityurl>alaska</cityurl>
<country>USA</country>
</city>
<city>
<cityid>8</cityid>
<cityname>Michigan</cityname>
<cityurl>michigan</cityurl>
<country>USA</country>
</city>
<city>
<cityid>9</cityid>
<cityname>Mississippi</cityname>
<cityurl>mississippi</cityurl>
<country>USA</country>
</city>
<city>
<cityid>10</cityid>
<cityname>Hawaii</cityname>
<cityurl>hawaii</cityurl>
<country>USA</country>
</city>
</cities>
</response>

GET /deal/

Shows detailed information about a specified deal

URL

http://www.bestofboutiquenow.com/api/deal/

Formats

JSON (default)

XML

Authentication Required

No

URL Parameters

  • client_id

    The api key that identifies your client

    Example: cee15b12a7518bdf220a92234996195db4639614

  • city

    The city name from which deal should be displayed

    Example: alaska

  • format

    The response type

    Example: xml

Sample JSON Request

GET http://www.bestofboutiquenow.com/api/deal?client_id=abcd1234567890&city=alaska

OR

GET http://www.bestofboutiquenow.com/api/deal?client_id=abcd1234567890&city=alaska&format=json

Sample JSON Response

{"deals":[{"id":"sample-deal-post", "title":"Sample deal post", "city":{"name":"Chennai"}, "imgurl":"http:\/\/groupon.ndot.in\/themes\/green\/images\/no image.jpg", "sidebarImageUrl":"http:\/\/groupon.ndot.in\/", "status":"open", "isSoldOut":false, "soldQuantity":null, "dealUrl":"http:\/\/groupon.ndot.in\/deals\/sample-deal-post_28.html", "options":{"option":{"id":"28", "title":"Sample deal post", "price":{"amount":99, "currencyCode":"USD", "formattedAmount":"$99"}, "value":{"amount":"100", "currencyCode":"USD", "formattedAmount":"$100"}, "discount":{"amount":1, "currencyCode":"USD", "formattedAmount":"$"}, "discountPercent":"1", "isLimitedQuantity":true, "minimumPurchaseQuantity":"1", "maximumPurchaseQuantity":"4", "expiresAt":"2011-02-24 23:05:06", "details":{"detail":{"description":"The wide, well-groomed lanes of Adrenaline Adventures' tubing hill offer rubber-donut wranglers a long, smooth ride down from the snowy summit. With today's deal, patrons pressed for time can pack a plethora of heart-pumping slope-slips into a two-hour snow session during sunny weekend mornings, dog-day afternoons, or any other time the hill is open. Creatures of the night and hard-working life-insurance salesmen can opt for a four-hour evening pass, cloaking activities under a cover of darkness and over less crowded slopes. Helmets protect riders' vulnerable noggins from bruises, yeti bites, and other common tubing injuries, and, after each descent, an energy-saving rope tow pulls lackadaisical loop-sitters up the hill for another ride."}}, "highlights":"Scientists agree that lower limbs should be permanently tucked away in a snow tube's central cavity to prevent spontaneous ", "fineprints":"Scientists agree that lower limbs should be permanently tucked away in a snow tube's central cavity to prevent spontaneous ", "redemptionLocations":{"redemptionLocation":{"lng":"15.456987", "city":"Chennai", "name":"Domino's Pizza Corner", "streetAddress":"T.Nagar, Chennai, Tamilnadu.", "lat":"10.456987"}}, "buyUrl":"http:\/\/groupon.ndot.in\/purchase.html?cid=28"}}, "startAt":"2011-02-02 22:05:06", "endAt":"2011-02-24 23:05:06"}]}

Sample XML Request

GET http://www.bestofboutiquenow.com/api/deal?client_id=abcd1234567890&city=alaska&format=xml

Sample XML Response

<?xml version="1.0"?>
<response>
<deals>
<deal>
<id>best-deals</id>
<title>Best of Boutique Now </title>
<city>
<name>Chennai</name>
</city>
<imgurl>http://www.bestofboutiquenow.com/themes/green/images/no_image.jpg</imgurl>
<sidebarImageUrl>http://www.bestofboutiquenow.com/</sidebarImageUrl>
<status>open</status>
<isSoldOut>false</isSoldOut>
<soldQuantity></soldQuantity>
<dealUrl>http://www.bestofboutiquenow.com/deals/best-deals_52.html</dealUrl>
<options>
<option>
<id>52</id>
<title>Best of Boutique Now </title>
<price>
<amount>5</amount>
<currencyCode>USD</currencyCode>
<formattedAmount>$5</formattedAmount>
</price>
<value>
<amount>50</amount>
<currencyCode>USD</currencyCode>
<formattedAmount>$50</formattedAmount>
</value>
<discount>
<amount>45</amount>
<currencyCode>USD</currencyCode>
<formattedAmount>$</formattedAmount>
</discount>
<discountPercent>90</discountPercent>
<isLimitedQuantity>true</isLimitedQuantity>
<minimumPurchaseQuantity>4</minimumPurchaseQuantity>
<maximumPurchaseQuantity>10</maximumPurchaseQuantity>
<expiresAt>2011-02-28 13:35:31</expiresAt>
<details>
<detail>
<description>Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...</description>
</detail>
</details>
<highlights>Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...</highlights>
<fineprints>Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...</fineprints>
<redemptionLocations>
<redemptionLocation>
<lng>43</lng>
<city>Chennai</city>
<name>Apple iPhone Service Centre</name>
<streetAddress>Dsidc complex Mata sundri Road New Delhi (near the lalit hotel)</streetAddress>
<lat>23</lat>
</redemptionLocation>
</redemptionLocations>
<buyUrl>http://www.bestofboutiquenow.com/purchase.html?cid=52</buyUrl>
</option>
</options>
<startAt>2011-02-16 12:35:31</startAt>
<endAt>2011-02-28 13:35:31</endAt>
</deal>
</deals>
</response>

GET api/

Shows detailed information about a specified deal

URL

http://www.bestofboutiquenow.com/api/

Formats

JSON (default)

XML

Authentication Required

No

URL Parameters

  • client_id

    The api key that identifies your client

    Example: cee15b12a7518bdf220a92234996195db4639614

  • city

    The city name from which deal should be displayed

    Example: alaska

  • format

    The response type

    Example: xml

Sample JSON Request

GET http://www.bestofboutiquenow.com/api/?client_id=abcd1234567890&city=alaska

OR

GET http://www.bestofboutiquenow.com/api/?client_id=abcd1234567890&city=alaska&format=json

Sample JSON Response

{"deals":[{"id":"grand-feast", "title":"grand feast...", "city":{"name":"Chennai"}, "imgurl":"http:\/\/groupon.ndot.in\/themes\/green\/images\/no image.jpg", "sidebarImageUrl":"http:\/\/groupon.ndot.in\/", "status":"open","isSoldOut":false,"soldQuantity":null,"dealUrl":"http:\/\/groupon.ndot.in\/deals\/grand-feast_51.html", "options":{"option":{"id":"51", "title":"grand feast...", "price":{"amount":5,"currencyCode":"USD","formattedAmount":"$5"}, "value":{"amount":"50", "currencyCode":"USD", "formattedAmount":"$50"}, "discount":{"amount":45, "currencyCode":"USD", "formattedAmount":"$"}, "discountPercent":"90", "isLimitedQuantity":true, "minimumPurchaseQuantity":"5", "maximumPurchaseQuantity":"10", "expiresAt":"2011-02-28 13:34:20", "details":{"detail":{"description":"The vouchers issued in the promotion shall expire on January 28, 2011"}}, "highlights":"The vouchers issued in the promotion shall expire on January 28, 2011", "fineprints":"The vouchers issued in the promotion shall expire on January 28, 2011", "redemptionLocations":{"redemptionLocation":{"lng":"43", "city":"Chennai", "name":"Apple iPhone Service Centre", "streetAddress":"Dsidc complex Mata sundri Road New Delhi (near the lalit hotel)", "lat":"23"}}, "buyUrl":"http:\/\/groupon.ndot.in\/purchase.html?cid=51"}}, "startAt":"2011-02-16 12:34:20", "endAt":"2011-02-28 13:34:20"}]}

Sample XML Request

GET http://www.bestofboutiquenow.com/api/?client_id=abcd1234567890&city=alaska&format=xml

Sample XML Response

<?xml version="1.0"?>
<response>
<deals>
<deal>
<id>best-deals</id>
<title>Best of Boutique Now </title>
<city>
<name>Chennai</name>
</city>
<imgurl>http://www.bestofboutiquenow.com/themes/green/images/no_image.jpg</imgurl>
<sidebarImageUrl>http://www.bestofboutiquenow.com/</sidebarImageUrl>
<status>open</status>
<isSoldOut>false</isSoldOut>
<soldQuantity></soldQuantity>
<dealUrl>http://www.bestofboutiquenow.com/deals/best-deals_52.html</dealUrl>
<options>
<option>
<id>52</id>
<title>Best of Boutique Now </title>
<price>
<amount>5</amount>
<currencyCode>USD</currencyCode>
<formattedAmount>$5</formattedAmount>
</price>
<value>
<amount>50</amount>
<currencyCode>USD</currencyCode>
<formattedAmount>$50</formattedAmount>
</value>
<discount>
<amount>45</amount>
<currencyCode>USD</currencyCode>
<formattedAmount>$</formattedAmount>
</discount>
<discountPercent>90</discountPercent>
<isLimitedQuantity>true</isLimitedQuantity>
<minimumPurchaseQuantity>4</minimumPurchaseQuantity>
<maximumPurchaseQuantity>10</maximumPurchaseQuantity>
<expiresAt>2011-02-28 13:35:31</expiresAt>
<details>
<detail>
<description>Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...</description>
</detail>
</details>
<highlights>Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...</highlights>
<fineprints>Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...Why do we use it? It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is ...</fineprints>
<redemptionLocations>
<redemptionLocation>
<lng>43</lng>
<city>Chennai</city>
<name>Apple iPhone Service Centre</name>
<streetAddress>Dsidc complex Mata sundri Road New Delhi (near the lalit hotel)</streetAddress>
<lat>23</lat>
</redemptionLocation>
</redemptionLocations>
<buyUrl>http://www.bestofboutiquenow.com/purchase.html?cid=52</buyUrl>
</option>
</options>
<startAt>2011-02-16 12:35:31</startAt>
<endAt>2011-02-28 13:35:31</endAt>
</deal>
</deals>
</response>