etsy-ts

Etsy API wrapper written in TypeScript. Includes types for all Etsy API endpoints.

Installation:

npm install etsy-ts --save
yarn add etsy-ts

Etsy API v3

See example in examples/run.ts
Find full API v3 documentation on Etsy.

$3

- Etsy class constructor now requires a sharedSecret parameter in addition to apiKey. This is required by Etsy starting January 18, 2026. Find your shared secret on the Your Apps page. See Etsy's documentation for more details.

$3

- Support for Etsy APIv2 is removed
- All v3 modules are now imported from the root of the package, e.g. import { Etsy } from 'etsy-ts' instead
of import { Etsy } from 'etsy-ts/v3'
- Etsy class constructor now requires SecurityDataStorage instance that
implements ISecurityDataStorage interface. See a sample implementation
in examples/v3/SecurityDataStorage.ts.
- You should remove the refresh token logic from your code - now that's included within this client
- For methods that require oauth, now you need to pass etsyUserId instead of accessToken. This client will
use SecurityDataStorage instance to get, refresh and save accessToken for the given etsyUserId.

Credits

Most of the code is _generated_ from Etsy APIv3 Swagger specs, fed to swagger-typescript-api.