VideoCatalogService is the OSN+ side of the SDK. Read-only, idempotent, cacheable. Live linear TV is not included — the public SDK is video-on-demand only.
Entities
Operations
Authentication
Public catalog data is accessible with either an API key or an OAuth access token. Acquiring a stream for an episode or movie requires OAuth + thestream scope. See Streaming & Billing.
Batch patterns
When rendering a “browse” or “search” surface that returns mixed video items, fetch full details with the appropriateBatchGet*. As with music, batches succeed and fail per-item — see Errors / Batch errors.
Season pagination
Long-running shows have many episodes.GetSeason paginates the episode list with the standard cursor scheme — provide page_token from the previous response to continue. See Pagination.
Localization
Show, season, episode, and movie titles and descriptions useLocalized where multiple languages are available. Pick the value matching your client’s locale, falling back to a sensible default (typically en or the first available).
Related
- Soundtrack — discover the songs in a show or movie.
- Library — saved shows/movies.
- Streaming & Billing —
AcquireVideoStream.