Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.discovr.media/llms.txt

Use this file to discover all available pages before exploring further.

The Discovr SDKs provide a unified API across TypeScript, Kotlin, and Swift for building Netflix-style recommendation experiences.

​
Installation

npm install discovr

​
Quick Start

import { DiscovrClient } from 'discovr';

// Initialize the client
const client = new DiscovrClient('your-client-id', {
  basePath: 'https://api.discovr.media',
});

// Sign in with device code
const { userCode, qrCode, verificationUri } = await client.signInWithDeviceCode();
console.log('Enter code:', userCode);

// Wait for sign-in completion
for await (const state of await client.authStateStream) {
  if (state.signedIn) break;
}

// Select a profile
const profiles = await client.getProfiles();
await client.selectProfile(profiles.profiles[0].id);

// Create a page and fetch rows
const page = await client.createPage();
const rows = await client.getRows(page.id);
The SDK Reference tab provides detailed documentation for:
  • Authentication — Sign-in flows, session management, reactive state
  • Profiles — List, create, and manage user profiles
  • Profile Lists — Manage liked, disliked, watchlist, playback, and history
  • Scrobble — Record playback progress and skip events
  • Pages — Create and fetch recommendation pages
  • Rows — Fetch rows and row items for a page
  • Search — Full-text search for media and people
  • Media — Fetch media details, images, and recommendations
  • Misc — Profile images, GIF search, and other helpers