Developer Infrastructure

EVERY EXERCISE.
One API.

The exercise API with 1,900+ exercises in 720p video.
REST, plus MCP for AI agents.

WorkoutX is a free exercise API and workout API for developers building health, fitness, and AI-powered experiences. Access the most comprehensive exercise database API, Body Scan API, and AI Workout Generator.

🌍 Multi-language: EN · TR · DE · ES · FR · 中文(简体)· 中文(繁體)
Issue №02 · v2
1,900+ EXERCISES × 720P VIDEO ANIMATIONS × MALE & FEMALE MODELS × MUSCLE TARGETING × REST API × 7 LANGUAGES × 1,900+ EXERCISES × 720P VIDEO ANIMATIONS × MALE & FEMALE MODELS × MUSCLE TARGETING × REST API × 7 LANGUAGES
© 2026
1,900+
Exercises
2,700+
720p Video Clips
18
Target Muscles
7
Languages
WORKOUTX v2

Every exercise. Two models, in 720p.

1,900+ exercises as professionally produced 3D animations, with a male and a female model. These clips are exactly what your app receives from the API.

Male model88 KB
Female model80 KB
MP4 · 600 × 720 · 30 fps
Format
MP4 (H.264), plays natively on iOS, Android and the web
Quality
600 × 720, 30 frames per second, seamless loops
File size
Typically 100–300 KB per clip, with a JPEG poster
Models
Male and female, for 840+ exercises
Library
1,900+ exercises, 2,700+ clips, with muscles, equipment, instructions and form tips
Delivery
Streamed from our CDN through expiring links: store the exercise ID, not the media URL

Already on v1? Your integration keeps working, your API key works on v2 too, and the migration guide maps the exercise IDs you have stored.

01 / SEE WHAT YOU GET

VIDEO. JSON. Done.

In v2, every exercise ships with a looping 720p video, primary and secondary muscles, equipment, difficulty, step-by-step instructions and form tips, all in a single API call.

Browse all exercises →
ex_XXOOG7
Barbell Deadlift
GET /v2/exercises/ex_XXOOG7
v2
{
  "id": "ex_XXOOG7",
  "name": "Barbell Deadlift",
  "model": "female",
  "bodyPart": "Upper Legs",
  "target": "Glutes",
  "equipment": "Barbell",
  "primaryMuscles": [
    { "group": "Glutes", "anatomical": ["gluteus maximus", …] },
    { "group": "Hamstrings", "anatomical": ["Biceps Femoris", …] }, …
  ],
  "secondaryMuscles": [
    { "group": "Lower Back", "anatomical": ["Erector Spinae"] }, …
  ],
  "difficulty": "intermediate",
  "mechanic": "compound",
  "force": "pull",
  "recommendedSets": "3-4",
  "recommendedReps": "6-10",
  "caloriesPerMinute": 7.3,
  "instructions": [
    "Bend at your hips and knees to grip the barbell with an overhand grip…",
    "Begin the lift by pushing through your heels…", …
  ],
  "tips": [
    "Keep your head in line with your spine…", …
  ],
  "legacyIds": ["0032"],
  "media": {
    "mp4": "https://…/ex_XXOOG7/mp4-720.mp4?…",
    "poster": "https://…/ex_XXOOG7/poster.jpg?…",
    "expiresAt": "2026-12-01T10:00:00.000Z"
  }
}
01.5 / EXERCISE LIBRARY

The Exercise Animation Library Developers Actually Ship With

WorkoutX is an exercise database and fitness API built for production apps — 1,900+ exercises as looping 720p MP4 animations with male and female models, muscle and equipment metadata, and a workout API layer for building routines, all behind one REST endpoint. Looking for an exercise GIF API? v2 delivers MP4 instead: sharper, 30 fps, and usually smaller than the GIF it replaces. If you've outgrown a static free-exercise-db JSON dump or need a hosted wger alternative with paid-tier reliability, WorkoutX gives you the same open exercise data with a maintained API, uptime, and support behind it.

