We hope everybody's making progress on your developer contest entries. Remember, enter by Nov 30 to win an iPhone 3G and a year of service, an $1860 value!
This week's spotlight entry is WhatUWearin.com: share your latest look with your friends on Facebook, integrated with ShopStyle's vast fashion inventory.
Our API lets you search and filter hundreds of thousands of fashion and living products featured on ShopStyle's US and UK sites; access thousands of looks created by our members; and get data on most popular brands and categories. Build your own site, mobile app or mash-up featuring ShopStyle products and we'll keep track of clicks you generate to our retailers. And enter our contest to win an iPhone and a year of service!
Here you can peruse our
To sign up you just need an account on shopstyle.com, and we'll provide you an API key. Questions or comments? Leave a comment here or email us at developer [at] shopstyle.com. We can't wait to see what you're working on to feed their habit. Have fun!
Check out a few examples of websites that use the ShopStyle API!
CelebStyle.com — the definitive guide to what celebrities are wearing on and off the screen. The ShopStyle API powers custom product queries and layouts.
SaleHabit.com — search fashion and products on sale across the internet. The ShopStyle API powers a full example storefront with search, browsing and filtering features.
InStyle Shopping — the leading fashion & style magazine's shopping website is powered by ShopStyle. On this page, the "Most Shopped" ticker and "Editor's Picks" Flash widget use the ShopStyle API.
OnSugar — the Sugar Network's new blogging platform features a spread builder allowing members to build custom magazine-like layouts of their favorite ShopStyle items, powered by the API.
Also dozens of sites embed ShopStyle widgets. Take a look at glamour.com, instyle.com, fabsugar, casasugar, stylebakery, runwaydaily, shefinds, vibe.com, cumul.us, and many others for widget examples!
Find a ShopStyle product you want to share on your site or blog, and get credit for clicks by your visitors? Easy to do ... mouse over an item, click "Share this item", then "Blog it", and pick your image size.
  |
Start shopping on shopstyle.com or check out a great widget example on fabsugar.com.
Toss up a widget to allow your visitors to search and scroll through ShopStyle's inventory without leaving your site!
Here's an example:
Configure your own here: US fashion, US living/home, UK fashion.
Share your own or other members' looks on your site with a ShopStyle widget. Just click the "Blog It" button next to any look in a stylebook. Here's a celebrity look from our fashion archive:
Customize the size, layout and contents of your widget. Build your own now!
A spread by one of our prolific members:
Embed a scrolling browser of looks in spread format from your favorite member, group or tag!
Example: large widget for member 'binky':
Here's the same code. Build your own widget by clicking Blog Looks from a member or group page!
Feature the most popular brands or products, automatically pulled from ShopStyle's inventory.
Popular brands & categories in women's fashion:
Customize this code to build your own!
Popular products in dresses, shoes, jewelry, and bags from our UK site:
Customize this code to build your own!
For inspiration, watch our TV commercial featuring Shopasaurus, the ShopStyle fashion beast.
Get Flash to see this player.
You can also download these two sample files here:
| pid | Unique API_KEY string that is assinged to the caller. If you haven't signed up yet, sign up here to get your Shopstyle API key. This parameter must be present. |
|
format |
The format of the response. Supported values are:
|
| site | Specifies the ShopStyle website to be searched or queried (optional; defaults to US fashion).
|
| fts | Text search terms, as a user would enter in a Search: field. |
| cat | A product category. Only products within the category will be returned. The easiest way to find values for this parameter is to browse to a category on the ShopStyle website, and take the last element of the URL path, e.g., from http://www.shopstyle.com/browse/dresses use "dresses". Another way is to look at the categories of the products returned by the apiSearch or to look at the list of categories from apiGetCategoryHistogram. |
| fl |
Specify one or more filters on the query for brand, retailer, price, discount, and/or size. Each filter value has an initial letter and a numeric id. The easiest way to construct a filter list is to do a search on ShopStyle, select one or more filter in the UI, and copy the resulting URL. To convert brand or retailer names to ids, use the http://www.shopstyle.com/browse/womens-clothes?fl=d0&fl=b3510&fl=b689&fl=r21 Filter prefixes are:
|
| pdd | A "price drop date" expressed as a number of milliseconds since Jan 1, 1970. If present, limits the results to products whose price has dropped since the given date. |
| prodid | The id of a specific product to return. This may be specified multiple times to get many products in one response. |
| min | The index of the first product to return, or 0 (zero) if not specified. A client can use this to implement paging through large result sets. |
| count | The maximum number of results to return, or 20 if not specified. Requesting too many results may impact performance. Combine with the min parameter to implement paging. |
| filterType | The type of filter data to return. Possible values are Brand, Retailer, Price, Discount and Size. |
| look | The ID number of the look. An easy way to get a look's ID is to go to the stylebook page that contains the look at the ShopStyle website, and right-click on the button that you use to edit the look. From the popup menu, select "Copy Link", and paste that into any text editor. The "lookId" query parameter of that URL is the value to use for this API method. |
| type | The type of search to perform. Supported values are:
|
| min | The index of the first product to return, or 0 (zero) if not specified. A client can use this to implement paging through large result sets. |
| count | The maximum number of results to return, or 20 if not specified. Combine with the min parameter to implement paging. |
| id | The ID number of the product. An easy way to get a product's ID is to find the product somewhere in the ShopStyle UI, and right-click on the product image. From the popup menu, select "Copy Link", and paste that into any text editor. The "id" query parameter of that URL is the value to use for this API method. |
| cat | Category you want to restrict the popularity search for. This is an optional parameter. If category is not supplied, all the popular brands regardless of category will be returned. |
| products | To skip sample products, just pass value 0 for this attribute. This is an optional attribute as well. |
