I had just updated a new version of K-Lib. This current version now has search methods used to get swatches by themeID, userID, email, tag, hex and title. I have also added test examples for all the supported methods.

Have a look at http://code.google.com/p/k-lib/