KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #codex #typescript #ai-agents #claude-code #dsh #dsh-plugin #open-source #cli #deepseek-harness #macos #ai-agent

etsy-ts

★ 44 Open GitHub ↗

Etsy API wrapper written in typescript

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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](examples/example.ts)  
Find full [API v3 documentation](https://developer.etsy.com) on Etsy.

### Breaking changes when migrating from 6.x.x to 7.x.x
- `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](https://www.etsy.com/developers/your-apps) page. See [Etsy's documentation](https://developer.etsy.com/documentation/essentials/requests) for more details.

### Breaking changes when migrating from 3.x.x to 4.x.x
- 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`](src/types/ISecurityDataStorage.ts) interface. See a sample implementation
  in [examples/v3/SecurityDataStorage.ts](examples/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](https://www.etsy.com/openapi/generated/oas/3.0.0.json), fed to [swagger-typescript-api](https://github.com/acacode/swagger-typescript-api).

etsy-ts

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README