Etsy Open API v3

Welcome to the improved Etsy Open API v3, a REST API that extends support for inventory, sales orders, and shop management on the Etsy platform. These guides support current and future app developers as they build tools to integrate with and automate processes for Etsy shops and customers.

Getting started#

Our updated documentation is divided into a few sections, geared towards different use cases.

Build with AI#

The OpenAPI Dev MCP server connects AI coding assistants directly to the Etsy Open API, providing access to endpoint details, request and response schemas, authentication requirements, and OAuth scopes. Ask your assistant questions like "How do I create a listing?" or "What fields are in a ShopReceipt?" and get accurate, current answers backed by the live API spec.

Compatible with Claude, Cursor, VS Code, and other MCP-compatible tools. No API key is required to use the MCP server.

Developing a New Open API App#

To build with Etsy's Open API v3, you need to register an app in the Etsy Developer Portal. Registering an app creates an Etsy App API keystring and a shared secret, which you can find in Your Apps.

There are two main paths for creating an app, depending on what you want to build:

Seller App — for sellers building tools for their own shop.
Personal App, with the option to request Commercial Access later — for developers building tools that may be used by other buyers or sellers.

Choose the path that best matches your use case.

Seller Apps#

Seller Apps are for individual Etsy sellers who want to connect an app to their own shop data.

This is the recommended starting point if you are a shop owner building custom tools, automations, reports, or workflows for your shop only.

Eligibility#

Any seller with an active Etsy shop in good standing who doesn't already have an active app.

What's included#

Seller App access includes access to all public and OAuth-authenticated endpoints, scoped only to your registered shop.

How to apply#

Eligible sellers are approved within minutes, with no manual review queue.

Important limitation#

Seller App Access is for your own shop use only. You will only be allowed to authenticate your app with your shop. It cannot be used to access other sellers' private shop data or to build applications for the broader Etsy seller community.

Personal Apps and Commercial Access#

A Personal App is the starting point for developers who want to build on Etsy's API for uses beyond their own shop.

This includes tools that other buyers or sellers may use at a limited scale. If your app needs to grow beyond limited-scale use, you can request an upgrade to Commercial Access.

Commercial Access is not a separate app creation path at first. It is reached through a two-step process:

Create a Personal App in the Developer Portal.
After the Personal App is approved, request Commercial Access for that app.

Personal App Access#

Personal App access lets you build and test an app for use cases beyond your own shop, including tools that other buyers or sellers may use at limited scale.

Eligibility#

Any registered developer with a qualifying use case.

What's included#

Personal App access allows you to build with Etsy's API beyond your own shop, subject to Etsy's review and applicable limits.

How to apply#

Personal Apps go through a deeper review process than Seller Apps.

Commercial Access#

Commercial Access is for developers building applications that other Etsy sellers will connect to and use at a broader scale.

You must have an approved Personal App before you can request Commercial Access.

Eligibility#

Any registered developer with an approved Personal App and a qualifying commercial application.

What's included#

Commercial Access includes access to all public and OAuth-authenticated endpoints for any seller who grants OAuth consent, governed by OAuth token scopes.

How to apply#

To request Commercial Access:

Create and receive approval for a Personal App.
Go to Apps You've Made.
Click Request Commercial Access next to your app.

If you are an individual seller looking to connect only to your own shop data, apply for a Seller App instead.

Commercial Access requests are reviewed manually. Review time may vary depending on your proposed use case.

Commercial Access Review Criteria#

Etsy reviews Commercial Access requests against the following criteria:

Applications and their home pages must comply with Etsy's API Terms of Use.
Applications must follow the caching policies identified in Section 1 of the API Terms of Use.
Applications must clearly distinguish themselves from Etsy, as noted in Section 6 of the API Terms of Use. The following phrase must appear in a prominent position: "The term 'Etsy' is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc."
Applications must not sidestep the API to retrieve or post Etsy data. Screen-scraping is not allowed.
Applications that access private member data must use OAuth authentication.
Application names and artwork must follow Etsy's Trademark Policy.
Applications with Commercial Access that use the transaction_r permission scope must request access to the buyer_email field separately.

Not Sure Which Path Is Right for You?#

	Seller App	Personal App	Commercial Access
Who it's for	Individual sellers building for their own shop	Developers building beyond their own shop at limited scale	Developers building apps for other sellers at broader scale
Where to start	Select Create a seller app	Select Create a personal app	Start by creating a Personal App, then request Commercial Access
Approval	Automated, near-instant for eligible sellers	Deeper review process	Manual commercial review
Shop access	Your shop only	Limited-scale access based on approved use case	Any seller who grants OAuth consent
Commercial use	Not permitted	Limited, based on approved use case	Permitted after approval
Best for	Shop owners building their own tools	Developers testing or launching a limited-scale tool	Developers scaling an app for use by many sellers

Choosing the Right Option#

Choose Create a seller app if you are a shop owner and your app will only connect to your own Etsy shop.

Choose Create a personal app if you are building a tool that may be used by other buyers or sellers, but you do not yet need full Commercial Access.

Choose Commercial Access if your approved Personal App is ready to support other Etsy sellers at a broader scale.

Get Help#

When you need more support, please refer to the resources on our help page.