Percentile Engine API

The Percentile Engine API lets you compare any measurable trait, fitness, physique, income, cognition, lifestyle, health, and more, against population-backed distributions to get your exact pcore, and plain-English verdict. Powered by 34 curated metrics across 9 categories with 50M+ data points from authoritative sources (CDC, ACSM, BLS, WHO, NIH, Running USA, and more).

原始信息汇总

Percentile Engine API 数据集详情

概述

Percentile Engine API 允许用户将任何可测量特征与人群分布进行比较，返回精确的百分位数、Z 分数以及通俗易懂的文字说明。该 API 涵盖 9 大类别共 34 个指标，基于超过 5000 万数据点，数据来源包括 CDC（美国疾病控制与预防中心）、ACSM（美国运动医学学会）、BLS（美国劳工统计局）、WHO（世界卫生组织）、NIH（美国国立卫生研究院）和 Running USA 等权威机构。除单指标分析外，还提供组合稀有度分析端点，可计算多指标组合的统计罕见性。

核心功能

• 34 个指标，9 大类别：跑步（6 个）、力量（4 个）、体态（4 个）、收入（2 个）、生活方式（5 个）、认知（5 个）、人口统计（2 个）、健康（4 个）、趣味（2 个），每个指标均附有权威数据来源。
• 百分位数与 Z 分数输出：返回百分位数排名、Z 分数、总体均值、总体标准差、样本量及文字说明。
• 组合稀有度分析：同时提交多个指标，计算“1 in N”的联合概率。
• 按年龄、性别和国家分段：支持按年龄、性别（male、female 或 all）及国家进行数据分析。
• 超过 5000 万数据点：数据来源包括 CDC NHANES、Running USA、ACSM FRIEND Registry、NSCA/ExRx.net、BLS、美联储 SCF、WAIS-V 等。
• 批量处理：单次请求可分析多个指标。
• 测试样本生成：生成随机测试样本用于开发和验证。
• 高可用性：根据套餐不同，速率限制从 10 次/分钟到 300 次/分钟不等。

适用场景

• 健身应用
• 健康与保健平台
• 人力资源与招聘工具
• 个人财务应用
• 社交与交友产品
• 内容与互动功能
• 研究与数据可视化

接口文档

• 基础 URL：https://api-gateway-production.21truescarystories.workers.dev
• 认证方式：通过 x-api-key 请求头传递从 RapidAPI 获取的 API 密钥。

端点

1. 分析单个指标（POST /v1/percentileengine/analyze）
   • 提交单个指标值进行百分位数分析。
2. 批量分析指标（POST /v1/percentileengine/analyze/batch）
   • 在单次请求中分析多个指标。
3. 组合稀有度分析（POST /v1/percentileengine/combo）
   • 计算多指标组合的联合统计罕见性。
4. 运行测试场景（POST /v1/percentileengine/test）
   • 生成随机测试样本。
5. 列出指标（GET /v1/percentileengine/metrics）
   • 获取全部 34 个可用指标及其类别、单位、支持的分段（年龄、性别、国家）和数据来源。

状态码

• 200 OK：请求成功。
• 400 Bad Request：输入无效。
• 401 Unauthorized：认证失败。
• 403 Forbidden：当前套餐无权访问端点。
• 404 Not Found：端点不存在。
• 429 Too Many Requests：超出速率限制。
• 500 Internal Server Error：服务器内部错误。
• 503 Service Unavailable：服务暂时不可用。

套餐与速率限制

套餐	价格	月请求数	速率限制
Free	$0	100	10 次/分钟
Starter	$29/月	5,000	60 次/分钟
Pro	$99/月	50,000	300 次/分钟
Enterprise	自定义	无限	自定义

常见问题

• 指标标识符：调用 GET /v1/percentileengine/metrics 获取完整列表。
• 百分位数与 Z 分数：percentile 表示低于或等于提交值的参考人群百分比；z_score 表示提交值偏离总体均值的标准差个数。
• 年龄和性别分段：若底层数据支持，包含 age 和 sex 参数将获得分段结果。
• 组合稀有度：假设各指标独立，相乘其百分位概率得到联合概率。
• 套餐限制：Free 套餐仅可访问 GET /metrics；Starter 套餐解锁 /analyze 和 /analyze/batch；Pro 及以上套餐可使用 /combo 和 /test。