# WorkoutX — Exercise Database API with Video Animations

This is the Markdown version of https://workoutxapp.com/ for AI agents.

> WorkoutX API is a REST API with 1,900+ exercises delivered as 2,700+ clips: professionally produced 3D animations as 720p MP4 video at 30 fps, with male and female models. It adds muscle, equipment, calorie/MET and Joint & Rehab data, similar-exercise and alternatives endpoints, an AI workout generator, a supplement database and multi-language responses (English, Turkish, German, Spanish, French, Simplified & Traditional Chinese). Base URL: https://api.workoutxapp.com/v2, authenticated with the X-WorkoutX-Key header. Free tier: 500 requests in total, no credit card required.

WorkoutX API gives developers and AI systems access to a structured exercise library. Each v2 exercise includes: a unique id (for example `ex_WOZL6H`), name, model (male or female) and `counterpartId` (the same movement with the other model), body part, target muscle, equipment, category, primary and secondary muscles, difficulty, mechanic, force, MET and calories per minute, recommended sets and reps, step-by-step instructions, form tips, Joint & Rehab fields (`jointFocus`, `intensityLevel`, `movementTags`), and a `media` object with signed `mp4` and `poster` links. Media links expire after 24–25 hours: store exercise ids, not media URLs, and get fresh links from the API. Downloading the media or serving it from your own servers or CDN is not permitted on any plan. Text can be localized with `?lang=` (`tr`, `de`, `es`, `fr`, `zh-SG`, `zh-HK`; English by default). The v1 API (GIFs, 4-digit ids) keeps working for existing integrations, with at least 30 days' notice by email before it is retired. See [llms-full.txt](https://workoutxapp.com/llms-full.txt) for the complete endpoint reference, request/response examples, pricing table, and licensing comparison.

## Docs

