Etsy is a global marketplace for unique and creative goods. We’re driven by our mission to: keep commerce human. Etsy’s Open API supports hundreds of integrations used by thousands of sellers. This space is a new way for us to collaborate directly with developers like you.
We’re working on a new version of our Open API. For several months, we’ve been building a new foundation for updated endpoints and drafting new documentation. The goal of this work is to meet the needs of Etsy’s developer community and make it easier for our team to quickly make updates to the Open API when those needs change.
We’ve built over 60 endpoints that are ready for your feedback. Open API v3 is focused on three main use cases—listing management, post-purchase order management, and shop management. You can explore these new endpoints, including request and response schemas, on our new API Reference site.
If you’d like to make requests to our Open API v3 endpoints, fill out this form.
We’ve spent a lot of time poring over data and charts, but we recognize that our users know their needs best. We also have a hunch that many of you share the same needs. By sharing our plans, documentation, and progress on Github we can all work together to build the Open API that you need.
We’re publishing early drafts of documentation here for your feedback—we’ll make adjustments based on what we hear from you to make it as useful as possible. You’ll find our OpenAPI Specification (OAS) file that defines the interface for our API and powers our reference documentation site. You’ll also find Markdown files that will be published to our new documentation hub, which is launching in the coming months.
We’d love to hear about feature requests, proposed endpoint schema changes, bug reports, and any documentation issues. If you’d like to suggest a change or leave general feedback, please let us know.
We’ve built several issue templates to make it easier for you to provide feedback. Generally, bugs and feature requests for API v3 or docs should be Github issues. Everything else should go to developers@etsy.com.
We also tried to make it easy to provide feedback directly from our API reference docs. Each endpoint definition includes a link to file a bug or feature request with some details filled in.
Finally, we’d love it if you submitted pull requests on our Markdown files. Everyone who contributes to the v3 rollout will get a shoutout when we launch.
Note that by submitting your feedback, we have the right to use it.
Legalese-wise, this means it’s considered non-confidential and non-proprietary to you, and you grant Etsy a non-exclusive, worldwide, royalty-free, irrevocable, sub-licensable, perpetual license to use and publish those ideas and materials for any purpose, without compensation to you.
If you’d like to participate in user feedback sessions with Etsy’s research team, fill out this form.
We’ve also included Etsy’s Open Source Code of Conduct. We expect all community members to abide by this code when participating in discussions or providing feedback.
© 2011-2021 Etsy, Inc. All Rights Reserved. Use of this code is subject to Etsy's API Developer Terms of Use, available at https://www.etsy.com/legal/api