If you haven't already, please review the Kuler Terms of Use, and download the Kuler API logo.
The following API requests return lists of formatted RSS feed items. The syntax in each case follows the prefix *http://kuler-api.adobe.com/*
Get RSS Feeds
rss/get.cfm?listType=[listType]&startIndex=[startIndex]&itemsPerPage=[itemsPerPage]&timeSpan=[timeSpan]&key=[key]
Returns a list of feeds of a specified type.
- listType: Optional. One of the strings recent (the default), popular, rating, or random.
- startIndex: Optional. A 0-based index into the list that specifies the first item to display. Default is 0, which displays the first item in the list.
- itemsPerPage: Optional. The maximum number of items to display on a page, in the range 1..100. Default is 20.
- timeSpan: Optional. Value in days to limit the set of themes retrieved. Default is 0, which retrieves all themes without time limit.
- key: Required. This is the developer API key obtained here.
Example usage
Search RSS Feeds
rss/search.cfm?searchQuery=[searchQuery]&startIndex=[startIndex]&itemsPerPage=[itemsPerPage]&key=[key]
Returns a list of feeds that meet specified search criteria.
- searchQuery: Optional. A search filter. This can be one of the predefined filters listed below, or a simple string term to search on; for example, "blue". If you specify a simple term, the search looks for that term in theme titles, tags, author names, themeIDs, authorIDs, and hexValues. By default, retrieves all available feeds.<br> These filters are available:
- themeID - search on a specific themeID
- userID - search on a specific userID
- email - search on a specific email
- tag - search on a tag word
- hex - search on a hex color value (can be in the format "ABCDEF" or "0xABCDEF")
- title - search on a theme title
- startIndex: Optional. A 0-based index into the list that specifies the first item to display. Default is 0, which displays the first item in the list.
- itemsPerPage: Optional. The maximum number of items to display on a page, in the range 1..100. Default is 20.
- key: Required. This is the developer API key obtained here.
Example usage
Themes
Theme Thumbnail
rss/png/generateThemePng.cfm?themeid=[theme_id]
Retrieves a thumbnail of a specific theme
- themeid: Required. The id of a specified theme.
For example:
http://kuler-api.adobe.com/rss/png/generateThemePng.cfm?themeid=11
View Theme
To view a specific theme directly in the kuler public website, use the following URL:
http://kuler.adobe.com/#themeID/[theme_id]
For example:
http://kuler.adobe.com/#themeID/42374
View Comments
Returns a list of comments for either a specified theme (if a themeID is provided) or for all of a member's themes (if an email is provided)
rss/comments.cfm?themeID=[themeID]&email=[email]&startIndex=[startIndex]&itemsPerPage=[itemsPerPage]&key=[key]
- themeID: Optional. When this value is used, all comments are retrieved for the specified theme
- email: Optional. When this value is used, comments are retrieved for themes created by this user
- startIndex: Optional. A 0-based index into the list that specifies the first item to display. Default is 0, which displays the first item in the list.
- itemsPerPage: Optional. The maximum number of items to display on a page, in the range [1..100]. Default is 20.
- key: Required. This is the developer API key obtained here.
Example usage
