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 endpoints
| Method | Endpoint | Description |
|---|---|---|
| Metrics | ||
| GET |
listMetrics /v1/percentileengine/metrics |
Returns all 34 metrics with their categories, units, data sources, and sample sizes. Use this to discover valid metric IDs for the analyze endpoints. |
| Analysis | ||
| POST |
analyzeCombo /v1/percentileengine/combo |
Calculate the combined probability of having all submitted metric values simultaneously, assuming independence. Returns a "1 in N" rarity score. Submit at least 2 and up to 20… |
| POST |
analyzeBatch /v1/percentileengine/analyze/batch |
Analyze up to 100 metrics in a single request. Each query follows the same schema as the single /analyze endpoint. Returns results in the same order as submitted. |
| POST |
analyzeMetric /v1/percentileengine/analyze |
Submit a metric ID and your value to receive your percentile rank, z-score, population statistics, and a plain-English verdict. The API auto-detects the appropriate demographic… |
| Utility | ||
| POST |
testSamples /v1/percentileengine/test |
Generate random realistic metric values and analyze them. Useful for testing, demos, and exploration without needing real data. Values are sampled from realistic distributions… |
Percentile Engine API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 10 / minute |
|
| PRO | $29 / month | 60 / minute |
|
| ULTRA | $99 / month | 300 / minute |
|
| MEGA | $299 / month | 1000 / minute |
|