ufc.com APIwww.ufc.com ↗
Get current UFC fighter rankings by weight class division via API. Returns champion and top 15 ranked fighters for all divisions from ufc.com.
curl -X GET 'https://api.parse.bot/scraper/351d3f8b-3936-4b8b-8171-322fa6d97132/get_rankings?division=heavyweight' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all UFC fighter rankings by weight class division. Returns champion and ranked fighters (1-15) for each division. Optionally filter by division name using case-insensitive substring matching.
| Param | Type | Description |
|---|---|---|
| division | string | Filter by division name (case-insensitive substring match). Matches include 'heavyweight', 'flyweight', 'bantamweight', 'featherweight', 'lightweight', 'welterweight', 'middleweight', 'pound-for-pound', 'women'. Returns all divisions if omitted. |
{
"type": "object",
"fields": {
"divisions": "array of division objects, each with: division (string - division name), champion (string or null - current champion name), ranked_fighters (array of objects with rank (integer) and name (string))",
"total_divisions": "integer - number of divisions returned"
},
"sample": {
"data": {
"divisions": [
{
"champion": "Carlos Ulberg",
"division": "Light Heavyweight",
"ranked_fighters": [
{
"name": "Magomed Ankalaev",
"rank": 1
},
{
"name": "Alex Pereira",
"rank": 2
},
{
"name": "Jiří Procházka",
"rank": 3
}
]
},
{
"champion": "Tom Aspinall",
"division": "Heavyweight",
"ranked_fighters": [
{
"name": "Ciryl Gane",
"rank": 1
},
{
"name": "Alexander Volkov",
"rank": 2
},
{
"name": "Sergei Pavlovich",
"rank": 3
}
]
}
],
"total_divisions": 2
},
"status": "success"
}
}About the ufc.com API
The UFC Rankings API exposes one endpoint — get_rankings — that returns fighter standings across all UFC weight class divisions, with each division object including the current champion and up to 15 ranked contenders. The response covers fields like division name, champion name, and a ranked array of fighters, giving developers a structured snapshot of the official UFC rankings as published on ufc.com.
What the API Returns
The get_rankings endpoint returns an array of division objects sourced from the official UFC rankings page at ufc.com/rankings. Each division object contains three fields: division (the weight class name, e.g. "Heavyweight" or "Women's Strawweight"), champion (the current titleholder's name as a string, or null if the belt is vacant), and ranked (an ordered array of fighter names from position 1 through 15). The top-level response also includes total_divisions, which reflects how many divisions were returned for a given query.
Filtering by Division
The optional division parameter accepts a case-insensitive substring string, so passing "fly" will match both "Flyweight" and "Women's Flyweight". Passing "heavyweight" returns only the Heavyweight division. When the parameter is omitted, all divisions are returned. This makes it straightforward to scope a request to a single weight class without client-side filtering.
Coverage and Freshness
The API reflects the rankings as they appear on ufc.com, which UFC typically updates on a weekly basis following events. All divisions with an active ranking appear in the response — including women's divisions and pound-for-pound rankings if they are present on the source page. The champion field will be null for any division where no titleholder is currently listed.
- Display a live UFC rankings table in a sports app, organized by division with champion highlighted
- Track week-over-week movement of a specific fighter through the
rankedarray across divisions - Build a fighter comparison tool that pulls two contenders from the same division's ranked list
- Power a fantasy MMA draft interface that surfaces only top-15 fighters per weight class
- Alert users when the
championfield for their followed division changes after a title fight - Filter pound-for-pound or women's divisions specifically using the
divisionsubstring parameter
| 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 UFC have an official public developer API?+
What does the `ranked` array in each division contain?+
ranked field is an ordered array of fighter name strings, starting from position 1 (top contender) down to position 15. The ordering matches the official UFC rankings for that division. The array may contain fewer than 15 entries if fewer fighters are ranked in that division at the time of the request.