Exo-Spare

1,300 exercises for fitness and workout apps: muscles, equipment, instructions, illustrations and muscle maps, with a clear licence and credit on every item.

原始信息汇总

Exo-Spare 数据集概述

基本信息

• 数据集名称：Exo-Spare
• API 版本：v1.0.1（当前版本）
• 类别：Sports（运动）
• API 创建者：Melik Erdem
• 订阅者数量：1
• 详情页地址：https://rapidapi.com/daimaileri20/api/exo-spare

性能指标

• 流行度：8.7
• 服务等级：100%
• 延迟：211ms
• 测试通过率：43%

订阅计划

计划	价格
BASIC	$0.00
PRO	$4.99

数据集内容

• 规模：1,300 个身体练习
• 分类构成：
  • 力量（strength）：1,076 个
  • 灵活性（mobility）：76 个
  • 拉伸（stretches）：69 个
  • 有氧（cardio）：56 个
  • 增强式（plyometric）：14 个
  • 平衡（balance）：9 个
• 肌肉与器材：主要与次要肌肉来自 28 个肌肉列表，器材来自 25 个器材列表，另含身体部位与类别；其中 329 个练习无需任何器材
• 难度：每个练习均有难度标注（初级 901、中级 347、高级 52），以及力学类型（复合/孤立）和发力类型（推/拉/静态）
• 说明文本：每个练习均有英文说明；802 个为三步及以上步骤，其余为一到两段
• 多语言：632 个练习有其他语言版本——西班牙语 608、德语 580、法语 549、意大利语 129、葡萄牙语 62、荷兰语 48，以及阿拉伯语、希腊语、印尼语、中文、捷克语、土耳其语各 29 至 47 个
• 搜索：支持名称、别名、肌肉和器材搜索，具备即时补全和容错拼写功能
• 筛选：支持组合筛选，包括 available_equipment（依据用户拥有的器材）
• 替代动作：支持为练习提供替代动作（"替换此练习"按钮）
• 分页：所有计划（含免费计划）每页最多 100 个练习

图像资源

• 573 张线稿插图，覆盖 286 个练习，通常为起始与结束姿势；全部提供 PNG 格式，其中 535 张另提供 SVG 格式
• 1,293 个练习的肌肉图：正面与背面人体图，主要肌肉用深色、次要肌肉用浅色；提供 SVG（正面、背面或两者）与 PNG 格式
• 按需肌肉图：可为任意肌肉组合生成
• 无动画、视频或照片；约五分之一的练习配有插图，几乎所有练习都有肌肉图
• 图像链接指向自有主机，无需密钥、无水印、不过期、可存储

许可与署名

内容来源于开放资源，每项保留其作者选择的许可：

• Longhaul Fitness（MIT License）：401 个练习的英文文本
• Everkinetic（CC BY-SA 4.0）：230 个练习的英文文本及全部 573 张插图
• wger（CC BY-SA 4.0 与 3.0，部分文本 CC0 1.0）：669 个练习的英文文本及全部翻译
• react-body-highlighter（MIT License）：肌肉图所用的人体模型

本 API 自身新增内容（肌肉与器材列表、id、难度/力学/发力取值）采用 CC0 1.0；其绘制的肌肉图采用 MIT License。

使用要点：

• 可存储与复用所获内容（含商业产品）
• 需展示每条文本与插图的署名行
• Share-alike 仅针对修改版本
• 如需非 share-alike 文本，可添加 text_license=MIT,CC0-1.0（417 个练习具备此类英文文本）

端点（Endpoints）

Exercises

• GET /v1/exercises：列表、搜索与筛选
• GET /v1/exercises/{id_or_slug}：按 id 或 slug 获取单个练习
• GET /v1/exercises/{id_or_slug}/alternatives：可替换该练习的动作
• GET /v1/exercises/random：随机选取，可用 seed 复现

Vocabulary

• GET /v1/muscles、/v1/equipment、/v1/body-parts、/v1/categories：筛选值及各值对应练习数
• GET /v1/facets：在已设筛选条件下各筛选值的练习数
• GET /v1/languages：有文本的语言

Images

• GET /v1/muscle-map.svg：按指定肌肉绘制肌肉图
• GET /media/...：练习对象所链接的插图与肌肉图

Licences and status

• GET /v1/licenses：目录中的许可及其要求
• GET /v1/attribution：来源及用于致谢页的现成文本
• GET /v1/status：数据集版本及其计数
• GET /v1/export：一次性导出全部目录（付费计划）

ExerciseDB 兼容路由

以下路径以相同路径、相同字段名、相同值列表应答：/exercises、/exercises/exercise/{id}、/exercises/bodyPart/{bodyPart}、/exercises/equipment/{equipment}、/exercises/target/{target}、/exercises/name/{name}、/exercises/bodyPartList、/exercises/equipmentList、/exercises/targetList、/image、/status。

差异：

• 内容为本目录自有，练习与 id 不同（id 形如 ex_e7d94552）
• 图像为 PNG 绘图与肌肉图，非动画
• 无计划限制为 10 项，limit 取 0 至 100，limit=0 返回全部（这些路由下为 1,295 个练习）
• 未知 id 返回 404
• 每个练习另含 imageUrl、images、credit、imageCredit、license 字段

数据字段（练习对象示例）

GET /v1/exercises/barbell-bench-press 返回的 data 对象包含：

• id、slug、name、aliases
• category、body_part、difficulty、mechanic、force
• muscles（primary / secondary）、equipment、language
• instructions、text_attribution
• images、muscle_map
• languages、variations、provenance、completeness

筛选参数（/v1/exercises）

• q：搜索词，每个词均需匹配，末词可为词首
• muscle：主要或次要肌肉；primary_muscle 仅匹配主要肌肉
• equipment：练习使用其中至少一种器材
• available_equipment：练习不在此列表之外需要器材；bodyweight 始终视为可用
• body_part、category、difficulty、mechanic、force：每个可取一个或多个值
• has_image：true/false
• has_language：仅含该语言文本的练习
• lang：应答语言
• text_license：文本许可，例如 MIT,CC0-1.0
• ids：单次调用最多 100 个 id 或 slug
• sort：relevance、completeness、name、-name、difficulty、-difficulty
• limit（1 至 100，默认 20）、offset、fields

同一参数多个值扩大结果，不同参数收窄结果；值以逗号分隔且忽略大小写；不存在的值返回 400 并给出最接近的有效值。

其他说明

• 错误格式：统一为 {"error": {...}}；未知 id 返回 404，已撤下练习返回 410
• 未知参数：被忽略并列入 meta.ignored_parameters
• 缓存：应答带 ETag 与 Cache-Control: private, max-age=3600；随机选取不缓存
• 数据版本：每个应答在 X-Dataset-Version 头与 meta.dataset_version 中标注版本
• 按需肌肉图：有每分钟与每地址的调用限制，超出返回 429 及 Retry-After
• 计划：免费计划含除导出外的全部端点，付费计划新增导出；无计划限制页大小或图像大小
• 数据更新：计划约每季度发布一次数据版本
• 安全提示：练习说明为一般信息，非医疗建议
• 支持：通过 Discussions 标签、Contact 按钮或邮箱 [e-mail] 联系，两个工作日内回复