Some Java to Search Etsy for Matching Products

January 15th, 2014

To put together a demonstration of Surf Canyon’s search technology with Etsy’s products, we needed some Java code that would search Etsy and return a list of matching products.  We assumed that this could probably be done in about 100 lines of Java code.

We also figured someone must have done this before, but after searching online the code that we found was much longer and a lot more complicated (mainly because it was trying to access parts of the Etsy API that required OAuth authentication) than what we had been expecting. However, just doing a product search doesn’t require any authentication, so we went ahead and wrote some much simpler code that did only what we needed.

The Java code, written by Mike Wertheim, is about 100 lines long and can be found at

The code makes use of Jackson (an open source Java library that handles JSON).  To compile and run, download the two Jackson jar files ( and and put them in your Java CLASSPATH.  Then copy the code from the web page ( to the clipboard and paste it into a file called  (If you download the code directly, instead of doing copy and paste, you will probably run into problems with HTML entities.)

If you have any questions or feedback, please post them in the comments below or contact us.

Tags: Code