milesplit.com APImilesplit.com ↗
Access MileSplit high school track and field rankings by state, event, and year. Returns top 20 athlete or team rankings with meet, wind, and grade data.
curl -X GET 'https://api.parse.bot/scraper/56c1c198-91ee-47af-88fa-30620f68ee68/get_rankings?year=2024&event=100m&state=TX' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the top 20 rankings for a specific high school boys outdoor track and field event in a given state and year. For relay events (e.g. 4x400m), returns team-level rankings. For individual events (e.g. 100m, 1600m), returns athlete-level rankings including team, wind, and graduation year where available.
| Param | Type | Description |
|---|---|---|
| year | string | Year for rankings (e.g. 2022, 2023). |
| event | string | Event name as it appears in MileSplit URLs. Confirmed working values include: 100m, 200m, 400m, 800m, 1600m, 3200m, 4x100m, 4x400m, 4x800m. |
| state | string | Two-letter US state code (e.g. OH, CA, TX). Used as the MileSplit state subdomain. |
{
"type": "object",
"fields": {
"rankings": "array of ranking entries, each containing rank, team, meet, and optionally athlete, wind, and grade (graduation year) for individual events"
},
"sample": {
"data": {
"rankings": [
{
"meet": "AAU Junior Olympics Games",
"rank": "1",
"team": "Ohio Heat"
},
{
"meet": "OHSAA Div 1 State Track and Field Championship",
"rank": "2",
"team": "Thom. Worthington"
}
]
},
"status": "success"
}
}About the milesplit.com API
The MileSplit API provides one endpoint — get_rankings — that returns the top 20 high school boys outdoor track and field rankings for a given state, event, and year. Each response includes up to 7 fields per entry: rank, athlete or team name, school, meet, wind reading, and graduation year (grade). Data covers individual sprint and distance events as well as relay events across all 50 US states.
What the API Returns
The get_rankings endpoint accepts three optional parameters: state (two-letter US state code), event (event slug as it appears in MileSplit URLs), and year. It returns an array of up to 20 ranking entries. For individual events such as 100m, 200m, 400m, 800m, or 1600m, each entry includes the athlete's name, team (school), meet name, wind reading, and grade (graduation year). For relay events such as 4x400m, entries shift to team-level data with team name and meet, omitting individual athlete fields.
Response Fields and Coverage
Each ranking entry in the rankings array carries a rank integer, a team string, and a meet string. Individual-event entries additionally expose athlete (the athlete's name), wind (wind speed in m/s), and grade (graduation year, e.g. '25). Performance times — the actual marks — are gated by MileSplit for non-authenticated users and are not included in the response. Coverage spans all US states via the state parameter and multiple confirmed events including 100m, 200m, 400m, 800m, 1600m, and relay distances.
Limitations to Know
The API currently covers boys outdoor track and field only, and the event list is limited to confirmed working slugs. Rankings are scoped to state-level — there is no national leaderboard endpoint. The response is fixed at a maximum of 20 entries per call, with no pagination support. Exact performance marks (times, distances) are not returned due to MileSplit's authentication wall for that data.
- Build a state-by-state comparison tool for high school sprint rankings using the
stateandeventparameters. - Track which teams appear most frequently across relay event rankings in a given year.
- Display top-20 athlete leaderboards for a high school sports recruiting dashboard.
- Identify which meets produce the most top-ranked performances by aggregating the
meetfield across events. - Monitor year-over-year ranking trends for a specific state and event combination.
- Filter rankings by graduation year (
grade) to surface underclassmen performers for scouting.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does MileSplit have an official developer API?+
What does `get_rankings` return differently for relay events versus individual events?+
4x400m), each entry in the rankings array contains rank, team, and meet — no individual athlete name, wind, or grade. For individual events (e.g. 100m, 1600m), the same array also includes athlete, wind, and grade fields per entry.Are actual performance times (e.g. 10.45 seconds) included in the response?+
Does the API cover girls events, indoor track, or field events like shot put or high jump?+
Is there a national rankings endpoint, or are results always state-scoped?+
state parameter. There is no national leaderboard endpoint at this time. You can fork the API on Parse and revise it to aggregate across states or add a national rankings endpoint.