Exercise API

The Your Move Exercise API is an exercise database API with 2,005+ exercises and 2,600+ HD videos, filmed with trainers and physiotherapists. No AI-generated clips, no GIFs. Every exercise ships with an HD video (HLS + MP4), thumbnails, step-by-step instructions and primary and secondary muscle data, across 15 muscle groups and 37 equipment types.

On the same key: workout generation, multi-week training programs and AI posture analysis.

Docs: ymove.app/exercise-api/docs
OpenAPI spec: exercise-api.ymove.app/api/v2/openapi.json
Get an API key: ymove.app/exercise-api (trial key in minutes)

Quickstart

1. REST

Base URL: https://exercise-api.ymove.app/api/v2. Send your key in the X-API-Key header.

curl -H "X-API-Key: your_api_key" \
  "https://exercise-api.ymove.app/api/v2/exercises?muscleGroup=chest&equipment=dumbbell&pageSize=5"

2. TypeScript SDK

npm install ymove-exercise-api

import { YMoveClient } from 'ymove-exercise-api';

const ymove = new YMoveClient('your_api_key');

const { data: exercises } = await ymove.exercises.list({ muscleGroup: 'chest', equipment: 'dumbbell' });
const workout = await ymove.workouts.generate({ muscleGroup: 'chest', difficulty: 'intermediate', exerciseCount: 6 });
const program = await ymove.programs.generate({ goal: 'muscle_building', daysPerWeek: 4, weeks: 4 });

Repo: ymove-app/exercise-api-sdk | npm: ymove-exercise-api

3. MCP server (Claude, Cursor and other AI tools)

Hosted, no install:

claude mcp add --transport http ymove https://exercise-api.ymove.app/mcp --header "X-API-Key: your_api_key"

Or run it locally with npx:

claude mcp add ymove -e YMOVE_API_KEY=your_api_key -- npx ymove-exercise-mcp

Tools: search_exercises, get_exercise, generate_workout, generate_program, list_muscle_groups, list_exercise_types.

Repo with Cursor and Claude Desktop config: ymove-app/exercise-api-mcp | npm: ymove-exercise-mcp

Endpoints

Method	Endpoint	What it does
GET	`/exercises`	List and search exercises (muscle group, equipment, difficulty, type, text search)
GET	`/exercises/{id}`	One exercise by ID or slug, with video URLs, thumbnails, instructions and muscles
GET	`/exercises/muscle-groups`	Muscle groups with exercise counts
GET	`/exercises/equipment`	Equipment types with exercise counts
GET	`/exercises/{id}/body-map`	Muscles worked, as an SVG image
GET	`/workouts/generate`	A structured workout with sets, reps and rest
GET	`/programs/generate`	A multi-week training program
POST	`/posture/analyze`	AI form analysis from an exercise video
GET	`/usage`	Your usage and limits

Full reference with parameters and response examples: ymove.app/exercise-api/docs.

Exercise library

Top 100 exercises: the exercises developers request most, with portrait thumbnails and body maps.
Full exercise list: every exercise, grouped by muscle group.
Body maps: an SVG of the muscles worked for every exercise (dark = primary, light = secondary), the same drawing as the /exercises/{id}/body-map endpoint.

25 free exercise videos

Royalty-free HD exercise videos (MP4, 720p, portrait) in free-videos/, free for commercial use. Same set as ymove.app/free-exercise-videos; license in free-videos/README.md. Click a thumbnail for the MP4.

_{Barbell Back Squat Quads · Barbell}	_{Barbell Bench Press Chest · Barbell}	_{Barbell Deadlift Full body · Barbell}	_{Dumbbell Lateral Raise Shoulders · Dumbbell}	_{Hammer Curls Biceps · Dumbbell}
_{Single Arm Dumbbell Row - Legs apart Back · Dumbbell}	_{Dumbbell Goblet Squat Quads · Dumbbell}	_{Kettlebell swing Core · Kettlebell}	_{Kettlebell Push Press Shoulders · Kettlebell}	_{Kettlebell Romanian Deadlift Hamstrings · Kettlebell}
_{Goblet Squat with Kettlebell Quads · Kettlebell}	_{Cable Crossover (Mid) Chest · Cable}	_{Lying Cable Leg Curl Hamstrings · Cable}	_{Cable Woodchop (High to Low) Core · Cable}	_{Lat Pulldown Back · Cable}
_{Seated Cable Row close V bar Back · Cable}	_{Seated Machine Chest Press Chest · Machine}	_{Cable Lateral Raise Shoulders · Cable}	_{Cable Rope Face Pull Shoulders · Cable}	_{Cable Bicep Curl rope Biceps · Cable}
_{Cable Tricep Pushdown Triceps · Cable}	_{Overhead Cable Rope Extension Triceps · Cable}	_{Leg Extension Quads · Machine}	_{Leg Press Quads · Machine}	_{Glute Kickback Machine Glutes · Machine}