oktagonmma.com APIoktagonmma.com ↗
Access OKTAGON MMA fighter profiles, records, rankings, fight history, and weight class data via 4 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/36854270-8f1b-4f95-9a0c-7057bcb4e2a7/list_fighters?lang=en&skip=0&limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
List fighters with pagination and optional weight class filtering. Returns basic fighter information including name, record, weight class, nationality, and image.
| Param | Type | Description |
|---|---|---|
| skip | integer | Number of fighters to skip for pagination. |
| limit | integer | Number of fighters to return (max 100). |
| weight_class_id | integer | Filter by weight class ID (1=Welterweight, 2=Middleweight, 3=Light Heavyweight, 5=Heavyweight, 6=Bantamweight). |
{
"type": "object",
"fields": {
"fighters": "array of fighter objects with id, full_name, record, weight_class, nationality, and other profile fields",
"pagination": "object with limit, skip, and count keys"
},
"sample": {
"data": {
"fighters": [
{
"id": 1009,
"gym": "Elite-Fitzone ",
"slug": "bedirhan-kabak",
"links": {
"sherdog": "https://www.sherdog.com/fighter/Bedirhan-Kabak-451293",
"tapology": "https://www.tapology.com/fightcenter/fighters/428088-bedirhan-kabak",
"instagram": "https://www.instagram.com/bedirhan.k74/"
},
"record": {
"wins": 1,
"draws": 0,
"losses": 0,
"no_contests": 0
},
"champion": false,
"nickname": null,
"rankings": [],
"full_name": "Bedirhan Kabak",
"height_cm": 177,
"image_url": "https://assets.oktagonmma.com/FIGHTER_PROFILE_IMAGE/18e9e8d1-d413-4081-aef2-6e3674878855/cs.1778155106437.png",
"last_name": "Kabak",
"first_name": "Bedirhan ",
"description": "<p>Bedirhan Kabak enters OKTAGON as an undefeated prospect with a 1-0 record.</p>",
"nationality": "DE",
"weight_class": "Welterweight",
"year_of_birth": 2001,
"other_rankings": [],
"weight_class_id": 1
}
],
"pagination": {
"skip": 0,
"count": 5,
"limit": 5
}
},
"status": "success"
}
}About the oktagonmma.com API
The OKTAGON MMA API provides access to fighter data from Europe's leading MMA promotion through 4 endpoints. Use list_fighters to browse the roster with weight class filtering, get_fighter to retrieve a full profile including gym affiliation, rankings, height, and links to Sherdog and Tapology, and get_fighter_fight_history to pull per-fight outcomes, result types, and event details for any fighter on the roster.
Fighter Roster and Filtering
The list_fighters endpoint returns paginated fighter objects, each containing id, full_name, record, weight_class, nationality, and image_url. You can filter by division using the weight_class_id parameter — accepted values map to Welterweight (1), Middleweight (2), Light Heavyweight (3), Heavyweight (5), and Bantamweight (6). Pagination is controlled with skip and limit (max 100 per request), and the response includes a pagination object with count, skip, and limit fields.
Detailed Fighter Profiles
get_fighter accepts a single fighter_id and returns the full profile: gym, nickname, height_cm, champion (boolean indicating current title status), rankings (array of division positions), and a links object with external references to Sherdog, Tapology, and Instagram. The record field breaks down wins, losses, draws, and no contests.
Fight History
get_fighter_fight_history returns a fights array for the specified fighter, where each entry includes outcome, opponent, event, result_type (e.g. KO, submission, decision), and time. The optional limit parameter caps the number of fights returned. Fighters who have not competed under the OKTAGON banner will return an empty fights array with count: 0.
Full Roster Export
get_all_fighters iterates through all available pages and returns every fighter on the OKTAGON roster in a single response under a fighters array with a total count. This endpoint performs multiple paginated fetches internally and may take several seconds to resolve.
- Build a fighter comparison tool using
record,height_cm,weight_class, andrankingsfromget_fighter - Track divisional standings by querying
list_fighterswith eachweight_class_idand sorting by ranking position - Populate a fan app's fighter directory using
get_all_fightersfor full roster data with profile images - Analyze finish rates by iterating
get_fighter_fight_historyacross multiple fighters and aggregatingresult_typevalues - Cross-reference OKTAGON fighters on Sherdog or Tapology using the
linksobject returned byget_fighter - Identify current champions by filtering
get_all_fightersresults on thechampionboolean field - Monitor fighter gym affiliations and nationality distribution across weight classes using roster data
| 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 OKTAGON MMA have an official developer API?+
How does weight class filtering work in `list_fighters`?+
weight_class_id integer as a query parameter. The supported mappings are: 1 = Welterweight, 2 = Middleweight, 3 = Light Heavyweight, 5 = Heavyweight, and 6 = Bantamweight. Omitting the parameter returns fighters across all divisions. Note that weight class IDs are not consecutive — there is no ID 4 in the current set.What happens when a fighter has no OKTAGON fights recorded?+
get_fighter_fight_history will return a valid response with count: 0 and an empty fights array. This can occur for recently signed fighters or those whose records have not yet been logged under the OKTAGON banner.Does the API return upcoming scheduled fights or event schedules?+
Are fight statistics like significant strikes or takedown numbers available?+
outcome, opponent, event, result_type, and time, but do not include in-fight strike or grappling statistics. You can fork this API on Parse and revise it to add per-fight statistical breakdowns if that data becomes accessible from the source.