MUSCLE TARGETING REST API CALORIES / MIN STEP-BY-STEP 1,900+ EXERCISES 720P VIDEO DETERMINISTIC FAST INTEGRATION MUSCLE TARGETING REST API CALORIES / MIN STEP-BY-STEP 1,900+ EXERCISES 720P VIDEO DETERMINISTIC FAST INTEGRATION
02 / Use Cases

Ways to use WorkoutX

Power any fitness product with a clean REST API, structured JSON, and a 720p animation for every exercise.

Get Started Free
WorkoutX fitness API powering a native mobile workout app screen
02.5 / Muscle map

Pick a muscle. Get the data.

Every region maps to a real target filter in API v2. Tap a muscle to see what your app would receive.

Anatomy figure for the muscle map
360° · Drag to rotate · Tap a muscle
Live from /v2

Pectorals Chest

160 Male exercises720p · 30 fps MP4
    
              
              
    All targets
    03 / API reference

    Everything you need to build a fitness app

    Find exercises/v2
    GET /exercises Search 1,900+ exercises. Filter by body part, target, muscle, equipment, category, model, difficulty, mechanic, force or name. All plans GET /exercises/{id} One exercise with instructions, tips, muscles and media links. Add ?lang= for 7 languages. All plans
    Media/v2
    GET /exercises/{id}/media Fresh signed links to a 600 × 720 MP4 loop at 30 fps and its poster. Free plan gets a watermarked preview. 720p · Starter
    Filter values/v2
    GET /bodyParts · /targets · /muscles · /equipment · /categories Every valid filter value with its exercise count, ready for pickers and dropdowns. All plans
    Smart and workouts/v2
    GET /exercises/{id}/similar Similar exercises, ranked by a confidence score, in the model you choose. All plans GET /exercises/{id}/alternatives Swap equipment, for example barbell to dumbbell or a home version. All plans GET /exercises/{id}/calories MET value and weight-scaled calories burned. All plans GET /workout/generate A coached session: warm-up, supersets or circuits, sets, reps, rest and RIR, cool-down, joint-friendly swaps. Growth GET /workout/program Periodized multi-week plans with deloads, weekly volume per muscle and a test week. Scale GET /supplements Evidence-graded supplements and goal-based stacks. Growth
    Migrate/v2
    GET /exercises/legacy/{v1Id} The v2 exercise for a v1 ID, with how close the match is. All plans

    Base URL https://api.workoutxapp.com. One key works on both versions; send it in the X-WorkoutX-Key header. v1 endpoints keep working for existing integrations — see the docs.

    04 / Integration

    Simple REST API —
    Integrate in Minutes

    A clean, predictable REST API with JSON responses. No SDKs to install, no complex auth flows — just your API key in a header and you're live.

    speed

    Low-latency responses

    Sub-100ms average response times from globally distributed edge infrastructure.

    filter_list

    Powerful filtering

    Query by body part, target muscle, equipment, exercise name, or any combination with our search endpoint.

    JavaScript / fetch
    // Fetch exercises from WorkoutX API v2
    const res = await fetch(
      'https://api.workoutxapp.com/v2/exercises?bodyPart=chest&limit=5',
      { headers: { 'X-WorkoutX-Key': 'wx_your_key_here' } }
    );
    const { results } = await res.json();
    
    // results[0] =
    {
      "id": "ex_WOZL6H",
      "name": "Push Ups Bodyweight",
      "model": "male",
      "bodyPart": "Chest",
      "target": "Pectorals",
      "equipment": "Body Weight",
      "media": {
        "mp4": "https://…/ex_WOZL6H/mp4-720.mp4?…",
        "poster": "https://…/ex_WOZL6H/poster.jpg?…"
      }
    }
    
    // Play it in a muted, looping video
    video.src = results[0].media.mp4;
    check_circle Base URL: https://api.workoutxapp.com/v2
    info

    Pass your API key via the X-WorkoutX-Key request header on every call. Get your free key at the Developer Dashboard.

    04.5 / AI Agents · MCP

    Plug WorkoutX into any AI agent

    Our hosted MCP server gives Claude, ChatGPT, Grok and Cursor 20 tools: exercise search with video, a workout and program generator, plus developer tools for typed models, code examples, request debugging and usage stats. One line to connect.

    https://api.workoutxapp.com/mcp
    05 / Body Scan API

    BODY COMPOSITION. One Photo.

    Add AI-powered body composition analysis to your app with a single API call. Send a photo with height and weight — get body fat %, lean mass, muscle and symmetry scores, posture notes and estimated waist, hip and shoulder measurements. No hardware. Just REST.

    Body Fat % Muscle Score Posture Notes Waist · Hip · Shoulder Camera-Based · No Hardware
    ANALYSIS
    AI
    + formula ensemble
    RESPONSE
    ~3s
    per scan
    PLATFORMS
    iOS · Android · Web
    any camera
    body_system View Body Scan API → Read Docs
    POST /v1/analyze · 200 OK
    { "scan_id": "bscan_7xK9mP", "body_composition": { "body_fat_percentage": 14.6, "lean_mass_kg": 58.1, "body_type": "Ecto-Mesomorph", "bmi": 21.0 }, "scores": { "muscle_score": 53, "symmetry_score": 99.0, "fitness_score": 80 }, "estimated_measurements": { "shoulder_width_cm": 44.2, "waist_circumference_cm": 78.5, "hip_circumference_cm": 91.2, "waist_to_hip_ratio": 0.86 }, "ai_insights": { "posture_notes": "Neutral posture, shoulders level." }, "credits": { "used": 1, "remaining": 499 } }
    06 / Pricing

    Exercise API — Free Plan + Paid Tiers

    Yearly plans are shown as a monthly equivalent.

    Free

    $0 /month

    Try the API, no card needed

    • check500 requests in total
    • check1,900+ exercises, full metadata
    • checkMale & female models
    • checkWatermarked 360p previews
    • check10 results per request
    • close720p animations
    Get API Key

    Starter

    $19 /month

    For your first app

    • check5,000 requests / month
    • check25,000 media views / month
    • check720p MP4, 30 fps
    • checkUp to 1,000 exercises / 30 days
    • checkMulti-filter search
    • closeAI Workout Generator
    Get API Key

    Scale

    $79 /month

    For high-traffic apps

    • check100,000 requests / month
    • check600,000 media views / month
    • checkEverything in Growth
    • calendar_monthMulti-Week Training Programs
    • pillSupplement Stack Builder
    • checkPriority support
    Get API Key

    Enterprise

    Custom request and media limits, 720p · 30 fps animations with a 1080p option, an SLA, invoicing and support for multiple apps or brands. Priced to your usage.

    Contact us

    Media is streamed, not downloaded. Every plan includes commercial use of the animations inside your app, delivered from the WorkoutX CDN through secure, expiring links. Downloading, storing or re-hosting the media on your own servers or CDN is not permitted on any plan.

    Already subscribed? Your plan and price stay exactly as they are for as long as your subscription stays active, and you get the new library too.

    Get Your Free Exercise API Key

    Get your free API key in seconds. No credit card required.

    vpn_key Get Free API Key menu_book Read the Docs
    07 / FAQ

    Frequently Asked Questions

    Comparing exercise APIs? See ExerciseDB alternative, WorkoutX vs ExerciseDB and migrating from ExerciseDB.

    07 / Contact

    Questions?
    We're here.

    Whether you need help integrating the API, have questions about pricing, or want to discuss a custom plan — reach out and we'll respond within 24 hours.

    mail business@workoutxapp.com