UFC APIufc.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.
What is the UFC 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.
curl -X GET 'https://api.parse.bot/scraper/351d3f8b-3936-4b8b-8171-322fa6d97132/get_rankings?division=heavyweight' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ufc-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.ufc_fighter_rankings_api import UFC, Division, RankedFighter
ufc = UFC()
# List all divisions and print champion info
for division in ufc.divisions.list():
print(division.division, division.champion)
for fighter in division.ranked_fighters:
print(fighter.rank, fighter.name)
# Filter to heavyweight divisions only
for division in ufc.divisions.list(division="heavyweight"):
print(division.division, division.champion, len(division.ranked_fighters))
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. A filter of 'heavyweight' matches both 'Heavyweight' and 'Light Heavyweight'. A filter of 'women' matches all women's divisions. Returns all 13 divisions when no filter is specified.
| Param | Type | Description |
|---|---|---|
| division | string | Filter by division name (case-insensitive substring match). Common values: '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 API
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.
The UFC API is a managed, monitored endpoint for ufc.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ufc.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ufc.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.