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.

​
Welcome to the Discovr API

The Discovr API provides endpoints for media discovery, profile-scoped lists, pages and rows, and authentication. New integrations should start with Authentication (sign-in flows) and the Quick Start.

Quick Start

Minimal curl-oriented path to your first calls

Authentication

Sign-in flows, profile selection, and SDK examples (TS / Kotlin / Swift)

Pages

Hero, rows, stack navigation depth, and default browse tabs

Rows

Media, top_n, navigation, and provider rails—how items map to UI

Media details

Title metadata, images, seasons/episodes, similar recommendations

Profile context

Lists, resume queue, overlays, scrobbling on /profile/* after selectProfile

API Reference

Browse operations in the reference

Type reference

Shared wire shapes for browsing, profiles, and auth state

​
What is the Discovr API?

The Discovr API helps you build apps that browse personalized rows of media, manage multiple profiles per account, and keep lists (likes, watchlist, history, playback, and more under /profile/*).

​
Key features

Two-credential auth

Identity credential for account operations (sign-in, profile management); session credential for browsing and profile data. SDK handles both automatically — see Authentication.

REST design

Resource-oriented HTTP API documented in OpenAPI.

Official SDKs

TypeScript, Kotlin, and Swift generators from the same OpenAPI spec.

Local emulators

Run Firebase emulators and point clients at your local Functions / hosting URL. Use real sign-in (device code or web flow) plus emulator seed users and Client ID—same model as production.

​
Getting started

  1. Get a Client ID for your app.
  2. Read Authentication for sign-in and profile selection.
  3. Follow Quick Start for curl examples against https://api.discovr.media.
  4. Use API Reference for every operation.
New to the API? Start with Quick Start, then dive into Authentication for SDK-based flows.

​
Next steps

Quick Start

First requests with curl

Authentication

Full auth guide with tri-language SDK samples

Pages

Browse model: hero, rows, and stacked navigation depth

Rows

Rail types, pagination, and item shapes (media vs navigation vs provider)

Media details

Open a title: getMedia, images, season details, similar recommendations

Profile context

Playback, lists, overlays, scrobbling—what changes per viewer after profile selection

API Reference

Explore endpoints

​
Need help?