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.

A profile represents one viewer on an account—each profile has its own lists (watch history, likes, playback, etc.) and feeds into personalized recommendations when you browse pages and rows. The layout below is only an example; your picker can look different while using the same APIs.
Light theme profile picker: grid or row of profile tiles with names and avatars plus an add-profile entry; illustrates who’s-watching before session-tier browse.

​
Why profiles matter

  • After sign-in — The SDK keeps a refresh token for account operations (listing and managing profiles via /profiles).
  • One active profile — When you call selectProfile(), the SDK creates a session for that profile. All browsing calls (pages, rows, personalized recommendations) use that session. Each profile’s recommendations and analytics are separate.
  • Household UX — The same Discovr user can switch profiles so each family member keeps separate taste and playback state without separate accounts.
  • avatarUrl — You store whatever HTTPS URL you choose for each profile picture. That URL may point at a raster image (PNG, WebP, etc.) or MP4 (for example looping video from GIF search APIs). Discovr does not transcode assets for you—your app must render whatever URL you persist (image decode vs <video> / platform video view). Convenience options: curated defaults (getProfileImages()) or Tenor-backed search (searchGifs()); see Managing profiles.
For token lifetimes, session refresh, and onSessionRefreshed, see Sessions, Profiles & Sign Out—this hub focuses on profiles as a product concept and UI-oriented SDK usage.

​
What you typically build

A picker (list + selectProfile()) and CRUD screens for profile data. Start with either guide:

Listing and selecting profiles

Use getProfiles() for your picker UI, call selectProfile, and gate session-tier calls.

Managing profiles

Create, read, update, delete—avatars as image or MP4 URLs, helpers for defaults and GIF search.

Profile context

Playback, lists, title overlays (getMediaProfileMeta), and scrobbling after selection
Next: Listing and selecting profiles, Managing profiles, or Profile context.