Massimino API · version 1
Open fitness data to build on
Massimino is open source, and so is its data. Read exercises, programmes, public teams and Eurostat fitness figures over a plain JSON API. No sign-up, no key, read-only.
curl "https://massimino.fitness/api/v1/exercises?q=squat&page_size=2"
What it serves
Four collections
Exercises
/api/v1/exercisesPublic-domain exercises with step-by-step instructions, muscle groups, equipment and a photo.
Licence: Unlicense
Programmes and workouts
/api/v1/programsTraining programmes written for Massimino, each with its sessions and the exercises in them.
Licence: Apache-2.0
Teams
/api/v1/teamsPublic training teams: name, description and size. Never members or contact details.
Licence: Not for reuse
Fitness Intelligence
/api/v1/fitness-intelligence/countriesEurostat figures on physical activity and sport employment, by country.
Licence: CC-BY-4.0
Workout logs are personal, so they are not open data. You can read your own log at /api/v1/me/workout-sets and /api/v1/me/workout-sessions with a key you created with the workout log permission. It only ever returns the sessions of the account that owns the key.
Console
Run a request
These are real calls to the live API, counted against your rate limit like any other.
Public-domain exercises with instructions.
Text to find in the title.
A muscle group.
A piece of equipment.
beginner, intermediate or advanced.
Items per page, up to 100.
next_page_token from the previous response.
Stays in this page. It is sent only with the requests you run here.
Your API keys
The API works without a key. For the higher limit, sign in and create a free key here.
GET/api/v1/exercises?q=squat&page_size=2curl "https://massimino.fitness/api/v1/exercises?q=squat&page_size=2"
Every resource
The same core fields
- name
- The resource name, for example exercises/7d0f… It never changes.
- uid
- The identifier on its own.
- title
- A label a person can read.
- body_txt
- All the text of the resource, as plain text.
- body_html
- The same text as escaped HTML, safe to put in a page.
- create_time
- When the record was created.
- update_time
- When it last changed.
- source, license
- Where it comes from and whether you may reuse it.
How it behaves
Four rules
No key needed
About 60 requests a minute without a key, about 600 with a free one. Limits are counted per server, so treat them as approximate.
Every list is paged
25 items by default, 100 at most. Send next_page_token back as page_token; an empty token means you have everything.
One error shape
Every error has a status and a reason, such as EXERCISE_NOT_FOUND. Match on those, not on the message.
Stable by design
Within version 1, fields are added and never renamed or removed. Resource names stay valid for good.