Introducing: Hyperhuman’s Content API – The Fitness Content OS for Your Product

Creating and delivering high-quality fitness content at scale is still messy for most teams: scattered tools, manual workflows, and video files that are hard to reuse across products and channels.

Hyperhuman turns that into a single Fitness Content OS.

The Hyperhuman Content API is how you plug this OS straight into your own apps, platforms, and devices—so you can recommend, generate, and deliver personalized video & audio workouts, then learn from every session.

Hyperhuman’s public API

What the Hyperhuman Content API Does

Think of the Content API as the content and intelligence layer under your product:

  • Workout & Plan Libraries

    • List organization workouts: GET /v1/orgs/{organizationId}/workouts

    • List organization plans: GET /v1/orgs/{organizationId}/plans

  • AI Workout & Plan Generation

    • Generate personalized workouts on the fly: POST /v1/orgs/{orgId}/workouts/generate

    • Generate multi-week programs: POST /v1/orgs/{orgId}/plans/generate

  • Video & Audio Playback

    • Get full workout playlist with segments and HLS streams: GET /v1/workouts/{workoutId}/playlist

    • Export complete workout video or audio-only streams for your own players.

  • Session Tracking & Analytics

    • Track starts, progress, completion, and feedback across workouts and users.

    • Pull API usage statistics per organization: GET /v1/orgs/{organizationId}/stats.

  • User & Access Management

    • Manage end users via the API: invite, suspend, reactivate, and remove profiles.

All of this comes wrapped in an OAS3 / Swagger-documented REST API, with an interactive explorer and JSON spec: Hyperhuman

Hyperhuman Content API
Quick Start for Developers

You can go from zero to your first response in minutes.

1. Get your credentials

  • Upgrade to a subscription plan that matches your audience size and included API rate limits, then go to team.hyperhuman.cc → Settings → Integrations to generate your API key.

2. First request – browse workout metadata

curl -X GET 'https://content.api.hyperhuman.cc/v1/workouts/metadata' \
-H 'X-Api-Key: YOUR_API_KEY'

3. Generate your first AI workout

curl -X POST 'https://content.api.hyperhuman.cc/v1/orgs/{orgId}/workouts/generate' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"endUserProfileDetails": {"age": 28, "fitnessLevels": ["beginner"]},
"exerciseSources": ["premium_stock"],
"durationOptions": {"minMinutes": 20, "maxMinutes": 20},
"categoryId": "615aa3f0dbe7140012c59e94"
}'

From there, you can fetch the generated workout, retrieve its playlist, and plug it into your UI or our embedded player.

Hyperhuman Content API - Use-Cases

What You Get Out of the Box

Video & Audio Assets

  • HLS master playlists (adaptive streaming)

  • Pre-signed URLs for video and audio exports

  • Structured segments: intro, exercises, breaks, promos, outro

Rich Metadata

  • Exercise details (names, reps, time, difficulty)

  • Equipment requirements and categories

  • Muscle group targeting and percentages

  • Goal, category, and difficulty taxonomies for workouts and plans

  • Localized content across 13 supported locales (en-US, en-GB, en-AU, fr-FR, de-DE, es-ES, it-IT, pt-PT, he-IL, ro-RO, cs-CZ, fi-FI, nl-NL).

AI Personalization

  • Profile-based workout and plan generation

  • Fitness level adaptation

  • Equipment-aware programming (home vs gym setup)

  • Goal-based logic (strength, rehab, weight loss, mobility, etc.)

Two Integration Paths: Embedded Player vs Custom Player

You decide how much you want to build yourself.

1. Plug-and-play Embedded Player

Fastest path to shipping an interactive workout experience.

Pre-built workout

<iframe
src="https://team.hyperhuman.cc/embed/workout/{workoutId}?organizationId={orgId}&apiKey={apiKey}&locale=en-US"
style="width: 100%; aspect-ratio: 16/9; border: none; border-radius: 8px;"
allow="autoplay; fullscreen"
allowfullscreen>
</iframe>

AI-generated workout (JSON-based)

<iframe id="player"
src="https://team.hyperhuman.cc/embed/workout-json-receiver?organizationId={orgId}&apiKey={apiKey}">
</iframe>
<script>
window.addEventListener('message', (e) => {
if (e.data === 'hyperhumanPlayerReadyForData') {
document.getElementById('player').contentWindow.postMessage(workoutJSON, '*');
}
});
</script>

Required parameters

  • organizationId – your org ID

  • apiKey – your Content API key

  • locale – optional; defaults to en-US

You get a polished, production-ready player with timelines, segments, music, and localization handled for you.

2. Custom Interactive Workout Player

If you want full control over the UX, build your own player on top of:

  • GET /v1/workouts/{workoutId} – core metadata

  • GET /v1/workouts/{workoutId}/playlist?locale={locale} – full segment structure

  • GET /v1/workouts/{workoutId}/export/video/stream_url – complete workout video

  • GET /v1/workouts/{workoutId}/export/audio/stream_url – audio-only experience

