Documentation

API Documentation

Everything you need to integrate YMove exercise videos into your application.

Authentication

Include your API key in the X-API-Key header with every request:

curl -H "X-API-Key: ym_your_key_here" \
  https://ymove.app/api/v1/exercises

Alternatively, pass as a query parameter: ?api_key=ym_your_key_here

Base URL

https://ymove.app/api/v1

Endpoints

Muscle Groups Reference

chestbackshouldersbicepstricepsforearmsquadshamstringsglutescalvescorefull_body

Rate Limiting & Usage

API usage is metered by video minutes. When you request exercises that include video content, the video duration is counted against your plan's minute limit.

- Starter: 10,000 minutes / month
- Pro: 25,000 minutes / month

Check your usage at any time via the /usage endpoint.

Code Examples

JavaScript / Node.js

const API_KEY = 'ym_your_key_here';
const BASE = 'https://ymove.app/api/v1';

// List chest exercises
const exercises = await fetch(`${BASE}/exercises?muscleGroup=chest&hasVideo=true`, {
  headers: { 'X-API-Key': API_KEY }
}).then(r => r.json());

// Generate a workout
const workout = await fetch(`${BASE}/workouts/generate?muscleGroup=back&difficulty=intermediate`, {
  headers: { 'X-API-Key': API_KEY }
}).then(r => r.json());

// Generate a 4-week program
const program = await fetch(`${BASE}/programs/generate?goal=muscle_building&daysPerWeek=4&weeks=4`, {
  headers: { 'X-API-Key': API_KEY }
}).then(r => r.json());

Python

import requests

API_KEY = 'ym_your_key_here'
BASE = 'https://ymove.app/api/v1'
headers = {'X-API-Key': API_KEY}

# List exercises
exercises = requests.get(f'{BASE}/exercises', params={'muscleGroup': 'chest'}, headers=headers).json()

# Generate workout
workout = requests.get(f'{BASE}/workouts/generate', params={'muscleGroup': 'back'}, headers=headers).json()

# Generate program
program = requests.get(f'{BASE}/programs/generate', params={
    'goal': 'muscle_building', 'daysPerWeek': 4, 'weeks': 4
}, headers=headers).json()

Ready to get started?

Start your free trial and get your API key in seconds.

Start Free Trial