Skip to content

furkanuruk/exercise-api-free

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Free Exercise API — 1,300+ Exercises with GIF Animations

API Status Exercises GIF Animations License: MIT RapidAPI

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


Why WorkoutX?

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

Quick start

Get your key

  1. Go to workoutxapp.com and sign up (free, no credit card)
  2. Copy your API key from the dashboard

Make your first call

curl -H "X-WorkoutX-Key: wx_your_key" \
  "https://api.workoutxapp.com/v1/exercises?limit=3"

Response

[
  {
    "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"
  }
]

API endpoints

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


Code examples

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.


Use cases

  • 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

Also available on RapidAPI

Subscribe on RapidAPI and use these headers instead:

X-RapidAPI-Key: YOUR_RAPIDAPI_KEY
X-RapidAPI-Host: (copy from RapidAPI Code Snippets)

Pricing

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 →


Full tutorial

See docs/tutorial.md for a detailed, step-by-step guide on building a fitness app with the WorkoutX API.


Contributing

Found a bug in an example? Want to add a new language? PRs are welcome! See CONTRIBUTING.md.


Links


License

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!

About

Free Exercise API examples — 1,300+ exercises with GIF animations, muscle & equipment data. Code in cURL, JS, React, Next.js, Python, Swift, Kotlin & Flutter. Powered by WorkoutX.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors