Exercise API
Query curated exercise records and serve the illustration attached to each one, silhouette-first.
The Exercise API supplies the exercise catalogue — each record carries the name, target muscles, required equipment, difficulty, posture, and the image addresses for its illustration. Records answer questions like “exercises for lats with a barbell” in one request.
curl 'https://api.gymassets.dev/v1/exercises?muscle=lats&equipment=barbell' \
-H "Authorization: Bearer $GA_SECRET_KEY"Operations
Render exercise art
Serve an exercise illustration frame, or its stand-in silhouette, from a stable URL.
List exercises
Page, search, and combine muscle, equipment, category, and artwork filters.
Get an exercise
Read one record with its muscles, equipment, and frame templates.
List exercise vocabularies
Discover every accepted filter value with record counts.
One record connects the products
The muscles object holds two arrays, primary and secondary, and they are the
two parameters a muscle diagram render
takes. The equipment array holds ids the Equipment API
resolves to records, artwork, and icons. The frames array carries ready image
templates for the exercise’s own illustration. Nothing needs mapping between them.
Illustrations are silhouette-first
Every exercise serves an image at a stable URL from the day it enters the catalogue. Where the drawing exists, the URL returns it. Where it does not yet, the URL returns a neutral silhouette of the figure and the response says so in a header. Finished artwork replaces the silhouette at the same address, with no change on your side. Render exercise art states the full contract.