FORMA Exercise API 🧩

Power your app, bot or website with FORMA's structured exercise database — muscles worked, equipment, step-by-step instructions, tips and more. Clean JSON, generous free tier.

Your API keys

Create a free account to get an API key — 1,000 requests/month, no card required.

Quickstart

Base URL https://formabuild.net/api/v1 · authenticate with Authorization: Bearer YOUR_KEY

curl https://formabuild.net/api/v1/exercises?muscle=chest \
  -H "Authorization: Bearer forma_live_YOUR_API_KEY"

Example response:

{
  "total": 14,
  "count": 14,
  "limit": 20,
  "offset": 0,
  "exercises": [
    {
      "slug": "incline",
      "name": "Incline Dumbbell Press",
      "equipment": "Dumbbell",
      "difficulty": "Intermediate",
      "pattern": "Push",
      "primary_muscle": "Upper Chest",
      "secondary_muscles": ["Front Delts"],
      "sets": "4", "reps": "8–12", "rest": "90 sec",
      "calories_per_min": "8/min",
      "instructions": ["Set bench to 30–45°.", "..."],
      "tips": ["..."], "common_mistakes": ["..."]
    }
  ]
}

Endpoints

GET/exercisesList & filter exercises

Query params: muscle, equipment, difficulty, pattern, search, limit (≤100), offset

GET/exercises/{slug}Full detail for one exercise

GET/musclesEvery muscle group + function

Embed a widget — free

Drop FORMA exercises onto any site or blog with one line. It carries your branding and links back to you (great for traffic + SEO).

<script src="https://formabuild.net/embed.js"
  data-muscle="chest" data-limit="8" data-theme="dark"></script>

Live preview:

API pricing

Start free. Scale when you ship.

Free

For trying it out & side projects

$0/mo

1,000 requests / month
All exercise & muscle endpoints
1 API key

Pro

For production apps

$29/mo

50,000 requests / month
Priority support
Up to 5 keys
Commercial use

Enterprise

Licensing & bulk data

Custom

Full database license
Self-hosting options
Custom SLAs & volume
Partnership terms

License the database →