Etsy

Overview

The Etsy Open API v3 exposes listings, shops, and transactions — for seller tooling and marketplace apps. Auth is OAuth 2.0 (an unauthenticated request returns 403, verified).

Quick Start

OAuth token flow: register an app at etsy.com/developers → get Client ID + Secret → OAuth 2.0 (Authorization Code + PKCE). Then (replace YOUR_TOKEN):

curl "https://openapi.etsy.com/v3/application/shops" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "count": 1,
  "results": [
    { "shop_id": 12345, "shop_name": "MyShop", "title": "Handmade goods", "url": "https://www.etsy.com/shop/MyShop" }
  ]
}

Authentication

• Register at etsy.com/developers → create an app → Client ID + Secret.
• OAuth 2.0 with PKCE (public clients) — user authorizes shop access.
• Send the access token as Authorization: Bearer YOUR_TOKEN (missing → 403, verified).

Rate Limits & Notes

• Rate limits vary by endpoint and app tier (see the docs) — the Open API is free to use.
• v3 is the current API (v2 was retired).
• Key resources: listings, shops, receipts, shipping, and payments.
• The API requires user-consented scopes per shop.

FAQ

Is Etsy API free? The Open API is free with rate limits.

How do I get a token? Register an app → OAuth 2.0 flow → user consent.

Why 403? Endpoints require a Bearer token (verified).