Tienes un ID de ejercicio en tu aplicación deportiva y necesitas obtener datos concretos de entrenamiento ahora mismo: movimientos alternativos, series y repeticiones de hoy para un programa, o un índice rápido de partes del cuerpo para impulsar tu interfaz de usuario. Al final de esta guía, podrás obtener alternativas de ejercicio por ID, iniciar un programa personalizado y obtener el entrenamiento de hoy utilizando la API de Base de Datos de Ejercicios en Zyla API Hub.
Lo que esta API te ofrece (y dónde encaja en una aplicación deportiva)
La API de Base de Datos de Ejercicios proporciona:
- Alternativas de ejercicio por ID, filtradas por equipo cuando sea necesario (ideal para lógica de sustitución cuando cierto equipo no está disponible).
- Creación de programas que devuelven la sesión de hoy: ejercicios, series, repeticiones, descanso y campos de peso sugerido.
- Obtención del entrenamiento de hoy para un programa existente.
- Una lista simple de partes del cuerpo para estructurar filtros o navegación dentro de la aplicación.
Estos puntos finales permiten construir rápidamente flujos de trabajo de sustitución (por ejemplo, “muéstrame movimientos como este”), generar o actualizar sesiones de entrenamiento diarias y presentar agrupaciones lógicas de catálogo (por parte del cuerpo) — flujos centrales en aplicaciones de entrenamiento deportivo, tableros de entrenamiento y experiencias de comercio electrónico de fitness vinculadas a la disponibilidad de equipo.
Comenzando en Zyla API Hub
Abre la página de la API, haz clic en Suscribirse (o Iniciar Prueba Gratuita si está disponible) y obtén tu clave. La autenticación es a través del encabezado Authorization: Bearer YOUR_API_KEY. La facturación es por suscripción + cuota (no por llamada). Para esta API, puedes comenzar con una prueba de 7 días desde la página de listado. Mantén tu clave segura; no la comprometas en el control de versiones.
Puedes explorar miles de integraciones de deportes y salud listas para producción en Zyla API Hub, todo bajo una cuenta, una clave API y un modelo de suscripción consistente en todas las categorías. Cuando estés listo para esta integración, utiliza el enlace de listado directo a continuación para crear una cuenta y obtener tu clave API.
Iniciar prueba de 7 días en la API de Base de Datos de Ejercicios
Puntos finales que usarás
1) Alternativas de Ejercicio (GET)
Hasta 10 ejercicios con el mismo movimiento que el ID de ejercicio proporcionado. Si ese ejercicio no tiene movimiento, la API recurre al mismo músculo objetivo. Puedes opcionalmente restringir los resultados a una pieza de equipo.
- Método: GET
- URL: https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives
- Parámetro de consulta requerido: id (número)
- Parámetro de consulta opcional: equipment (cadena)
Curl copiable:
curl -s -X GET "https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts" \
-H "Authorization: Bearer YOUR_API_KEY"Ejemplo de respuesta oficial (verbatim):
[{"bodyPart":"waist","equipment":"body weight","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_2.gif","id":2,"name":"45\u00b0 side bend","target":"abs","videos":[{"title":"45 degree side bends","link":"https://youtu.be/pUXu_7H0y_o"},{"title":"Side Bend on 45-degree Hyper Extension - Bodyweight or Weighted","link":"https://youtu.be/IyCX-a9Lm_U"},{"title":"Dumbbell Side Bend - Core / Abs - Bodybuilding.com","link":"https://youtu.be/UUQHeBRE_Wo"}]},{"bodyPart":"waist","equipment":"body weight","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_3.gif","id":3,"name":"air bike","target":"abs","videos":[{"title":"Air Bike - Ab Exercises - Bodybuilding.com","link":"https://youtu.be/i6mPCVUrtNk"},{"title":"Air Bike Crunches","link":"https://youtu.be/3K9hMlalr60"},{"title":"Air cycling","link":"https://youtu.be/oyXoWU8j310"}]},{"bodyPart":"waist","equipment":"body weight","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_5.gif","id":5,"name":"alternate heel touchers","target":"abs","videos":[{"title":"Alternating Heel Touch | Bodyweight Home Workout Exercise","link":"https://youtu.be/5JyOU0smtMo"},{"title":"How To Do…Qué usar:
- id: el ID del ejercicio relacionado (úsalo para enlazar o obtener detalles en tu aplicación).
- name, bodyPart, target: etiquetas para tarjetas de UI o chips de filtrado.
- equipment: restringe alternativas al equipo disponible en el gimnasio o en casa.
- gifUrl y videos: medios para guiar la forma y técnica.
2) Crear Programa (POST)
Inicia un programa y obtén inmediatamente la sesión de hoy. Puedes establecer una rutina predefinida (por ejemplo, muscle_gain_4 o weight_loss_3). Proporciona el identificador de tu cliente en client_id para mapear sesiones a tu objeto de usuario.
- Método: POST
- URL: https://zylalabs.com/api/392/exercise-database-api/34185/create-program
- Campo de cuerpo requerido: request_body (JSON en forma de cadena)
Curl copiable (nota que el JSON se pasa como una cadena dentro de request_body):
Ejemplo de respuesta oficial (verbatim):
[
"waist",
"upper legs",
"back",
"lower legs",
"chest",
"upper arms",
"cardio",
"shoulders",
"lower arms",
"neck"
]Qué usar:
- program_id y program_key: persiste estos para obtener futuras sesiones.
- session.exercises[] campos: renderiza el plan de hoy, incluyendo series, reps_min/reps_max, rest_seconds y weight_kg (kilogramos; puede ser nulo inicialmente).
- progression y why: muestra indicaciones de entrenamiento (por ejemplo, qué ajustar o registrar a continuación).
3) Entrenamiento de Hoy (GET)
Obtén la sesión de hoy para un programa almacenado. Usa el program_id y program_key que obtuviste de Crear Programa.
- Método: GET
- URL: https://zylalabs.com/api/392/exercise-database-api/34186/today-s-workout
- Parámetros de consulta requeridos: program (número), program_key (cadena)
Curl copiable:
Ejemplo de respuesta oficial (verbatim):
Qué usar:
- week, deload, comeback: muestra el contexto de entrenamiento (por ejemplo, semanas de volumen reducido).
- exercises[] con sets/reps/rest: impulsa tu UI de sesión y seguimiento.
- weight_kg y estimated_1rm_kg: soporta recomendaciones de carga o gráficos cuando estén disponibles.
4) Lista de Partes del Cuerpo (GET)
Un pequeño punto final de utilidad para sembrar filtros y navegación en tu UI de entrenamiento deportivo.
- Método: GET
- URL: https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts
MUESTRA OFICIAL (verbatim):
Caso de uso: renderiza un menú de facetas o desplegable que coincida con cómo la API categoriza los ejercicios, para que los usuarios puedan filtrar rápidamente el contenido de entrenamiento deportivo relevante.
Un ejemplo de código funcional (Python) para alternativas de “ejercicio por ID”
Este script llama a Alternativas de Ejercicio utilizando un ID de ejercicio y un filtro de equipo opcional, luego imprime una lista compacta que tu UI puede consumir. Utiliza el punto final y los campos exactos mostrados arriba.
import os
import requests
API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
BASE_URL = "https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives"
def get_alternatives(exercise_id, equipment=None):
params = {"id": exercise_id}
if equipment:
params["equipment"] = equipment
headers = {"Authorization": f"Bearer {API_KEY}"}
r = requests.get(BASE_URL, headers=headers, params=params, timeout=20)
r.raise_for_status()
return r.json()
if __name__ == "__main__":
# Ejemplo: alternativas para el ejercicio id=1, filtradas a barra
data = get_alternatives(1, equipment="barbell")
# Renderiza un resumen mínimo por ejercicio
for ex in data:
print(f"[{ex.get('id')}] {ex.get('name')} - {ex.get('target')} ({ex.get('equipment')})")
vids = ex.get("videos", [])[:2]
for v in vids:
print(f" - {v.get('title')}: {v.get('link')}")
print()Notas:
- La autorización es solo a través del encabezado: Authorization: Bearer YOUR_API_KEY.
- No se especifica paginación para este punto final; devuelve hasta 10 elementos.
- gifUrl y videos son campos de medios opcionales para mostrar en tu UI de entrenamiento.
Detalles de integración práctica que ahorran tiempo
- Autenticación: Todas las llamadas requieren Authorization: Bearer YOUR_API_KEY. Mantenlo fuera del código del lado del cliente si es posible.
- Unidades: los campos weight_kg están en kilogramos; rest_seconds está en segundos; las repeticiones son enteros con campos min/max.
- Cacheo: Listas estáticas (como partes del cuerpo) son buenos candidatos para el cacheo diario. Las alternativas dependen del ejercicio semilla y el equipo; cachea por par (id, equipment) para un TTL corto si tu aplicación carga esto con frecuencia durante una sesión de entrenamiento.
- Medios: gifUrl y videos[].link son adecuados para la visualización del cliente. Maneja la posibilidad de que weight_kg y estimated_1rm_kg puedan ser nulos al principio de un nuevo programa.
- Programas: Persiste tanto program_id como program_key. Necesitarás ambos para obtener el entrenamiento de hoy de manera confiable.
- Cuotas: El hub funciona con suscripción + cuota (no por llamada). Para la primera API, puedes usar una prueba de 7 días o 50 solicitudes para evaluar. Consulta el listado para las opciones de acceso y precios actuales.
Casos de uso de aplicaciones deportivas en el mundo real
- Sustituciones sobre la marcha: Si un rack está ocupado, llama a Alternativas de Ejercicio con el id del ejercicio original y el equipo disponible para mostrar 3–5 intercambios viables con el mismo movimiento o músculo objetivo.
- Sesiones programadas: Inicia el plan de un nuevo atleta con Crear Programa y renderiza la sesión devuelta de inmediato, incluyendo series, repeticiones y descanso.
- Pantalla de plan diario: Cada día, obtiene el Entrenamiento de Hoy para mostrar la próxima sesión, respetando las banderas de deload o comeback para contexto.
- Filtros de catálogo: Usa la lista de partes del cuerpo para implementar filtros de navegación que coincidan con la taxonomía de la API, manteniendo la búsqueda sincronizada con los datos subyacentes.
Llamando a la API de Base de Datos de Ejercicios desde un agente de IA (MCP)
Puedes ejecutar estos puntos finales desde cualquier cliente compatible con MCP (por ejemplo, Claude Code, Cursor, Windsurf) apuntando el cliente al punto final de MCP y proporcionando tu clave.
- Punto final de MCP: MCP
- Clave: apikey=YOUR_API_KEY
Desde tu agente, puedes indicarle que realice un GET en la URL de Alternativas de Ejercicio con id=1 y equipment=barbell, o hacer un POST a Crear Programa con la carga útil de request_body en forma de cadena. Esto es útil para semi-automatizar flujos de trabajo de entrenamiento, como “construir el día de empuje de hoy y reemplazar cualquier levantamiento solo de barra con alternativas de mancuernas.”
Ejemplo de flujo de trabajo: construir una sesión consciente de sustituciones
- Crea un programa a través de Crear Programa y almacena program_id y program_key en tu tabla de usuarios.
- Llama a Entrenamiento de Hoy cada día para listar ejercicios con series/repeticiones/descanso.
- Cuando el usuario toque “Encontrar alternativa”, llama a Alternativas de Ejercicio con el id del ejercicio fuente y el equipo actual del usuario (por ejemplo, “barra” o “peso corporal”).
- Cambia la tarjeta en la UI de sesión, preservando las series/repeticiones/descanso prescritos, y muestra gifUrl o videos para guiar al atleta.
Otra referencia rápida: Taxonomía de partes del cuerpo
Probablemente necesites una taxonomía simple y estable para los filtros de entrenamiento deportivo. Usa el punto final oficial “Lista de Partes del Cuerpo” para impulsar tu UI, como se mostró arriba. Mantener tus opciones de filtro idénticas a la lista de la API ayuda a evitar desajustes entre las entradas de búsqueda y los metadatos de ejercicio.
Ejemplo oficial: curl y JSON para partes del cuerpo
Para completar, aquí está la muestra oficial nuevamente en un solo lugar para copiar rápidamente durante la configuración:
FAQ
¿Cómo me autentico?
Envía Authorization: Bearer YOUR_API_KEY en cada solicitud.
¿Puedo obtener ejercicios similares a un ID específico?
Sí. Usa Alternativas de Ejercicio con el parámetro de consulta id, y opcionalmente equipment para restringir resultados.
¿Cómo obtengo el entrenamiento de hoy para un usuario?
Crea un programa con Crear Programa para obtener program_id y program_key. Luego llama a Entrenamiento de Hoy con ambos parámetros para recuperar la sesión actual.
¿Qué unidades se utilizan para pesos y descanso?
Los pesos están en kilogramos (weight_kg). El descanso está en segundos (rest_seconds).
¿Hay un plan gratuito?
Esta API funciona con suscripción + cuota con una prueba de 7 días disponible desde el listado. Consulta la página de la API para las opciones de acceso y precios actuales.
¿Listo para integrar flujos de “ejercicio por ID” en tu aplicación deportiva? Crea tu cuenta y comienza la prueba de 7 días en la página de listado: API de Base de Datos de Ejercicios. Estarás en funcionamiento con sustituciones, programas y sesiones diarias en minutos.
