FAQ

How can I access the new API?#

Any developer with an active application can opt-in to access the API.

What happens if I don't migrate?#

We commit to providing ample time, notice, and support to migrate your app to the new Open API v3. Requests to v2 endpoints after the sunset date will start to fail, which could disrupt your application and users.

How can I get help with my migration?#

  • There’s a lot of helpful documentation available, including the reference docs and this migration guide.
  • If you have a suggestion for our new API or documentation, you can create a discussion on Github.
  • Similarly, if you suspect you’ve found a bug, please submit a bug report.
  • If you are having trouble updating your application, reach out to our Google Group for support from our community.
  • If you believe something is wrong with your application, please contact us at developers@etsy.com.

Are there any changes to API Rate Limits?#

note

API rate limits in v3 are the same as v2. Similarly, negotiated rate limits from v2 remain the same in v3 if you're using the same Etsy App API Key that you used in v2.

By default, an Etsy app — making public requests authenticated with its API key — can make 10,000 requests per 24-hour period, with a limit of 10 queries per second. For more information on rate limits, see API rate limit basics.

How can I stay informed of changes to the API?#

We commit to communicating often while developing Open API v3 about updates, upcoming milestones, and new ways to give feedback and get involved. Update your contact information for the Etsy account that owns your API application and follow the community discussion at Github Discussions.

How can I provide feedback on the API?#

To report an issue or provide feedback on the API design or documentation, please start a discussion on Github Discussions.

Note that by submitting your feedback, we have the right to use it. Legalese-wise, this means your feedback is 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.

Is the OpenAPI open source?#

Etsy’s Open API v3 is not an open source project, but we do provide open access to the API design and documentation and welcome your feedback. Using Etsy's API is subject to Etsy’s API Terms of Use, and Etsy’s primary Terms of Use, Privacy Policy, and other applicable House Rules.

I have an OAuth 1.0 token what do I do?#

Access to Etsy's Open API v3 requires a valid OAuth 2.0 token. Recently migrated apps from v2 to v3 should follow the Token Exchange Guide to convert existing OAuth 1.0 tokens to OAuth 2.0 tokens.