soundcloud-api-ts — Fully-typed TypeScript client for the SoundCloud API

[twin-paws]

Hey folks 👋

I built a TypeScript client for the SoundCloud API and wanted to share it with the community.

soundcloud-api-ts — zero dependencies, native fetch, full TypeScript types, and an interactive CLI.

Highlights:

• 🔐 Official OAuth 2.1 + PKCE (registered app credentials, not scraped client IDs)
• 📦 Zero dependencies, 4.5 KB gzipped
• 🎵 CLI tool (sc-cli) — search, play tracks in terminal, resolve URLs, manage playlists
• ♻️ Automatic retry with exponential backoff on 429/5xx
• 🔄 Auto token refresh on 401
• 🧪 100% test coverage
• 📖 Full TypeDoc API docs
• ✅ Fully API Terms of Use compliant — official API only, no scraping, no undocumented endpoints

npm install soundcloud-api-ts

import { SoundCloudClient } from 'soundcloud-api-ts';

const sc = new SoundCloudClient({ clientId, clientSecret });
const results = await sc.search.tracks('lofi beats');

Would love any feedback. Issues and PRs welcome!
npm: https://www.npmjs.com/package/soundcloud-api-ts
GitHub: https://github.com/twin-paws/soundcloud-api-ts