# UFC API: Get fighter profile

> Finds a UFC fighter by name or nickname and returns their profile: record, ranking, physical details, win methods and fight statistics. Missing profile values are null.

Unofficial. Not affiliated with or endorsed by UFC.

- Page: https://fous.com/methods/ufc.com/get-fighter
- Method: `ufc.com/get_fighter`, version 2
- Website: ufc.com
- Returns: name, nickname, division, ranking, record, bio, win methods, striking and takedown stats, photo, UFC link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `fighter` | string | yes | `"The Eagle"` | Fighter name or nickname, for example Jon Jones or Bones. |

## Output

From a run on Oct 26, 2026. Its input:

```json
{
  "fighter": "The Eagle"
}
```

Its output:

```json
{
  "age": 34,
  "name": "Khabib Nurmagomedov",
  "wins": 29,
  "draws": 0,
  "height": "5 ft 10 in",
  "losses": 0,
  "record": "29-0-0",
  "status": "retired",
  "division": "Lightweight",
  "hometown": "Dagestan Republic, Russia",
  "nickname": "The Eagle",
  "ufc_link": "https://www.ufc.com/athlete/khabib-nurmagomedov",
  "reach_inches": 70,
  "weight_pounds": 155,
  "fighting_style": null,
  "current_ranking": null,
  "photo_image_link": "https://ufc.com/images/styles/athlete_bio_full_body/s3/image/fighter_images/Khabib_Nurmagomedov/1NURMAGOMEDOV_KHABIB_L.png?itok=CcyXygi6",
  "wins_by_decision": 10,
  "wins_by_knockout": 8,
  "wins_by_submission": 11,
  "takedowns_per_15_minutes": 5.32,
  "striking_accuracy_percent": 49,
  "significant_strikes_landed_per_minute": 4.1
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"ufc.com/get_fighter","input":{"fighter":"The Eagle"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What's Islam Makhachev's current record and ranking?
- Pull up the fighter profile for 'The Notorious' on ufc.com — I want his win methods and striking accuracy.
- How tall is Alex Pereira and what's his reach? Also show his takedown defense stats.
- I need Zhang Weili's bio, division, and how many of her wins came by KO vs submission.
- Look up Sean O'Malley on UFC and give me his significant strikes landed per minute plus a photo link.

## Input schema

```json
{
  "type": "object",
  "required": [
    "fighter"
  ],
  "properties": {
    "fighter": {
      "type": "string",
      "minLength": 1,
      "description": "Fighter name or nickname, for example Jon Jones or Bones."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "name",
    "nickname",
    "division",
    "current_ranking",
    "record",
    "wins",
    "losses",
    "draws",
    "status",
    "age",
    "height",
    "weight_pounds",
    "reach_inches",
    "fighting_style",
    "hometown",
    "wins_by_knockout",
    "wins_by_submission",
    "wins_by_decision",
    "significant_strikes_landed_per_minute",
    "striking_accuracy_percent",
    "takedowns_per_15_minutes",
    "photo_image_link",
    "ufc_link"
  ],
  "properties": {
    "age": {
      "type": [
        "integer",
        "null"
      ]
    },
    "name": {
      "type": [
        "string",
        "null"
      ]
    },
    "wins": {
      "type": [
        "integer",
        "null"
      ]
    },
    "draws": {
      "type": [
        "integer",
        "null"
      ]
    },
    "height": {
      "type": [
        "string",
        "null"
      ]
    },
    "losses": {
      "type": [
        "integer",
        "null"
      ]
    },
    "record": {
      "type": [
        "string",
        "null"
      ]
    },
    "status": {
      "type": [
        "string",
        "null"
      ]
    },
    "division": {
      "type": [
        "string",
        "null"
      ]
    },
    "hometown": {
      "type": [
        "string",
        "null"
      ]
    },
    "nickname": {
      "type": [
        "string",
        "null"
      ]
    },
    "ufc_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "reach_inches": {
      "type": [
        "number",
        "null"
      ]
    },
    "weight_pounds": {
      "type": [
        "number",
        "null"
      ]
    },
    "fighting_style": {
      "type": [
        "string",
        "null"
      ]
    },
    "current_ranking": {
      "type": [
        "string",
        "null"
      ]
    },
    "photo_image_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "wins_by_decision": {
      "type": [
        "integer",
        "null"
      ]
    },
    "wins_by_knockout": {
      "type": [
        "integer",
        "null"
      ]
    },
    "wins_by_submission": {
      "type": [
        "integer",
        "null"
      ]
    },
    "takedowns_per_15_minutes": {
      "type": [
        "number",
        "null"
      ]
    },
    "striking_accuracy_percent": {
      "type": [
        "integer",
        "null"
      ]
    },
    "significant_strikes_landed_per_minute": {
      "type": [
        "number",
        "null"
      ]
    }
  }
}
```

## See more

- [UFC API: List events](https://fous.com/methods/ufc.com/list-events.md): Lists upcoming or past UFC events with fight cards, venue, start time and completed bout results, or returns one event by name. Upcoming events come soonest first and past events newest first.
- [NBA API: Get player by name](https://fous.com/methods/nba.com/get-player.md): Looks up an NBA player by name, including retired players, and returns the bio and regular-season per-game averages for the reported season and career.
- [Cricbuzz API: Get cricketer profile](https://fous.com/methods/cricbuzz.com/get-player.md): Finds a cricketer on Cricbuzz by name, optionally narrowed by country. Returns the profile, current ICC rankings and career statistics.
- [Chess.com API: Get player stats](https://fous.com/methods/chess.com/get-player-stats.md): Gets a Chess.com player's public profile, ratings and game records, best puzzle rating and Puzzle Rush best score from a username or member profile link.
- [NHL API: Get player stats](https://fous.com/methods/nhl.com/get-player-stats.md): Looks up an NHL player by name, link or ID and returns the profile with regular-season stats for a season and career totals.
- [Premier League API: Get player stats](https://fous.com/methods/premierleague.com/get-player-stats.md): Looks up a Premier League player by name and returns the profile and either career totals or the stats for a chosen season. If names clash, a current Premier League player is preferred.
- [NFL API: Get player stats](https://fous.com/methods/nfl.com/get-player-stats.md): Gets a named NFL player's season and career stats, with profile details. Active players are preferred when names match.
- [American Kennel Club API: Get dog breed](https://fous.com/methods/akc.org/get-dog-breed.md): Gets an AKC dog breed profile by name or common nickname, with measurements, temperament, trait ratings, photo and profile link.
- [All UFC methods](https://fous.com/methods/ufc.com.md)
