L'API Contenuti Fitness
Una sola API per delivery, personalizzazione e insights su tutto il tuo prodotto.
Da Contenuti a Intelligenza
Inizia semplice. Aggiungi intelligenza. Termina con insights che guidano la retention.
# Browse & Play Workouts
GET /v1/workouts?categoryId=...&limit=20
GET /v1/workouts/{workoutId}
GET /v1/workouts/{workoutId}/playlist
// Workout detail response
{
"id": "615aa3f0dbe7140012c59e94",
"title": "Full Body HIIT",
"duration": 1200,
"difficulty": "intermediate",
"trainer": { "name": "Alex" },
"thumbnail": "https://..."
}
# Playlist: segments + HLS URLsPOST /v1/orgs/{orgId}/workouts/recommend
{
"endUserProfileDetails": {
"age": 28,
"fitnessLevels": ["beginner"]
},
"durationOptions": {
"minMinutes": 20,
"maxMinutes": 30
}
}
// Response (instant <100ms)
{
"workouts": [
{ "id": "...", "title": "Morning Flow", "matchScore": 0.95 },
{ "id": "...", "title": "Core Basics", "matchScore": 0.89 }
]
}POST /v1/orgs/{orgId}/workouts/{workoutId}/adapt
{
"endUserProfileId": "64e3bca9d1b7e600141a9712",
"endUserProfileDetails": {
"age": 28,
"gender": "female",
"fitnessLevels": ["advanced"],
"goalIds": ["63c92926f920a9005c4e619c"],
"trainingDaysPerWeek": 5,
"preferredEquipmentCategoryIds": ["67deb36a..."]
},
"exerciseSources": ["premium_stock", "team_exercises"],
"userGuidance": "Training for 10K run. Focus on
endurance. Limited time, prefer shorter workout."
}
// Response (personalized from original)
{
"name": "Adapted: Endurance Builder",
"totalDurationSeconds": 1200,
"difficulty": "advanced",
"adaptationReasoning": "Shortened to 20min per
user request. Swapped HIIT for steady-state
cardio to support 10K goal.",
"instances": [...]
}POST /v1/orgs/{orgId}/workouts/generate
{
"endUserProfileDetails": {
"age": 28,
"fitnessLevels": ["beginner"]
},
"exerciseSources": ["premium_stock"],
"durationOptions": {
"minMinutes": 20,
"maxMinutes": 20
},
"categoryId": "615aa3f0dbe7140012c59e94"
}
// Response (2-8 seconds)
{
"workout": {
"id": "generated-abc123",
"title": "20min Beginner HIIT",
"duration": 1200,
"segments": [...]
}
}GET /v1/orgs/{orgId}/endusers/{email}/insights/digest
?date=2026-01-10
// Daily AI Digest Response
{
"pillars": [
{
"type": "health_pulse",
"status": "green",
"headline": "82 (+5 vs 7-day). Driver: Sleep.",
"action": "Maintain your sleep routine",
"readinessBand": "push"
},
{
"type": "training",
"status": "green",
"headline": "4 workouts. Form: 78%. On pace.",
"action": "Next: Full Body Strength"
}
],
"todaysFocus": "Complete: Full Body Strength",
"dataCompleteness": 0.75
}Pubblica Contenuti
Elenca, filtra e pubblica istantaneamente workout e programmi nella tua app.
- La tua libreria diventa la superficie prodotto
- I metadata rendono la scoperta effortless
AI Raccomanda
Suggerisci il prossimo workout o piano migliore usando obiettivi e segnali profilo.
- "Prossimo" personalizzato in secondi
- Funziona con i tuoi contenuti esistenti
AI Adatta
Evolvi workout e programmi esistenti man mano che gli utenti progrediscono e il contesto cambia.
- Progressione senza programmazione manuale
- Mantiene i piani rilevanti piu a lungo
AI Genera
Crea workout on-the-fly e programmi multi-settimana su misura per utente.
- Sessioni fresche senza treadmill di contenuti
- Costruiti attorno a vincoli: tempo, livello, attrezzatura
AI Insights
Trasforma sessioni, feedback e obiettivi in guida giornaliera e insights 360.
- Digest giornaliero e viste dettaglio pilastri
- Costruito per loop di ri-engagement
Dalla delivery al miglioramento continuo, senza costruire un team data science.
Opzioni di consegna
Da pagine libreria pronte a esperienze player completamente personalizzate: distribuisci i contenuti a modo tuo.
Embed e Vai
Incorporare un workout player o l'intera libreria contenuti personalizzabile.
Ideale per: Web app, portali, MVP, landing page, corporate wellness
Vedi nella documentazione→Stream Video
Stream video workout o audio a lunghezza piena, pronti per la distribuzione.
Ideale per: Cataloghi VOD, pubblicazione CMS, workflow YouTube
Vedi nella documentazione→Costruisci la Tua UX
La tua UI alimentata da playlist, segmenti e link streaming sicuri.
Ideale per: App mobile, hardware connesso, esperienze coaching premium
Vedi nella documentazione→Genera - Riproduci - Traccia
FAQ API Hyperhuman
Alcuni punti che potresti voler conoscere
Si, una documentazione API completa e disponibile per aiutarti a integrare l'API nei tuoi sistemi. Il nostro obiettivo e rendere l'integrazione della nostra API un processo plug & play: connetti e inizia con poche righe di codice. Puoi concentrarti sul tuo business principale e lasciare a noi la distribuzione dei contenuti.
Link alla specifica API Hyperhuman: https://hyperhuman.cc/api-docs
Per ulteriori richieste o assistenza, contatta il nostro team di supporto a support@hyperhuman.com
L'accesso alla Content API di Hyperhuman e fornito tramite una chiave API unica disponibile quando si passa a uno dei nostri piani a pagamento. Maggiori dettagli sui limiti inclusi in ogni piano su https://hyperhuman.cc/pricing
Pianifichiamo una breve chiamata per definire le tue esigenze API e la quota su https://hyperhuman.cc/book-a-demo
Puoi creare e pubblicare qualsiasi tipo di allenamenti e programmi video on-demand, allenamenti da seguire, fisioterapia online, tutorial fitness, video yoga o pilates fino a video di maestria sportiva e lezioni di fitness. Tutti gli allenamenti includono una vasta gamma di dati e risorse multimediali per offrire l'esperienza piu coinvolgente e personalizzata ai tuoi clienti.
Integrare i contenuti Hyperhuman e facile. Copia il codice iFrame fornito per la pagina di allenamento o programma specifica e incollalo nell'HTML del tuo sito web. Personalizza l'aspetto regolando larghezza, altezza e altri parametri nel codice iFrame. Per tutti gli allenamenti e programmi elencati pubblicamente, usa pagine di contenuto auto-generate con codici iFrame dedicati per un'integrazione fluida.
Forniamo due formati di output per gli allenamenti distinti adattati per un'integrazione fluida nelle tue app mobili o prodotti digitali:
Versione interattiva: Questo formato offre sistemi di dati modulari, inclusi clip di esercizi singoli, istruzioni audio e metadati. Ideale per le aziende che cercano un'esperienza fitness personalizzabile nelle loro piattaforme esistenti.
Video completi da seguire: Video completamente prodotti pronti per l'uso immediato. Perfetti per aziende di fitness digitale che mirano a offrire un'esperienza di allenamento guidata senza ulteriori sforzi di post-produzione.
Integrazione: Integra facilmente componenti modulari nelle tue app mobili o prodotti digitali esistenti, offrendo agli utenti un'esperienza fitness personalizzata e interattiva.
Personalizzazione: Adatta gli allenamenti a preferenze specifiche, adattati a diversi livelli di fitness o mira a gruppi muscolari specifici, soddisfacendo un pubblico diversificato.
Versatilita: Il sistema di dati modulare consente un uso versatile, consentendo alle aziende di adattare ed evolvere i loro contenuti fitness in modo fluido.
No, la scelta tra la versione interattiva e i video da seguire non influisce sul costo. Goditi la flessibilita di selezionare il formato che si allinea ai tuoi obiettivi aziendali senza costi aggiuntivi.
Si, ci sono limitazioni sul numero di richieste API che puoi effettuare in base al tuo piano di abbonamento attivo. Maggiori dettagli sui limiti inclusi in ogni piano su https://hyperhuman.cc/pricing
Si, il nostro team di supporto dedicato e pronto a fornire assistenza e rispondere a qualsiasi domanda per garantire un'integrazione fluida.
Per ulteriori richieste o assistenza, contatta il nostro team di supporto a support@hyperhuman.com
Si. L'API Contenuti Hyperhuman supporta esperienze workout localizzate in 13 localita, cosi la tua app puo offrire lo stesso workout nella lingua dell'utente: video + metadata + guida audio.
Cosa viene localizzato: titoli/descrizioni degli allenamenti, nomi degli esercizi, attrezzatura, gruppi muscolari e istruzioni audio (dove abilitato).
Come richiedere una lingua: passa locale (es. fr-FR) quando recuperi dettagli degli allenamenti o playlist:
GET /v1/workouts/{workoutId}?locale=fr-FR
GET /v1/workouts/{workoutId}/playlist?locale=fr-FR
Localita supportate (13): 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
Comportamento fallback: se una localita non e disponibile, l'API passa all'inglese di default.
Si. Hyperhuman supporta entrambi: un player di allenamenti incorporato plug-and-play (piu veloce) e un'implementazione di player personalizzato (controllo massimo) utilizzando la stessa Workout API e gli endpoint playlist.
Opzione A - Player incorporato (piu veloce da implementare)
Usa un player di allenamenti iframe per trasmettere un allenamento pre-costruito:
https://team.hyperhuman.cc/embed/workout/{workoutId}?organizationId={orgId}&apiKey={apiKey}&locale=en-US
Oppure incorpora un player che riceve workout JSON generati dall'AI (ottimo per flussi "genera - riproduci istantaneamente").
Ideale per: app web, portali, landing page, intranet wellness aziendale, MVP.
Opzione B - Player personalizzato (controllo completo nella tua UI)
Recupera i dettagli dell'allenamento e una playlist strutturata con stream HLS e renderizza la tua esperienza:
GET /v1/workouts/{workoutId}
GET /v1/workouts/{workoutId}/playlist?locale={locale}
Riceverai timing segmenti + asset media (intro/esercizio/pausa/outro), oltre a URL pre-firmati e HLS master playlist per streaming adattivo.
Ideale per: app mobili, hardware connesso, UX coaching avanzata, analitiche personalizzate.