From there, you can implement:

  • Custom progress bars and timelines

  • Segment-aware navigation (intro, exercise, break, outro)

  • Media pre-buffering and lazy loading

  • Your own UI for goals, levels, and feedback

The API docs include recommended architecture for playlist management, navigation, progress tracking, and error handling.

Hyperhuman Content API - Omnichannel delivery
API Workflows That Cover Your Whole Lifecycle

The Content API supports end-to-end fitness journeys, not just media streaming. Some of the key flows:

1. Browse & Play Pre-built Content

  1. GET /v1/workouts/metadata – filters & categories

  2. GET /v1/workouts – list workouts

  3. GET /v1/workouts/{id} – details

  4. GET /v1/workouts/{id}/playlist – segments & streams

  5. POST /v1/workouts/{id}/sessions/start – track sessions

2. AI-Generated Workouts

  1. GET /v1/orgs/{orgId}/metadata

  2. POST /v1/orgs/{orgId}/workouts/generate

  3. GET /v1/workouts/{id}/playlist

  4. POST /v1/workouts/{id}/sessions/start / PATCH / end / complete

  5. POST /v1/workouts/{id}/feedback

3. Training Programs (Plans)

  1. GET /v1/plans/metadata

  2. POST /v1/orgs/{orgId}/plans/generate

  3. GET /v1/plans/{id} & /workouts

  4. For each workout, follow the workout workflow.

4. User Management & Access

  • List users: GET /v1/orgs/{organizationId}/endusers

  • Invite: POST /v1/orgs/{organizationId}/endusers/invite

  • Suspend / reactivate: PUT /v1/orgs/{organizationId}/endusers/suspend / reactivate

  • Remove: DELETE /v1/orgs/{organizationId}/endusers

5. Session Analytics

  • GET /v1/workouts/{workoutId}/sessions/recent

  • GET /v1/workouts/{workoutId}/sessions/{sessionId}

  • GET /v1/orgs/{organizationId}/stats – real-time API usage stats, including rate limits.

Authentication, Error Handling & Rate Limits

Authentication

All requests use a simple header:

X-Api-Key: YOUR_API_KEY

API keys are generated and managed from your organization settings in the Hyperhuman Team web app.

Error Handling

The API returns structured error responses:

{
"statusCode": 400,
"message": "Validation failed",
"error": "Bad Request",
"details": [
{
"field": "durationOptions.minMinutes",
"message": "must be a positive number"
}
]
}

You’ll see familiar HTTP status codes (400, 401, 403, 404, 409, 422, 429, 500). Best practice is to:

  • Check status codes on every call

  • Implement exponential backoff for 429 and 5xx

  • Log error details for debugging

  • Show user-friendly messages in your app

Rate Limiting

All responses include rate limit headers:

  • X-RateLimit-Limit – max requests per window

  • X-RateLimit-Remaining – remaining calls

  • X-RateLimit-Reset – Unix timestamp for reset

On 429 Too Many Requests:

  • Pause requests

  • Wait until reset time

  • Use exponential backoff and/or a queue

  • Consider upgrading your plan if you regularly hit the limit

You can also query:

  • GET /v1/orgs/{organizationId}/stats → real-time API usage, including limits and consumption.

Pricing & Plan-level API Access

The Content API is integrated into Hyperhuman’s business plans—not managed through third-party API hubs.

  • Mastery – For solo trainers, influencers, and coaches

    • Content API: No (focused on content creation and direct client delivery)

  • Elite – For growing fitness businesses & small digital health / rehab teams

    • Content API: Yes

    • Rate limits: 3,000 requests / hour, 45,000 requests / day

  • Legend – For scaling fitness apps, gyms & digital health platforms

    • Content API: Yes

    • Rate limits: 10,000 requests / hour, 150,000 requests / day

  • Enterprise – Custom plan for global organizations

    • High-volume API and integrations

    • Custom limits, SLAs, and roll-out support

For full pricing details, minutes, exports, and app options:

If you expect higher volumes or special workflows, the Hyperhuman team can configure custom rate limits and enterprise contracts on top of the base plans.

Who is the Hyperhuman API For
Who the API Is For

The Content API is built for teams who see fitness content as a core product, not just a marketing asset:

  • Fitness & wellness apps that want a smarter, AI-driven content engine

  • Digital health and rehab platforms that need structured, trackable exercise content

  • Corporate wellness solutions that require personalized programs at scale

  • Gym chains and studios building hybrid in-club + digital experiences

  • Hardware and wearable companies that need a content OS behind the device

Get Started

If you already create or plan to create fitness content with Hyperhuman, the Content API is how you:

Create once. Personalize everywhere.

Here’s the simplest path:

  1. Explore the docs

  2. Pick the right plan

    • See Content API availability and rate limits on the Elite, Legend, and Enterprise tiers. Hyperhuman Pricing

  3. Implement your first workflow

    • Start with a simple browse-and-play flow or the embedded player

    • Move to AI-generated workouts and programs as you grow

    • Add tracking, analytics, and user management when you’re ready

When you’re done, you don’t just have video in your app—you have a Fitness Content OS powering every session your users complete.

GET STARTED TODAY