# swell-node

> Swell API client for NodeJS

Latest version **6.0.5** (published 2026-05-18) · MIT license · 0 weekly downloads

## Install

```sh
npm install swell-node
pnpm add swell-node
yarn add swell-node
bun add swell-node
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 6.0.5 |
| Published | 2026-05-18 |
| First published | 2019-03-29 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=16 |
| Dependencies | 4 |
| Unpacked size | 80.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 20 |
| Author | Swell |
| Maintainers | ei |
| Keywords | swell, ecommerce, api |

## Links

- npm: https://www.npmjs.com/package/swell-node
- Repository: https://github.com/swellstores/swell-node
- Issues: https://github.com/swellstores/swell-node/issues
- npm.io page: https://npm.io/package/swell-node

## Dependencies (4)

- [axios](https://npm.io/package/axios.md) ^1.7.7
- [retry](https://npm.io/package/retry.md) ^0.13.1
- [tough-cookie](https://npm.io/package/tough-cookie.md) ^4.1.4
- [http-cookie-agent](https://npm.io/package/http-cookie-agent.md) ^5.0.4

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 6.0.5 (latest) — 2026-05-18
- 6.0.4 — 2026-04-08
- 6.0.3 — 2025-08-12
- 6.0.2 — 2025-08-12
- 6.0.1 — 2025-08-09
- 6.0.0 — 2024-10-18
- 5.6.1 — 2024-10-18
- 5.6.0 — 2023-12-22
- 5.5.0 — 2023-12-11
- 5.4.3 — 2023-11-21
- 5.4.2 — 2023-11-14
- 5.4.1 — 2023-11-13
- 5.4.0 — 2023-10-04
- 5.3.0 — 2023-09-18
- 5.2.0 — 2023-08-01
- … 26 more at https://npm.io/package/swell-node/versions

## README

## Swell API library for NodeJS

[Swell](https://www.swell.is) is a customizable, API-first platform for powering modern B2C/B2B shopping experiences and marketplaces. Build and connect anything using your favorite technologies, and provide admins with an easy to use dashboard.

## Install

    npm install swell-node --save

## Connect

```javascript
const { swell } = require('swell-node');

swell.init('my-store', 'secret-key');
```

To connect to multiple stores in the same process, use `swell.createClient()`:

```javascript
const { swell } = require('swell-node');

const client1 = swell.createClient('my-store-1', 'secret-key-1');
const client2 = swell.createClient('my-store-2', 'secret-key-2');
```

## Usage

```javascript
try {
  const { data } = await swell.get('/products', {
    active: true
  });
  console.log(data);
} catch (err) {
  console.error(err.message);
}
```

## Documentation

This library is intended for use with the Swell Backend API: https://developers.swell.is/backend-api

## Contributing

Pull requests are welcome

## License

MIT

---
_Source: https://npm.io/package/swell-node · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
