# Etsy — Ecommerce API: overview

> Canonical URL: https://developers.apideck.com/apis/ecommerce/etsy/overview

Etsy is a store that makes it easy to buy and sell handmade, vintage or uniquely manufactured goods online.
- Status: live
- Authentication: oauth2

- **partnership required:** false
- **important to know:** Etsy gates access by app type. A Seller App is approved within minutes but can only ever connect the shop of the person who registered it; connecting other sellers' shops needs a Personal App and, at scale, Commercial Access, which Etsy reviews manually.
- **account type required:** Etsy account with an active shop
- **consumer access level:** Sign-in to the Etsy account that holds the shop being connected
- **partnership note:** Etsy runs no partner programme; any Etsy account holder can register an app.
- **supported resource categories:**   - **resources:** orders
  - **name:** Orders
  - **name:** Products
  - **resources:** products
  - **resources:** stores
  - **name:** Stores
- **partnership portal name:** Etsy developer portal
- **responsibility matrix:**   - **apideck:** Docs provided
  - **area:** Register an Etsy app
  - **consumer:** ✓
  - **consumer:** ✓
  - **area:** Authorize the connection and select the shop
  - **area:** Token refresh and credential storage
  - **apideck:** ✓
  - **apideck:** ✓
  - **area:** Maintain the connector and unified Ecommerce API
- **apideck credentials note:** Each connection supplies its own Etsy app's Keystring and Shared Secret.
- **webhooks:** No webhooks - data is read by polling.
- **sandbox note:** Etsy's testing policy is to test on production with a real shop, where listing fees apply.
- **environment notes:**   - **environment:** Production only
  - **description:** Etsy has a single production environment at https://api.etsy.com/v3. The same app credentials serve testing and production, so every test call works on live shop data.
- **difficulty:** moderate
- **rate limits:** Per-app QPS and QPD limits, shown in the Etsy Developer Portal.
- **authentication note:** Authorization Code flow with PKCE; requests also carry the app's key in the x-api-key header.
- **external guides:**   - **url:** https://developer.etsy.com/documentation/essentials/rate-limits
  - **title:** Etsy Open API v3: Rate limits
  - **source:** Etsy
- **sandbox available:** false
- **partnership url:** https://www.etsy.com/developers/register
- **difficulty reason:** Self-Service App Registration + Etsy App Review
- **apideck credentials available:** false

## Supported resources

- **downstream id:** listings
- **id:** products
- **downstream name:** Listings
- **status:** live
- **custom field support:** false
- **name:** Products
- **downstream name:** Receipts
- **downstream id:** receipts
- **name:** Orders
- **status:** live
- **custom field support:** false
- **id:** orders
- **id:** stores
- **name:** Stores
- **custom field support:** false
- **status:** live
- **downstream id:** shops
- **downstream name:** Shops

An omitted operation list does not establish operation support. Verify the selected operation in the coverage matrix.

[API reference](https://developers.apideck.com/apis/ecommerce/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/ecommerce/coverage)