Soundcloud-api-client NPM

soundcloud-api-client

Node.js module for the SoundCloud API. See full API documentation here.

Getting Started

In order to use the module, you need to acquire a client_id for your application, which can be obtained from SoundCloud for Developers page.

Installation

This library can be installed through npm:

$ npm install --save soundcloud-api-client

Usage

The following example shows how to initialize the library and perform a search request with sample criteria.

const SoundCloud = require('soundcloud-api-client');

const client_id = 'your-client-id';
const soundcloud = new SoundCloud({ client_id });

const q = 'live mix';
const genres = [ 'house', 'tech-house', 'techno' ].join(',');

soundcloud.get('/tracks', { q, genres })
    .then(tracks => /* process tracks */)
    .catch(e => /* handle error */);

The next example demonstrates how to fetch 10 most recent user comments.

const user = 'user-name-or-id'; // user id is necessary to fetch user tracks
const offset = 0;
const limit = 10;

soundcloud.get(`/users/${user}/comments`, { offset, limit })
    .then(comments => /* process comments */)
    .catch(e => /* handle error */);