- [API documentation](https://workoutxapp.com/docs.html): Full endpoint reference — v2 exercise list and filters (including Joint & Rehab), exercise by id, fresh media links, v1 id mapping, similar exercises, alternatives, calories, AI workout generator, multi-week programs, supplements, filter-value lists, rate limits, and errors
- [Moving from v1 to v2](https://workoutxapp.com/v2-migration.html): What changes (ids, media, header-only auth, response shape) and how to migrate one screen at a time
- [Exercise library](https://workoutxapp.com/exercises.html): Browsable directory of exercises with video demonstrations
- [Dashboard & API playground](https://workoutxapp.com/dashboard.html): Get a free API key and test endpoints interactively
- [SDKs](https://workoutxapp.com/sdks.html): JavaScript, Python, Swift and Flutter SDKs; `wx.v2` has the same endpoints plus `freshMedia(id)`
- [OpenAPI spec](https://api.workoutxapp.com/openapi.json): Machine-readable OpenAPI 3 spec served by the API
- [RapidAPI listing](https://rapidapi.com/workoutx/api/workoutx-fitness-exercises): The v1 API on RapidAPI, for existing integrations

## MCP server (for AI agents)

- Endpoint: `https://api.workoutxapp.com/mcp` (Model Context Protocol, Streamable HTTP). Send your API key in the `X-WorkoutX-Key` header (or `Authorization: Bearer`).
- Developer tools: get_endpoint_reference, generate_types (TypeScript, Swift, Kotlin, Dart), get_code_example (React Native, Swift, Flutter, Next.js, Node, Python), diagnose_request, get_usage_stats, export_exercise_seed (JSON/CSV, no media), get_trending_exercises, search_exercises, get_exercise, get_exercise_media, list_exercise_filters, find_exercise_alternatives, find_similar_exercises, estimate_calories, map_v1_exercise, generate_workout, generate_program, search_supplements, get_supplement_stack, check_api_key. All read-only; each call counts as one request and plan limits apply.
- Claude Code: `claude mcp add --transport http workoutx https://api.workoutxapp.com/mcp --header "X-WorkoutX-Key: wx_your_key"`
- Cursor / VS Code: `{"mcpServers":{"workoutx":{"url":"https://api.workoutxapp.com/mcp","headers":{"X-WorkoutX-Key":"wx_your_key"}}}}`
- Claude Desktop (stdio): `npx -y workoutx-mcp` with `WORKOUTX_API_KEY` set ([npm](https://www.npmjs.com/package/workoutx-mcp))
- [Setup guide](https://workoutxapp.com/mcp.html) · [Server card](https://workoutxapp.com/.well-known/mcp/server-card.json)

## Body Scan API

Separate product from the Exercise API. Send a full-body photo with height, weight, age and sex to `POST /v1/analyze` (`X-BodyScan-Key` header). The API finds pose landmarks and applies published equations (U.S. Navy, Relative Fat Mass, Deurenberg, Gallagher-type). A vision model writes notes only; it does not set the body fat number.

Returns: body fat estimate with an indicative range, fat and lean mass, BMI, body type, waist, hip and shoulder estimates, and muscle, symmetry and fitness scores.

Limits: for general wellness and fitness tracking, for adults 18+. Results are estimates. It is not a medical device, is not validated against DXA or any other reference method, and must not be used for diagnosis, treatment or medical monitoring. Photos are not stored by us; results are deleted after 90 days.

Pricing: 5 free scans once per WorkoutX account (they don't renew), then one-time credit packs: $39 for 20 scans, $149 for 100, $599 for 500, $999 for 1,000. Credits never expire.

- [Body Scan API](https://workoutxapp.com/bodyscan.html): product page and pricing
- [Body Scan docs](https://workoutxapp.com/docs.html#bs-intro): endpoints and response fields
- [Body composition API guide](https://workoutxapp.com/blog/body-composition-api-guide.html)
- [Body fat percentage API](https://workoutxapp.com/blog/body-fat-percentage-api.html)
- [Add AI body scanning to a fitness app](https://workoutxapp.com/blog/ai-body-scanning-fitness-app.html)

## Guides

- [How to build a workout app](https://workoutxapp.com/blog/how-to-build-workout-app.html): Step-by-step guide for building a fitness app on the v2 API — fetching exercises, filtering, pagination and playing the MP4 animations
- [AI workout generator API](https://workoutxapp.com/blog/ai-workout-generator-api.html): Using `/v2/workout/generate` (a rule-based engine) to return complete sessions: warm-up, exercises in straight sets, supersets or circuits with sets, reps, rest, effort and a video each, joint-aware choices with `avoidJoints`, and a cool-down
- [REST API tutorial for fitness apps](https://workoutxapp.com/blog/rest-api-tutorial-fitness-apps.html): Zero-to-first-endpoint tutorial — auth, fetching exercises, filtering by muscle group, playing video demonstrations
- [React exercise API tutorial](https://workoutxapp.com/blog/react-exercise-api-tutorial.html): Consuming the API from a React app
- [Best free exercise APIs 2026](https://workoutxapp.com/blog/best-free-exercise-api-2026.html): Comparison of free exercise data APIs
- [Exercise API with GIF animations](https://workoutxapp.com/blog/exercise-api-with-gifs.html): Why WorkoutX v2 streams 720p MP4 instead of GIFs, and how to display exercise animations in an app
- [ExerciseDB alternative](https://workoutxapp.com/blog/exercisedb-alternative.html): How WorkoutX compares to ExerciseDB
- [WorkoutX vs ExerciseDB vs wger](https://workoutxapp.com/blog/workoutx-vs-exercisedb.html): Head-to-head comparison of pricing, data, animation support (GIF vs MP4), and rate limits
- [Migrate from ExerciseDB](https://workoutxapp.com/blog/migrate-from-exercisedb.html): 20-30 minute migration guide with v2 endpoint mapping and code examples
- [Build a fitness GPT with an exercise API](https://workoutxapp.com/blog/build-fitness-gpt-with-exercise-api.html): Custom GPT Actions setup with a v2 OpenAPI schema, system prompt, and Claude tool-calling example
- [Exercise API comparison 2026](https://workoutxapp.com/blog/exercise-api-comparison-2026.html): WorkoutX vs ExerciseDB vs wger vs free-exercise-db on hosting, data, free tier, pricing, and licensing
- [Exercise GIF API licensing guide](https://workoutxapp.com/blog/exercise-gif-api-licensing-guide.html): Commercial-use and licensing comparison across WorkoutX, ExerciseDB, wger, and free-exercise-db, including WorkoutX's streaming-only media rule

## Example Exercises

- [Push ups (bodyweight)](https://workoutxapp.com/exercises/push-ups-bodyweight.html): Bodyweight chest exercise with a video demonstration, muscles and equipment
- [Pull up (normal grip)](https://workoutxapp.com/exercises/pull-up-normal-grip.html): Bodyweight back exercise with a video demonstration, muscles and equipment
- [Barbell deadlift](https://workoutxapp.com/exercises/barbell-deadlift.html): Compound barbell exercise with a video demonstration, muscles and equipment
- [Barbell bench press](https://workoutxapp.com/exercises/barbell-bench-press.html): Compound chest exercise with a video demonstration, muscles and equipment
- [Exercise library](https://workoutxapp.com/exercises.html): all 1,900+ exercises, searchable by body part, muscle and equipment
- [Exercise A–Z](https://workoutxapp.com/exercises/index.html): every exercise page in alphabetical order
- [Chest exercises](https://workoutxapp.com/exercises/chest-exercises.html), [Back exercises](https://workoutxapp.com/exercises/back-exercises.html), [Leg exercises](https://workoutxapp.com/exercises/leg-exercises.html), [Dumbbell exercises](https://workoutxapp.com/exercises/dumbbell-exercises.html), [Bodyweight exercises](https://workoutxapp.com/exercises/bodyweight-exercises.html): 5 of the 16 muscle and equipment categories

## Optional

- [Full AI reference (llms-full.txt)](https://workoutxapp.com/llms-full.txt): Complete endpoint list, JSON examples, code examples, pricing/rate-limit table, and licensing comparison
- [Pricing](https://workoutxapp.com/pricing.html): Free (500 requests in total), Starter ($19/month), Growth ($39/month), Scale ($79/month) and Enterprise; yearly billing gets 2 months free
- [Privacy policy](https://workoutxapp.com/privacy.html): Privacy policy
- [Terms of service](https://workoutxapp.com/terms.html): Terms of service

## Company

- [About WorkoutX](https://workoutxapp.com/about.html) · [Contact](https://workoutxapp.com/contact.html) · [Legal notice](https://workoutxapp.com/impressum.html)
- Support: support@workoutxapp.com · Sales and Enterprise: enterprise@workoutxapp.com · Business: business@workoutxapp.com