DSFlix SDK (dsflix-sdk-npm )

Official JavaScript/TypeScript SDK for the DSFlix Streaming API — 2026

What is DSFlix SDK?

The DSFlix SDK (dsflix-sdk) is the official client library for the DSFlix / DawensFlix streaming platform API. It lets you integrate movies, TV shows, AI chat, user coins, membership, music, and news into any JavaScript or TypeScript application — in minutes.

Features

• 🎬 Movies – Popular, trending, top-rated, now playing, upcoming, details, cast
• 📺 TV Shows – Series, seasons, episodes, credits
• 🔍 Search – Multi-search across movies and TV
• 🤖 AI Chat – Conversational movie/streaming assistant
• 🪙 Coins – Balance, transfer, convert, transaction history
• 👤 User – Profile, watchlist, watch history, notifications, referrals
• 🎵 Music – Trending tracks, search
• 📰 News – Top headlines, search
• 🏆 Membership – Plans, status, upgrade
• ⚡ TypeScript-first – Full type definitions included

Installation

npm install dsflix-sdk

yarn add dsflix-sdk

pnpm add dsflix-sdk

Quick Start

import { DsfClient } from 'dsflix-sdk';

// Initialize with your API key
const dsf = new DsfClient({ apiKey: 'dfx-your-api-key-here' });

// Get popular movies
const movies = await dsf.movies.getPopular();
console.log(movies.results);

// Search for a movie
const results = await dsf.search.multi('Inception');
console.log(results.results);

// Get user profile (requires auth)
const profile = await dsf.user.getProfile();
console.log(profile.username, profile.coins);

// Chat with AI
const reply = await dsf.ai.chat('Recommend me a good thriller movie');
console.log(reply.reply);

Configuration

import { DsfClient } from 'dsflix-sdk';

const dsf = new DsfClient({
  apiKey: 'dfx-your-api-key',         // Required
  baseUrl: 'https://api.dawensflix.com', // Optional (default)
  timeout: 10000,                        // Optional (ms, default 10000)
  language: 'en-US',                     // Optional (default 'en-US')
});

API Reference

Movies

dsf.movies.getPopular(options?)
dsf.movies.getTrending(timeWindow)      // 'day' | 'week'
dsf.movies.getTopRated(options?)
dsf.movies.getNowPlaying(options?)
dsf.movies.getUpcoming(options?)
dsf.movies.getDetails(movieId, options?)
dsf.movies.getCast(movieId)
dsf.movies.search(query, options?)
dsf.movies.download(params)

TV Shows

dsf.tv.getPopular(options?)
dsf.tv.getDetails(seriesId, options?)
dsf.tv.getSeason(seriesId, seasonNumber)
dsf.tv.getEpisode(seriesId, seasonNumber, episodeNumber)
dsf.tv.getCredits(seriesId, seasonNumber)
dsf.tv.getCast(seriesId)
dsf.tv.search(query, options?)

Search

dsf.search.multi(query, options?)
dsf.search.movies(query, options?)
dsf.search.tv(query, options?)

AI

dsf.ai.chat(message, context?)

User

dsf.user.getProfile()
dsf.user.getById(displayId)
dsf.user.getWatchlist()
dsf.user.addToWatchlist(mediaType, mediaId)
dsf.user.removeFromWatchlist(mediaId)
dsf.user.getWatchHistory(options?)
dsf.user.getLanguage()
dsf.user.updateLanguage(languageCode)
dsf.user.getWallet()
dsf.user.getReferral()
dsf.user.getNotifications(options?)
dsf.user.uploadPhoto(file)

Coins

dsf.coins.getBalance()
dsf.coins.transfer(recipientDisplayId, amount, note?)
dsf.coins.convert(rewardCoins)
dsf.coins.getTransactions(options?)

Membership

dsf.membership.getPlans()
dsf.membership.getStatus()
dsf.membership.upgrade(plan, durationDays, paymentMethod?)

Music

dsf.music.getTrending(options?)
dsf.music.search(query, options?)

News

dsf.news.getTop(options?)
dsf.news.search(query, options?)

Home

dsf.home.getHero(language?)
dsf.home.getSections(options?)
dsf.home.getSplash()
dsf.home.getFeatured(options?)

Error Handling

import { DsfClient, DsfError } from 'dsflix-sdk';

const dsf = new DsfClient({ apiKey: 'dfx-...' });

try {
  const movies = await dsf.movies.getPopular();
} catch (err) {
  if (err instanceof DsfError) {
    console.error(`DSFlix API Error [${err.statusCode}]: ${err.message}`);
  } else {
    throw err;
  }
}

Authentication

Get your API key from dawensflix.com/api-dashboard.

All API keys follow the format: dfx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Documentation

Full documentation with 26 pages is available in the /docs folder:

| Page | Description | |------|-------------| | Getting Started | Installation & first request | | Authentication | API keys & headers | | Configuration | All config options | | Movies | Movie endpoints | | TV Shows | TV series, seasons, episodes | | Search | Multi-search | | Streaming | Stream URLs | | AI Chat | AI assistant | | Coins | Coin system | | User | User profile & data | | Music | Music API | | News | News headlines | | Membership | Plans & upgrades | | Error Handling | Error types & codes | | Examples | Real-world usage examples | | Changelog | Version history | | Contributing | How to contribute |

Requirements

• Node.js 16+
• An active DSFlix API key (dfx-...)

License

MIT © DSFlix Team

Links

• 🌐 Website: dawensflix.com
• 📖 API Docs: dawensflix.com/docs
• 🔑 Get API Key: dawensflix.com/api-dashboard
• 🐛 Issues: https://github.com/dawiniefleury00-star/dsflix-developer-sdk/issues