Implementation FAQs

Modified on Fri, 1 Nov at 4:40 AM

TABLE OF CONTENTS

Content
Access
Content Portal
Downloads
- Can I download videos?
- How can I download videos?
Streaming

Content

What content is provided by Content Platform?

Content Platform provides royalty-free video content produced by LesMills as well as supporting metadata and files.

How frequent are content updates?

LesMills Content is released on a quarterly basis, making up to 4 signature releases available at all times.

What happens to my Collections or Programs playlists during quarterly content updates?

Collections and Programs playlists automatically update when new videos are added or old ones are removed, with no manual intervention needed. There's no need to re-embed web codes or modify your API integration—content updates will display for end users upon a page refresh.

How do quarterly updates affect my Releases playlists?

Each quarterly Release requires a unique embed code or API call. To display the latest Release, you’ll need to refresh the embed code snippet or API call each quarter to replace the previous version with the new one.

How do quarterly content updates impact my Custom playlists?

If content in a Custom playlist expires, it will no longer be accessible in the playlist. However, a cached version may still appear for users until they refresh the page. You can make updates, including reordering, editing, or adding videos via the Content Portal Dashboard. These changes will automatically reflect for end users without needing to replace the embed code.

How can I get supporting files like closed captions and PDF materials?

Closed captions, metadata, and PDF materials are available on the video detail pages in the Content Portal. You can either download these files or copy them individually as needed.

Access

How do I get access to Content Portal?

Please contact the Les Mills CX team. Once your account is set up, you will receive access details via email.

How do I get access to an API?

Content Platform provides APIs via two endpoints:

cms.content.lesmills.com
1. provides access to content metadata, user info, and downloads from our CMS
2. authentication requires API Token that can be copied from Content Portal menu.
api.content.lesmills.com
1. provides access to streaming URL generation, as well as download from our video-on-demand solution
2. authentication requires DirectusUserid that can be copied from any of the embed codes in the Content Portal

Detailed API documentation including endpoints and sample requests and responses can be found at https://api.content.lesmills.com/docs/.

We can also provide Postman collection file with API requests and authentication samples that can be shared, upon request.

How do I get access to Downloads?

Video-on-demand streaming is the standard method, utilizing Les Mills infrastructure and eliminating the need for your own storage. If download access is required, it can be provided on a case-by-case basis. Please contact your Les Mills representative to request it.

How do I manage access permissions to content for my users?

Access to the Content Portal and API tokens is granted to each Les Mills client individually. You are responsible for managing access permissions for your users within your own solution, website, or web application. The Content Portal does not include a permission management system for users who are not direct Les Mills customers.

Content Portal

What is Content Portal?

Content Portal - is a web application available on https://portal.content.lesmills.com/ , where clubs and partners can:

Search and Browse content
Play Videos
Manage Playlists
View Content Metadata
Get embed codes for integration
Get API Token
View Usage Analytics (future functionality)

Content Portal is designed for B2B clients. Streaming URLs and embed codes are intended for integration into clients' distribution platforms, applications, or content management systems to deliver content to their end users.

How do playlists work?

LesMills offers two types of playlists: curated playlists (including Collections, Programs, or Releases) and "Your Playlist," where you can create your own. To create a custom playlist in the Content Portal, go to Menu > Your Playlists > Create, and fill in the required information. While browsing videos, you can easily add them to your playlist.

What is Content API?

Content API - is an application programming interface that provides a set of endpoints for accessing content, metadata, user info, generating streaming URLs and more. It includes:

Videos
Releases
Categories
Programs
User info
Instructors
Equipment
Download and Streaming URLs

Content Platform provides APIs via two endpoints:

cms.content.lesmills.com - authentication requires API Token that can be copied from Content Portal menu.
api.content.lesmills.com - authentication requires DirectusUserid that can be copied from any of the embed codes in the Content Portal.

Detailed API documentation including endpoints and sample requests and responses can be found at https://api.content.lesmills.com/docs/.
We also provide Postman collection file with API requests and authentication samples that can be shared on request.

