# Etsy

**Canonical:** https://apis.io/providers/etsy/  
**Website:** https://www.etsy.com  
**APIs profiled:** 28

Etsy is a global marketplace for unique and creative handmade, vintage, and craft-supply goods. The Etsy Open API v3 is a REST + OAuth 2.0 surface that third-party developers, sellers, and integration partners use to manage shops, listings, inventory, receipts, transactions, payments, ledger entries, reviews, shipping profiles, processing profiles, production partners, return policies, and seller/buyer taxonomy. Webhooks deliver order lifecycle events (order.paid, order.canceled, order.shipped, order.delivered) to subscriber endpoints. This profile catalogs the public API surface, machine-readable artifacts, plans, rate limits, FinOps alignment, and Naftiko capabilities.

## Kin Score — 64.3 / 100 (strong)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 64.3).

| Facet | Score |
|---|---|
| Discoverability | 59.3 |
| Contract Quality | 75.4 |
| Governance | 26.5 |
| Contract Governance | 26.5 |
| Operational Transparency | 60.5 |
| Developer Ergonomics | 47.6 |
| Commercial Clarity | 71.1 |
| Access Clarity | 71.1 |

Regulatory layer — **Payments**: 64.1 (matched via tags).

## Agent readiness — 43.2 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | verified |
| OpenAPI Examples | verified |
| Rate Limit Signal | documented |
| Event Surface Described | derived |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (28)

- **Etsy Open API v3 Webhooks** — AsyncAPI 2.6 description of Etsy's outbound webhook surface for the Open API v3. Covers the four documented event types (order.paid, order.canceled, order.shipped, order.deliver...
- **Etsy BuyerTaxonomy API** — The BuyerTaxonomy API from Etsy — 2 operation(s) for buyertaxonomy.
- **Etsy Ledger Entry API** — The Ledger Entry API from Etsy — 2 operation(s) for ledger entry.
- **Etsy Other API** — The Other API from Etsy — 2 operation(s) for other.
- **Etsy Payment API** — The Payment API from Etsy — 3 operation(s) for payment.
- **Etsy Review API** — The Review API from Etsy — 2 operation(s) for review.
- **Etsy SellerTaxonomy API** — The SellerTaxonomy API from Etsy — 2 operation(s) for sellertaxonomy.
- **Etsy Shop API** — The Shop API from Etsy — 3 operation(s) for shop.
- **Etsy Shop HolidayPreferences API** — The Shop HolidayPreferences API from Etsy — 2 operation(s) for shop holidaypreferences.
- **Etsy Shop ProcessingProfiles API** — The Shop ProcessingProfiles API from Etsy — 2 operation(s) for shop processingprofiles.
- **Etsy Shop ProductionPartner API** — The Shop ProductionPartner API from Etsy — 1 operation(s) for shop productionpartner.
- **Etsy Shop Receipt API** — The Shop Receipt API from Etsy — 3 operation(s) for shop receipt.
- **Etsy Shop Receipt Transactions API** — The Shop Receipt Transactions API from Etsy — 4 operation(s) for shop receipt transactions.
- **Etsy Shop Return Policy API** — The Shop Return Policy API from Etsy — 3 operation(s) for shop return policy.
- **Etsy Shop Section API** — The Shop Section API from Etsy — 2 operation(s) for shop section.
- **Etsy Shop ShippingProfile API** — The Shop ShippingProfile API from Etsy — 7 operation(s) for shop shippingprofile.
- **Etsy ShopListing API** — The ShopListing API from Etsy — 13 operation(s) for shoplisting.
- **Etsy ShopListing File API** — The ShopListing File API from Etsy — 2 operation(s) for shoplisting file.
- **Etsy ShopListing Image API** — The ShopListing Image API from Etsy — 4 operation(s) for shoplisting image.
- **Etsy ShopListing Inventory API** — The ShopListing Inventory API from Etsy — 1 operation(s) for shoplisting inventory.
- **Etsy ShopListing Offering API** — The ShopListing Offering API from Etsy — 1 operation(s) for shoplisting offering.
- **Etsy ShopListing Personalization API** — The ShopListing Personalization API from Etsy — 2 operation(s) for shoplisting personalization.
- **Etsy ShopListing Product API** — The ShopListing Product API from Etsy — 1 operation(s) for shoplisting product.
- **Etsy ShopListing Translation API** — The ShopListing Translation API from Etsy — 1 operation(s) for shoplisting translation.
- **Etsy ShopListing VariationImage API** — The ShopListing VariationImage API from Etsy — 1 operation(s) for shoplisting variationimage.
- **Etsy ShopListing Video API** — The ShopListing Video API from Etsy — 4 operation(s) for shoplisting video.
- **Etsy User API** — The User API from Etsy — 2 operation(s) for user.
- **Etsy UserAddress API** — The UserAddress API from Etsy — 2 operation(s) for useraddress.

## Agentic access (1)

- **Etsy Agentic Access** — 103 operations · 42 acting

## Security (3)

- **Etsy Authentication** — apiKey/oauth2 · 2 schemes
- **Etsy Domain Security** — TLSv1.3 · HSTS · DMARC
- **Etsy Vulnerability Disclosure** — Bugcrowd · security.txt · contact published

## Plans (1)

- **Etsy Plans Pricing**

## Tags

Marketplace, E-Commerce, Handmade, Listings, Order, Payments, Reviews, Shipping, Taxonomy, Authentication

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/etsy/). Scores are computed from the provider's own public artifacts under a published rubric.