A free REST API for fitness and workout apps. Get 1,300+ exercises with animated GIFs, target muscles, equipment, difficulty, calories, and step-by-step instructions — all from a single endpoint.
Get Free API Key · View Docs · Try on RapidAPI
| Feature | WorkoutX | Other APIs |
|---|---|---|
| Exercises | 1,300+ | 800–1,000 |
| GIF animations | Every exercise | Limited or paid |
| Free tier | 500 req/month | Often none |
| Direct REST API | Yes | Proxy-only |
| Instructions | Step-by-step | Rare |
| Calories & MET | Included | Rare |
| Secondary muscles | Included | Some |
| Auth complexity | Single header | OAuth / tokens |
- Go to workoutxapp.com and sign up (free, no credit card)
- Copy your API key from the dashboard
curl -H "X-WorkoutX-Key: wx_your_key" \
"https://api.workoutxapp.com/v1/exercises?limit=3"[
{
"id": "0032",
"name": "Barbell Deadlift",
"bodyPart": "Upper Legs",
"equipment": "Barbell",
"target": "Glutes",
"secondaryMuscles": ["Hamstrings", "Lower Back"],
"category": "strength",
"difficulty": "intermediate",
"met": 6.0,
"caloriesPerMinute": 7.3,
"instructions": [
"Stand with feet shoulder-width apart, barbell over mid-foot.",
"Hinge at hips, grip bar outside legs, keep back flat.",
"Drive through heels, extend hips and knees to stand.",
"Lower the bar with control back to the ground."
],
"gifUrl": "https://api.workoutxapp.com/v1/gifs/0032"
}
]Base URL: https://api.workoutxapp.com
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/exercises |
List all exercises (supports limit & offset) |
| GET | /v1/exercises/bodyPart/:bodyPart |
Filter by body part |
| GET | /v1/exercises/target/:target |
Filter by target muscle |
| GET | /v1/exercises/equipment/:equipment |
Filter by equipment |
| GET | /v1/exercises/name/:name |
Search by exercise name |
| GET | /v1/exercises/search |
Advanced search |
| GET | /v1/exercises/exercise/:id |
Get single exercise by ID |
Authentication: Pass your key in the X-WorkoutX-Key header on every request.
Body parts: back · cardio · chest · lower arms · lower legs · neck · shoulders · upper arms · upper legs · waist
Ready-to-run examples in 8 languages/frameworks:
| Language / Framework | Directory | What's inside |
|---|---|---|
| cURL / Shell | examples/curl/ |
One-liner commands |
| JavaScript | examples/javascript/ |
Vanilla fetch (browser + Node) |
| React | examples/react/ |
Full Vite + TypeScript app with body-part filter |
| Next.js | examples/nextjs/ |
Server-side API route (key stays on server) |
| Python | examples/python/ |
requests + Flask mini app |
| Swift | examples/swift/ |
iOS / macOS URLSession |
| Kotlin | examples/kotlin/ |
Android Retrofit |
| Flutter / Dart | examples/flutter/ |
Dart http package |
Every example has its own README with setup instructions.
- Fitness mobile apps — iOS, Android, Flutter, React Native
- Workout web apps — exercise search, workout builders, program generators
- Personal trainer tools — custom client plans with visual demos
- AI & health platforms — enrich recommendations with structured exercise data
- Wearable integrations — serve exercise data to watch apps
- Content & blogs — embed GIFs and exercise info in articles
Subscribe on RapidAPI and use these headers instead:
X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
X-RapidAPI-Host: (copy from RapidAPI Code Snippets)
| Plan | Price | Requests/month | Rate limit |
|---|---|---|---|
| Free | $0 | 500 | 30/min |
| Basic | $9.99/mo | 3,000 | 150/min |
| Pro | $15.99/mo | 10,000 | 300/min |
| Ultra | $24.99/mo | 35,000 | 600/min |
| Enterprise | Custom | Unlimited | Unlimited |
All plans include the full exercise database with GIF animations. See pricing →
See docs/tutorial.md for a detailed, step-by-step guide on building a fitness app with the WorkoutX API.
Found a bug in an example? Want to add a new language? PRs are welcome! See CONTRIBUTING.md.
- Website: workoutxapp.com
- Docs: workoutxapp.com/docs.html
- RapidAPI: WorkoutX on RapidAPI
- Status: API status
MIT — example code is free to use. The API itself is subject to WorkoutX terms.
If this repo helped you, give it a ⭐ — it helps other developers find it!