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.

Record or update playback progress for a media item. Creates a playback entry if it does not exist. Updates history with the current progress. If progress is 80% or higher, the item is marked as completed. Watchlist Auto-Removal:
  • Movies: Automatically removed from watchlist when progress > 20%
  • TV Shows: Automatically removed from watchlist when episode progress >= 80% (complete)
Completion Behavior:
  • When progress >= 80%, the item is marked as completed and removed from the playback queue

​
Parameters

NameTypeRequiredDescription
mediaIdstringYesThe media ID with prefix (MV_TMDBID for movies, TV_TMDBID for TV shows)
progressnumberYesPlayback progress percentage
tvScrobbleTvNo
{
  "season": 0,
  "episode": 0
}

​
Returns

ScrobbleResponse — Scrobble progress recorded 
{
  "status": "string",
  "progress": 0.0,
  "completed": false
}

​
Example

import { DiscovrClient } from "discovr";
import type { ScrobbleProgressBody, ScrobbleResponse, ScrobbleTv } from "discovr";

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

// After sign-in and profile selection …
const response: ScrobbleResponse = await discovr.scrobble("TV_TMDBID1396", 42.5, { tv: { "season": 2, "episode": 5 } });
console.log(response);