Access Tiers
| Tier | What you get | Key type |
|---|---|---|
| Browser | Full interactive rankings UI. Sortable, filterable, paginated. No programmatic API access. | UI key |
| API | Full JSON API access plus browser UI. Integrate rankings into your own applications. | API key |
To request access visit Get Access.
Quick Start
Include your key in the x-api-key header on every call.
Base URL
https://draft-scorer-494573951785.us-central1.run.app
First call
curl -H "x-api-key: YOUR_API_KEY" "https://draft-scorer-494573951785.us-central1.run.app/rankings?year=2026&position=WR&limit=5"
Endpoints
GET/health
Health check. No key required.
GET/rankingsBrowserAPI
Ranked prospects with predictions and probabilities. Accessible with both UI and API keys.
| Parameter | Type | Default | Description |
|---|---|---|---|
year optional | integer | 2026 | Draft year |
position optional | string | - | QB, RB, WR, TE, T, G, C, DE, DT, LB, CB, S |
confidence optional | string | - | high, medium, or low |
label optional | string | - | Star, Starter, or Dud |
limit optional | integer | 100 | Max results (1-500) |
offset optional | integer | 0 | Pagination offset |
GET/rankings/topAPI only
Top N prospects at each position.
| Parameter | Type | Default | Description |
|---|---|---|---|
year optional | integer | 2026 | Draft year |
n optional | integer | 10 | Top N per position (1-50) |
confidence_filter optional | string | high | high, medium, low, or all |
GET/yearsAPI only
List all draft years with available rankings.
GET/positionsAPI only
List all positions available for a given year.
Response Fields
| Field | Type | Description |
|---|---|---|
overall_rank | integer | Rank across all positions by p_star |
star_rank | integer | Rank within position group by p_star |
first_name | string | Prospect first name |
last_name | string | Prospect last name |
college | string | College or university |
position | string | Normalized position code |
predicted_label | string | Star, Starter, or Dud |
p_star | float | Probability of Star (0.0-1.0) |
p_starter | float | Probability of Starter (0.0-1.0) |
p_dud | float | Probability of Dud (0.0-1.0) |
confidence | string | high, medium, or low |
tier | string | Key tier used: ui or api |
p_star + p_starter + p_dud = 1.0 for every prospect. Your API key is personal and non-transferable. See Terms of Service.
Error Codes
| HTTP Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Bad request - check parameter values |
| 401 | Unauthorized - API key missing or invalid |
| 403 | Forbidden - endpoint requires API-tier key |
| 404 | Not found - no rankings for that year or position |
| 500 | Server error - contact support |