Now that gyms are closed, I’m using Peloton more and I love how Peloton tracks . But I always found it difficult to browse through previous workouts with the user interface on the tablet on the bike. What if I wanted to see summary stats just for 20-minute classes? What are my personal records for a given time period? I know they exist on the app , but I just want one place to visualize and analyze the data that matters to me. everything somewhere I looked into how to get my Peloton data to do some custom sorting, filtering, and analysis. After a few weeks, I realized I could get updates to a Coda doc with all my Peloton stats. Read below to see how I was able to get these near-real-time stats synced to Coda. automated 👉 Go straight to the template and copy it. The template contains this write-up as well as the tables and views you need to analyze your own Peloton workout stats. Go to the Cycling page to see the cycling dashboard I’ve always wanted for myself. Use the Google Apps Script or Python script to start syncing your Peloton data (step-by-step instructions here ). Video tutorial below: See your workout stats on Peloton’s website You’ve probably used the Peloton website before to . Similar to the bike tablet, however, you have to click into each workout to see the stats for that individual workout: view your workouts If you click on the “Overview” and “Achievements” tabs, you’ll see some additional information about your workouts that might be useful. I just really wanted to see the stats associated with my bike rides, and those stats are “trapped” in each individual workout. You can’t see your output, calories, etc. over time. Download a CSV of your workout stats In the top right of the screenshot above, however, is a “Download Workouts” button. This lets you get a of all your workout data which is pretty sweet! This has most of the info I care about: CSV download Some of the columns include , , , and . This means you can start answering questions like: Length Type Total Output Avg. Watts - What was my max output for 45-minute classes? - What was the max average cadence for each instructor I’ve taken a class from? - How has my average output been trending over time? For many of you, this CSV should be enough for you to analyze your bike and non-bike workouts. You can throw this data into a spreadsheet (or a Coda doc 🙂), build some charts, and be on your merry way. Any time you want to get your most updated stats, just download the CSV and plug it into your spreadsheet or Coda doc. For me, I wanted to see and of updating my stats. I don’t want to download the CSV and copy and paste the data into Coda every time I finished a workout. additional stats automate the process Specifically, some questions I wanted to answer were: - Can I get stats like (based on ratings submitted by Peloton members), , and additional info about Peloton instructors? Difficulty Leaderboard Rank - How can I automate the process of getting my stats into a Coda doc downloading a CSV? without Playing with the unofficial Peloton API Turns out a few people have dabbled with the unofficial Peloton API. from Pat Litke is probably the most well-documented project. This library is great if you want to build a custom application on top of the Peloton API, but I wanted to find a way to simply get the data out from my Peloton account and into Coda. This one Turns out there are quite a variety of endpoints off of . You can get data about your Peloton account, instructors, and most importantly, your workouts. Here is a sample of data you can get about your account after authenticating with your username and password: https://api.onepeloton.com Some high-level data about your workouts: After some more searching, there’s an API explorer on showing the endpoints you can ping on the Peloton API. One of the more interesting endpoints is where you can get second-by-second metrics like output, resistance, and more: SwaggerHub all api/workout/{workoutId}/performance_graph With this data, you can build your own workout chart like the one you see on the bike tablet or on the website: So I know the data is there, I just need to figure out which metrics I want and the charts and I want to see. Picking the right Peloton workout metrics At the very least, I wanted to get the metrics you get from the CSV output. So those columns are a given. The additional metrics and stats I wanted to get include: - — And total leaderboard users too. Leaderboard rank - — a crowdsourced rating from 1–10 you give after a workout. Difficulty - — the total number of workouts others have done for this workout (gives you a sense of the popularity of the workout). Total workouts - — correlated with and is just interesting to see which workouts people provide ratings for. Total ratings Total workouts - — basically anything you can find on this . Instructor data Peloton instructors page There’s a whole plethora of metrics you can get from the API but these were the ones I wanted to see in addition to the properties from the CSV. You can see every metric I pull in from the page. All workouts Main cycling dashboard If you go to , you’ll see the main “dashboard” with the stats I wanted to see. Cycling You can get from the last 10 rides on the tablet or from the website, but it’s all in one place. Additionally, this list gets re-sorted every time new workouts get synced over from Peloton in . You can also filter the list by the length of the workout so that you are doing an apples-to-apples comparison. This is a nice condensed list to see how my workouts have been trending recently: All workouts View of 10 most recent workouts on the Cycling dashboard Below that 10 latest workouts table, I have a that just shows the best workouts I’ve had by Again, this is all data you can get from the CSV download, but the main difference is that this data gets updated automatically every hour, day, week, or whatever interval works for you. Personal Records table workout length . Personal records by workout length Finally, the charts below these tables show metrics over time so I can get a sense of how my performance have improved or declined over time. Key views of Peloton workout stats In sub-pages of the page, I sliced and diced my data based on different views I wanted to see my workouts. For instance, I’ve always wanted to see one view of my workouts and then . Seeing the dates when I reached a really high output encourages me to work harder to get back to that level of performance. You can see this view in . Cycling grouped by workout length sorted by output (kj) By length Another view I’ve always wanted to see is how my stats look . Maybe certain instructors are more encouraging and therefore lead me to better performance. That’s what the page allows me to see. Looks like I’ve taken quite a few classes with Matt Welpers 💪. grouped by instructor By instructor Finally two other views I thought would be interesting for cycling workouts are: - — See your workouts sorted by your position on the leaderboard. These are stats that you can’t get in the CSV, so it’s neat to see which rides I’ve performed the best in relative to all other Peloton members. By leaderboard rank - — While there is a calendar on the tablet and website, this view color-codes the events by . This means you can see other workout stats like running, strength, meditation, etc. Calendar workout type Two additional pages I set up to quickly sort and filter through Peloton data are: - — Filter across all different dimensions Filter Workouts — See the profiles for all your favorite instructors (this list also gets updated in the sync as new instructors are added) - Browse Instructors Syncing data in “real-time” from Peloton to Coda What good are these charts and tables if they don’t stay updated? Since we know the API exists, I wanted to find an for keeping the workout data in my Coda doc up to date with my workouts on Peloton. automated process Caveats about Peloton API As I mentioned earlier, the Peloton API is unofficial and undocumented. This means Peloton (the company) has not “blessed” the use of their API for the public, so the API could change at any time. This would essentially break the scripts I’ve written to sync data over from Peloton to Coda. Caveat #1: As with any API, you may use the API too aggressively and the fine folks at Peloton might rate-limit you. Don’t be the guy or gal who runs these scripts every thinking you need near-real-time updates. In reality, a sync would probably be sufficient for most of you out there. Long story short - be nice or else Peloton might block your use of their API 🚫. Caveat #2: minute daily Google Apps Script If you’ve come across my other , you’ve probably noticed I’m a big fan of . It’s a low-code, scalable, and most importantly, tool to connect your different tools together. Of course, Google makes it super easy to get data in and out of Google products, but you can set up workflows between non-Google tools as well. published docs Google Apps Script free The reason I think Google Apps Script is the right solution to sync your workout data from Peloton to Coda (as of the writing of this post) is because you can set up . These are basically the rules for how often you want the script to run. As I mentioned in the caveats above, I would highly recommend setting a as the highest frequency to run the Google Apps Script. time-driven triggers daily interval Authentication with Peloton This was probably the most difficult part of the script to figure out. In order to get your Peloton stats, you have to provide your username and password so that Peloton knows that you are, well, you! In the Google Apps Script, there is a that lets you fetch any URL and convert the response to a JSON object. This part of the authentication code allows you to “login” to Peloton by submitting an parameter that contains your Peloton login details: UrlFetchApp class options base_url = options = { : , : , : .stringify({ : PELOTON_USERNAME, : PELOTON_PASSWORD}), : }; login = UrlFetchApp.fetch(base_url + , options); var 'https://api.onepeloton.com' var 'method' 'post' 'contentType' 'application/json' 'payload' JSON 'username_or_email' 'password' 'muteHttpExceptions' true var '/auth/login' : We need to make various other calls to the API and those calls authenticated. Peloton won’t just give you workout data for anyone just because you know their Peloton username. This is where the cookie for the login session comes into play: The problem won’t be cookie = login.getAllHeaders()[ ]; var 'Set-Cookie' The returns all the header information from the HTTP response (which contains the cookie we need). We just store the relevant attribute in the variable. getAllHeaders() method cookie The cookie object returned from the headers looks like this: Another problem: [ , , ] "__cfduid=d88dc31d26154890903e4ed470ce2d2d31610584581; expires=Sat, 13-Feb-21 00:36:21 GMT; path=/; domain=.onepeloton.com; HttpOnly; SameSite=Lax" "peloton_session_id=57c891b1d8004745b7f19280a25af2cb; Domain=.onepeloton.com; HttpOnly; Max-Age=2592000; Path=/; SameSite=Lax; Secure; Version=1" "__cfruid=14a3728b6c055fbcd9384022acdfdf91f2ec912e-1610584582; path=/; domain=.onepeloton.com; HttpOnly; Secure; SameSite=None" There are all these expiration and domain attributes we don’t need. So, we just need the , , and as one long string, so this part of the authentication function creates that string for us: cfduid peloton_session_id cfruid ( i = ; i < cookie.length; i++) { cookie[i] = cookie[i].split( )[ ] } authenticated_options = { : { : cookie.join( )}} for var 0 ';' 0 var 'headers' 'Cookie' ';' Now we have this variable we can use it for all our subsequent calls with the API so that Peloton knows we are still “logged in” to our Peloton account. authenticated_options Getting existing Peloton workouts from Coda The first time you run the script, your workouts will get synced over to the table. To prevent unnecessary calls to the API, the script first pulls all the workout IDs from the table and compares them with the workout IDs returned from the API. We only look at the workouts that need to be synced over to Coda since previous workout data won’t change. all Workouts Workouts new Remember the endpoint I mentioned earlier? Turns out that returns a of data, so we want to make sure we ping this endpoint . This ensures we don’t pull performance graph data from Peloton we don’t need to and gives the Peloton API a break. api/workout/{workoutId}/performance_graph ton only if we have to You can get workout data from the endpoint the endpoint. You would think that the most detailed stats would be in the “performance graph,” but it turns out there is some data in like leaderboard stats. So I created a object that contains “summary” and “performance” metrics. api/workout/{workoutId}/performance_graph and api/workout/{workoutId} api/workout/{workoutId} workoutData Once we have all the relevant columns, we just format the data in a way that the needs and push that data to the table. Coda API Workouts Python script The works pretty much the same way as the , without the added benefit of being able to schedule the script to run at some interval in an easy way. Authentication, however, was much easier to accomplish with the Python script. Python script Google Apps Script By importing the requests , you get a user-friendly way to manage the logged-in session on Peloton. For instance, with these four lines of code, we can authenticate with Peloton so that for future calls to the API, we just need to use with various parameters: library s.get() s = requests.Session() base_url = payload = { : peloton_username, : peloton_pw} s.post(base_url + , json=payload) 'https://api.onepeloton.com' 'username_or_email' 'password' '/auth/login' There’s no messing around with cookies 🍪, it just works. Deploying a serverless function on Google Cloud You could run the script on your local machine or on some public cloud platform. The tradeoff for having a more difficult method for how often the script runs is the with where/how you run the script. automating flexibility Serverless functions were all the rage the last few years so I thought I’d try it out and see if I could spin up an example on Google Cloud Platform. get a URL that we can ping to trigger the Python script to run. The goal: Setting up Google Cloud Just setting up Google Cloud to get one Cloud Function to run was a bit of a pain. In addition to setting up a billing account (requires a credit card) and tying a project to a billing account, you need to enable the and APIs (two services we need) to even start using Cloud Functions: Cloud Functions Cloud Scheduler A helpful I came across from a developer advocate at Google Cloud is this one. It’s a little harder to use since the blog post assumes you are using the command line tool. Nonetheless, Dustin creates a pattern for running the function that I wouldn’t have otherwise figured out (via Cloud Scheduler). blog post gcloud Setting up the Cloud Function Once you start creating a Cloud Function, the key settings are to set the trigger type to “HTTP” and “Allow unauthenticated invocations.” I didn’t want to mess with IAM policies and all that stuff, so this should be fine for our needs: Once you’re in the source code editor, you just need to set the runtime to “Python 3.7” and rename the to something like . Then you can copy over the to the code editor. Entry point runPelotonSync Python script In order for this script to work with Cloud Functions, however, you have to wrap the script inside a function like this. Almost all the code goes into the function: pelotonData(request) After that, hit and wait for Google Cloud to deploy your function. If everything works out correctly, you’ll get a unique “Trigger URL” on the “Trigger” tab of your Cloud Function: Deploy Get your Cloud Function to run every day Unlike Google Apps Script where you can simply tell Google how often you want your script to run on a dropdown menu, we have tell Google Cloud how often the python script should run via cron rules. We can set up the interval for calling the URL we got from our Cloud Function by using Google Cloud Scheduler. The key field to fill out when you set up a new Cloud Scheduler job is the . This is the you got from your Cloud Function: URL Trigger URL The is where you need the indicate the cron rules for how often you want Cloud Scheduler to ping the URL. In the above screenshot, this job would run every minute. A helpful site to figure out what characters you should put for the cron rule is . Once this is all set up, you can get detailed logging on your job and see manually run the job from the main Cloud Scheduler interface: Frequency https://crontab.guru/ Final notes I’m still playing around with this template for visualizing my Peloton stats and with the data that gets returned from the Peloton API. If you have any suggestions or see mistakes with the scripts, feel free to submit a PR . here Hope these stats encourage you to hit new PRs whether your cycling, running, or doing a strength exercise. Train hard, train smart, and have fun! — Matt Welpers
