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/exercises

    Public-domain exercises with step-by-step instructions, muscle groups, equipment and a photo.

    Licence: Unlicense

  • Programmes and workouts

    /api/v1/programs

    Training programmes written for Massimino, each with its sessions and the exercises in them.

    Licence: Apache-2.0

  • Teams

    /api/v1/teams

    Public training teams: name, description and size. Never members or contact details.

    Licence: Not for reuse

  • Fitness Intelligence

    /api/v1/fitness-intelligence/countries

    Eurostat 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=2
curl "https://massimino.fitness/api/v1/exercises?q=squat&page_size=2"
Run the request to see the response.

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

01

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.

02

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.

03

One error shape

Every error has a status and a reason, such as EXERCISE_NOT_FOUND. Match on those, not on the message.

04

Stable by design

Within version 1, fields are added and never renamed or removed. Resource names stay valid for good.