@spotify/web-api-ts-sdk/src/endpoints/BrowseEndpoints.ts

A typescript SDK for the Spotify Web API

import type { CountryCodeA2, MaxInt, Categories, Category, NewReleases, FeaturedPlaylists } from '../types.js';
import EndpointsBase from './EndpointsBase.js';

export default class BrowseEndpoints extends EndpointsBase {

    public getCategories(country?: CountryCodeA2, locale?: string, limit?: MaxInt<50>, offset?: number) {
        const params = this.paramsFor({ country, locale, limit, offset });

        return this.getRequest<Categories>(`browse/categories${params}`);
    }

    public getCategory(categoryId: string, country?: CountryCodeA2, locale?: string) {
        const params = this.paramsFor({ country, locale });

        return this.getRequest<Category>(`browse/categories/${categoryId}${params}`);
    }

    public getNewReleases(country?: string, limit?: MaxInt<50>, offset?: number) {
        const params = this.paramsFor({ country, limit, offset });
        return this.getRequest<NewReleases>(`browse/new-releases${params}`);
    }

    public getFeaturedPlaylists(country?: CountryCodeA2, locale?: string, timestamp?: string, limit?: MaxInt<50>, offset?: number) {
        const params = this.paramsFor({ country, locale, timestamp, limit, offset });
        return this.getRequest<FeaturedPlaylists>(`browse/featured-playlists${params}`);
    }

    public getPlaylistsForCategory(category_id: string, country?: CountryCodeA2, limit?: MaxInt<50>, offset?: number) {
        const params = this.paramsFor({ country, limit, offset });
        return this.getRequest<FeaturedPlaylists>(`browse/categories/${category_id}/playlists${params}`);
    }
}