Songstats Node SDK

Official Node.js client for the Songstats Enterprise API.

📚 API Documentation: https://docs.songstats.com
🔑 API Key Access: Please contact [email protected]

Requirements

• Node.js >= 18

Installation

Install with your package manager of choice:

npm install songstats-node-sdk

yarn add songstats-node-sdk

pnpm add songstats-node-sdk

bun add songstats-node-sdk

Quick Start

import { SongstatsClient } from "songstats-node-sdk";

const client = new SongstatsClient({
  apiKey: process.env.SONGSTATS_API_KEY,
});

// API status
const status = await client.info.status();

// Track information
const track = await client.tracks.info({
  songstats_track_id: "abcd1234",
});

// Artist statistics
const artistStats = await client.artists.stats({
  songstats_artist_id: "abcd1234",
  source: "spotify",
});

Authentication

All requests include your API key in the apikey header.

We recommend storing your key securely in environment variables:

export SONGSTATS_API_KEY=your_key_here

Available Resource Clients

• client.info
• client.tracks
• client.artists
• client.collaborators
• client.labels

Error Handling

import { SongstatsAPIError, SongstatsTransportError } from "songstats-node-sdk";

try {
  await client.tracks.info({ songstats_track_id: "invalid" });
} catch (error) {
  if (error instanceof SongstatsAPIError) {
    console.log(`API error: ${error.message}`);
  } else if (error instanceof SongstatsTransportError) {
    console.log(`Transport error: ${error.message}`);
  } else {
    throw error;
  }
}

Versioning

This SDK follows Semantic Versioning (SemVer).

License

MIT