Etsy Developer Community Developer Blog

photo by  Benandi

API bug fixes.

I know, you probably dont believe it.  We have fixed a few of the issues that I listed in the forums.  They are:

• Fixed API methods for getting feedback. This was previously returning an empty feedback object when you were looking for an id that doesn't exist, now it returns a 404.
• Fixed a bug where case sensitivity, such as jewelry, Jewelry, jEwElry was returning inconsistent results.
• Searching for tags with underscores now returns proper results.  Previously would return empty results for anything with underscores.
• Added a new sort order for search relevance.  You can now use sort_on=score for getListingsByKeyword, getListingsByTag, and getListingsByMaterial.

Thanks for your patience,

Tom

photo by  reaver

Do you know about our libraries?

We have had some recent additions to our resources page, we now have libraries for Cocoa, Perl, Actionscript, Ruby, .NET, Yahoo! Query Language, and even Lisp!  These libraries have been built by our developer community and are free to use.  Check their websites for specific terms of use.

Tom

photo by  luxfordst

Happy July Developers,

Our official Etsy blog, the Storque, has started a series of articles on developers using the Etsy API.  The series is called "Handmade Code".  Since we started the series, we have featured Etsy Addict, Craft Cult, 26 Olive Street, Etsy Hacks, and Morecloth.

If your interested in taking part, let us know at developer@etsy.com and if we think it would make a good article, we will post the interview on our main blog.

Thanks, Tom

photo by  ClockworkZero

Hey Developers,

Its been about three weeks since our last post, I see some new apps in the works and both Justin and I monitor the forums for your questions.  I wanted to provide some guidelines to developers on how to promote your applications to our Etsy community.  

If I have one item to mention about application development, I urge you to contact us before announcing your application to the world.  We can provide feedback on your application, set appopriate call limits, and review the application with respect to our terms of use.  Just contact us at developer@etsy.com.  

Here are the guidelines: 

• Developers agree to abide by Etsy's policies as set forth in the DOs and DON'Ts and Terms of Use for Etsy; developers are members of the Etsy community and therefore subject to the same policies as all other members.
• A developer's username on Etsy.com may not contain the word "Etsy" unless they have obtained explicit permission from Etsy for this use of Etsy's trademarks. 
• Developers should identify themselves in their Etsy profile and in Etsy Forum posts as a developer using the Etsy API.
• Developers may post a single new thread in the Business Topics section to announce the launch of a new application or significant changes to an application.
• Developers are welcome to post in the Promotions section to promote their applications. Developers must not inundate other sections of the Etsy Forums with multiple threads about their applications; this will be seen as spam and moved to the Promotions section or closed.
• Developers may offer support to the Etsy community in member-created threads that inquire about their specific application.
• Developers may read the Forums for inspiration for new applications that may be of interest to the community, but developers should not post in the Etsy Forums explicitly soliciting community requests/advice for new applications.
• Etsy's Forum Moderators reserve the right to move or close threads at their discretion.

photo by  ArtMind

Howdy,

We've made a small update to the API today to do two things:

• Add support for all listing images: by popular demand, we've added the "all_images" field to listing records when detail level is "high."  The documentation describes the new fields.
• Filter out listings in 'edit' state: attempting to access a listing in the 'edit' state will now throw a "403 Forbidden" response.  We apologize for the inconvenience, and we're working on a better long-term solution.

photo by  capitolagirl

Howdy,

Yesterday we released a very minor bugfix for the API that corrects an issue with inconsistent HTML entities that some of you reported.  From now on, all data coming out of the API should be fully HTML-entity-decoded.  (You should make sure that you do your own encoding before output.)  Please let us know in the forums if you see any more rogue HTML entities in API output.

Justin

photo by  bethingels1

Howdy,

Last night we released fixes for some issues that were reported in the forums:

• The tag/category name 'mp3' is now accessible.
• getListingsByCategory should now work with sub- and sub-sub- categories.
• Specifying an offset that's greater than the total set size of a query will now return a 400 Bad Request.

We are still working on the HTML entities in data fields; please stay tuned.

Justin

photo by thecellophanes

Developers,

Here's a quick roundup of what has been happening in the Etsy Developer Community since we launched publicly on March 23.

Tech Updates

We recently made a few updates to the API to fix minor bugs. You can find them listed in our blog under the tag "releasenotes."

API Badges

We added a number of badges in the resources section that you can add to your applications. Our only request is you link the badge back to the developer site to help spread the word. Here are some examples:

Recent Coverage

select * from etsy.listings where color='$col' and search_terms='$q' and 
wiggle=10 and detail_level='medium' and api_key='$api_key' 

For a technical overview of YQL, check out this post from Ryan Barrett on snarfed.org.

You can find the Etsy API on the github repository, along side the New York Times, Twitter, Zillow and others.

Many thanks to Ramus Lerdorf (best know as the creator of PHP!) who ported the Etsy API to YQL!

Tom

photo by davepalumbo

Developers,

We at Etsy are excited to announce the public launch of the Etsy Developer Community and API, as of 2:00pm EDT today. Woohoo!  

I want to thank all of you who helped make our private beta test a success.  We had close to 100 developers sign up during the beta, and you gave us valuable feedback on the Etsy API and documentation. Since we rolled out the Etsy API in private beta six weeks ago, we made available a total of 34 API methods, ranging from searching listings, favorites, shops and feedback. Over 60 developers signed up for the private beta, and there are now several applications live using the API.

Please review the Etsy API Terms of Use, which are now complete and in effect.

We also announced today’s public launch of the Etsy Developer Community and API on Etsy’s blog, The Storque. You can read what Etsy members are saying about the announcement on the related discussion thread in Etsy’s Forums. 

Thanks all!

Tom