Can I query the API from an end-user application?

Les Mills Content APIs are designed for B2B services to distribute content to end users. Direct API calls from end-user applications are considered excessive use and may result in API access termination.

What is the API rate limit?

There is an exception for generating a Signed Streaming URL, which can be called on a per-user request basis via this endpoint: https://api.content.lesmills.com/v0/public/asset/video/metadata. While these requests are typically proxied through your infrastructure, the endpoint can handle high traffic loads.

Where can I find the API Token?

To locate and copy your API Token, go to the Content Portal menu. Click on Account > API Token; the token will be automatically copied to your clipboard.

Where can I find the Directus User ID?

There are a couple of ways to get your Directus User id:

API call to https://cms.content.lesmills.com/users/me , where “data.id” is your Directus User id.
DirectusUserid can be copied from any of the embed codes in the Content Portal.

Can I download videos using an API?

Yes. There are two endpoints provided for that - you can choose either API to use.

https://api.content.lesmills.com/v0/file/download - downloads file from Mux
https://cms.content.lesmills.com/assets/{id} - downloads file from CMS

Please refer to API documentation for additional details: https://api.content.lesmills.com/docs/

Downloads

Video-on-demand streaming is the standard delivery method, utilizing Les Mills infrastructure and eliminating the need for your own storage. If download access is required, it can be provided on a case-by-case basis. Please contact your Les Mills representative to request it

Can I download videos?

Yes, the download option can be enabled for your account, either directly through the Content Portal or programmatically via the APIs. To request download access, please consult your Les Mills representative, as this is granted on a case-by-case basis.

How can I download videos?

Downloads can be made using both Content Portal and APIs.

For Content Portal downloads - select a video and click on Options > Download Video File.
For API details - please refer to API documentation: https://api.content.lesmills.com/docs/.

Streaming

Video-On-Demand Streaming - is a capability served by LM Content Platform infrastructure that allows customers to serve video content to users using a web player of their choice and video stream (HLS) backed by Content Platform.

Streaming capability can be used by:

Copying video embed codes from Content Portal
Requesting Signed Streaming URL from Content API

How does streaming work?

LesMills provides video-on-demand streaming as a service by hosting the videos and sharing signed streaming URLs upon request. HLS streaming is managed for your applications.

Please note that signed streaming URLs have a time-to-live (TTL) of 24 hours.

What is a Streaming URL?

Streaming URL - is a url generated for the B2B client that can be used in any web player, enabling users to watch video by streaming it from Content Platform infrastructure.

How can I use streaming?

You can request a signed streaming URL from our API and run it in any web player that supports HLS. Typically this would be done on-demand, when customer is clicking on a video in an application.

Note that signed streaming URLs have TTL(time to live) period of 24 hours.

How do I get a signed streaming URL?

Signed streaming URL can be generated by making an API call to https://api.content.lesmills.com/v0/public/asset/video/metadata endpoint.
Please refer to API documentation for details: https://api.content.lesmills.com/docs/.

Does Streaming URL expire after some time?

Yes, streaming URLs will expire in 24 hours.

What video player options are available to use with the Streaming URLs?

You can choose to use any compatible HLS video player in your experience, we recommend the Mux HLS video player. You can find the specs for that video player here (Mux Player | Mux).

What are the standard video specs?

All videos are streamed as M3U8s

Resolutions supported are: 270p,480p, 720p, 1080p
1. Transcoding support resolution output to meet your experience requirements. This will happen automatically and depend on the HLS video player you choose to use.
30fps
H.264 codex

What is an embed code?

Embed code - is a code clients can copy and paste into their web pages. It contains a script that will request a signed streaming URL via an API call to Content Platform and a player provided to the end user.

How can embed codes be used?

When building a web experience, clients can use one embed code per page. We suggest creating a main page with a full list of programs. Movers can then select their program of choice, leading them to a landing page with an embedded player featuring the full playlist for this chosen program. The Content Portal features curated playlists by program, collections and releases while also offering custom built playlists with any combination of videos in the Platform.