Sherdog Scraper – UFC & MMA Fighter Records, Fight History avatar

Sherdog Scraper – UFC & MMA Fighter Records, Fight History

Pricing

from $1.00 / 1,000 results

Go to Apify Store
Sherdog Scraper – UFC & MMA Fighter Records, Fight History

Sherdog Scraper – UFC & MMA Fighter Records, Fight History

Scrape Sherdog fighter profiles, full fight histories and UFC event cards: records, win methods, streaks, title fights, upcoming bouts. Search by name, weight class or gym, or paste fighter, event and promotion URLs. From $1 per 1,000 results.

Pricing

from $1.00 / 1,000 results

Rating

0.0

(0)

Developer

Richard Biroš

Richard Biroš

Maintained by Community

Actor stats

1

Bookmarked

38

Total users

1

Monthly active users

11 days ago

Last modified

Categories

Features

Limited permissions

Share

Get MMA fighter records and complete fight histories from Sherdog, the largest MMA database. It covers UFC, PFL, Bellator, ONE, Rizin and hundreds of regional promotions back to the 1990s.

From $1 per 1,000 results. No login, no API key.

What you can do with it

  • Get a fight card as a table. Paste an event URL and get every bout: fighters, winner, method, round, title fights, upcoming bouts.
  • Follow a promotion. Paste a UFC, PFL or ONE URL and get its upcoming cards and latest results.
  • Prepare a fight card. Get the record and history of every fighter on a card.
  • Build MMA datasets. Get one row per fight, ready for Excel, pandas or a prediction model.
  • Track fighters. Get each fighter's current streak, last fight and next scheduled fight.
  • Scout a gym or division. Search by weight class or gym and get every fighter listed.

Input

Give the Actor fighter, event or organization URLs, a search, or both. The URL decides where the data comes from; outputType decides what you get back:

URL or searchfighters (default)fights
Fighter URL, searchThe fighterEvery fight in the fighter's history
Event URLEvery fighter on the cardEvery bout on the card
Organization URLEvery fighter on the selected cardsEvery bout on the selected cards
FieldWhat it does
startUrlsSherdog fighter URLs (https://www.sherdog.com/fighter/Jon-Jones-27944), event URLs (https://www.sherdog.com/events/UFC-309-Jones-vs-Miocic-103896) or organization URLs (https://www.sherdog.com/organizations/Ultimate-Fighting-Championship-UFC-2).
searchTermPart of a fighter's name or nickname, for example McGregor.
weightClassSearch one weight class (code, see below).
associationSearch one gym or team, for example American Top Team.
resultsLimitMaximum fighters from the search. Default 10. Does not limit URLs.
maxEventsOrganization URLs only. How many completed events to take, newest first. Default 10. All upcoming events are always included.
outputTypefighters (default) or fights. See the table above.
dateFromYYYY-MM-DD. Organization URLs: only completed events on or after this date. Fighters with fights: only fights on or after this date.
includeAmateurFighter URLs and search with fights only. Set to false to leave out amateur fights. Default true.

Weight class codes: Super Heavyweight 1, Heavyweight 2, Light Heavyweight 3, Middleweight 4, Welterweight 5, Lightweight 6, Featherweight 7, Bantamweight 9, Flyweight 10, Catchweight 11, Strawweight 13, Atomweight 15, Minimumweight 17.

Examples

Every UFC bout since 1 January 2025, plus all upcoming UFC cards:

{
"startUrls": [{ "url": "https://www.sherdog.com/organizations/Ultimate-Fighting-Championship-UFC-2" }],
"outputType": "fights",
"dateFrom": "2025-01-01",
"maxEvents": 100
}

Every fighter on the UFC 309 card, with their full fight histories:

{ "startUrls": [{ "url": "https://www.sherdog.com/events/UFC-309-Jones-vs-Miocic-103896" }] }

The first 50 lightweights:

{ "weightClass": "6", "resultsLimit": 50 }

Output

Results are in the run's default dataset. Download them as JSON, CSV, Excel or HTML, or read them through the Apify API. In Apify Console, the Output tab has three views: Fighters, Fighter fights and Event bouts. Pick the one that matches your outputType and URLs.

Every field has a description and an example in the Actor's dataset schema, so AI agents and API clients can read the output format without running the Actor.

One row per fighter (outputType: "fighters")

{
"sherdogId": "29688",
"profileUrl": "https://www.sherdog.com/fighter/Conor-McGregor-29688",
"name": "Conor McGregor",
"nickname": "Notorious",
"country": "Ireland",
"association": "SBG Ireland",
"weightClass": "Welterweight",
"record": "22-7-0",
"wins": 22, "losses": 7, "draws": 0, "noContests": 0,
"koWins": 19, "subWins": 1, "decWins": 2, "otherWins": 0,
"koLosses": 3, "subLosses": 4, "decLosses": 0, "otherLosses": 0,
"winRate": 0.759,
"finishRate": 0.909,
"currentStreak": { "type": "loss", "count": 3 },
"debutDate": "2008-03-08",
"lastFightDate": "2026-07-11",
"proFightCount": 29,
"amateurFightCount": 1,
"height": "5'8\"", "heightCm": 172.72,
"weightLbs": 170, "weightKg": 77.11,
"age": 38,
"birthDate": "1988-07-14",
"fighterImageUrl": "https://www.sherdog.com/image_crop/200/300/_images/fighter/20220325093124_Conor_McGregor_ff.JPG",
"upcomingFight": null,
"fightHistory": [
{
"division": "pro",
"result": "loss",
"opponentName": "Max Holloway",
"opponentId": "38671",
"opponentSherdogUrl": "https://www.sherdog.com/fighter/Max-Holloway-38671",
"eventName": "UFC 329 - McGregor vs. Holloway 2",
"eventId": "111889",
"eventSherdogUrl": "https://www.sherdog.com/events/UFC-329-McGregor-vs-Holloway-2-111889",
"eventDate": "2026-07-11",
"method": "TKO",
"methodCategory": "KO/TKO",
"methodDetail": "Knee Injury",
"refereeName": "Mike Beltran",
"refereeSherdogUrl": "https://www.sherdog.com/referee/Mike-Beltran-3",
"round": 1,
"time": "1:09",
"timeSeconds": 69
}
]
}

One row per fight, from fighters (outputType: "fights")

Each row has the same fields as a fightHistory item, plus fighterId, fighterName and fighterSherdogUrl.

One row per bout, from event and organization URLs (outputType: "fights")

{
"eventId": "103896",
"eventName": "UFC 309 - Jones vs. Miocic",
"eventSherdogUrl": "https://www.sherdog.com/events/UFC-309-Jones-vs-Miocic-103896",
"eventDate": "2024-11-16",
"organization": "Ultimate Fighting Championship (UFC)",
"location": "Madison Square Garden, New York, New York, United States",
"status": "completed",
"boutNumber": 12,
"isMainEvent": true,
"isTitleFight": true,
"weightClass": "Heavyweight",
"fighter1Name": "Jon Jones", "fighter1Id": "27944", "fighter1SherdogUrl": "https://www.sherdog.com/fighter/Jon-Jones-27944", "fighter1Result": "win",
"fighter2Name": "Stipe Miocic", "fighter2Id": "39537", "fighter2SherdogUrl": "https://www.sherdog.com/fighter/Stipe-Miocic-39537", "fighter2Result": "loss",
"winnerName": "Jon Jones",
"winnerId": "27944",
"method": "TKO",
"methodCategory": "KO/TKO",
"methodDetail": "Spinning Back Kick and Punches",
"refereeName": "Herb Dean",
"round": 3,
"time": "4:29",
"timeSeconds": 269
}
  • status: completed or upcoming. Upcoming bouts have no result, winner, method, round or time.
  • boutNumber: Sherdog's match number. The first bout of the night is 1; the main event has the highest number.
  • Fighters are in Sherdog's order. Use winnerName or winnerId for the winner; it is null for draws, no contests and upcoming bouts.

Field notes

  • division: pro, pro_exhibition or amateur. Sherdog lists these in separate tables.
  • methodCategory: KO/TKO, Submission, Decision or Other (DQ, no contest, overturned). Use it for grouping. method and methodDetail keep Sherdog's original text.
  • Record, winRate, finishRate, currentStreak, debutDate, lastFightDate: professional fights only, the same as the record on Sherdog. winRate = wins ÷ all pro fights. finishRate = KO/TKO and submission wins ÷ wins.
  • Dates are YYYY-MM-DD. Fields Sherdog does not have are null.
  • result is null when Sherdog shows a result this Actor does not recognize. The run log names it.
  • Failed pages: each page is tried 3 times. If it still fails, the run finishes with the other results, and the status message says how many pages are missing.

Pricing

You pay per result: one fighter in fighters mode, one fight or bout in fights mode. Platform usage is included. The price depends on your Apify plan:

Apify planPer 1,000 resultsPer result
Free$2.50$0.0025
Starter$2.00$0.002
Scale$1.50$0.0015
Business$1.00$0.001

For example, on the Free plan the UFC 309 card costs $0.03 as 12 bout rows, and Conor McGregor costs $0.0025 as one fighter row or $0.08 as 31 fight rows.

Changelog

1.1

  • The Actor has an output schema, and every output field is described in the dataset schema.

  • Event URLs with outputType: "fights" return one row per bout on the card, with title fights, card order and upcoming bouts. In 1.0 they returned the full histories of every fighter on the card; use outputType: "fighters" for that.

  • New: organization URLs and the maxEvents input.

  • A page that fails is retried. If it still fails, the status message says how many pages are missing. Before, failed fighters disappeared without a warning.

  • An unrecognized fight result is null. Before, it was saved as no_contest.

1.0

This version changes the output format. If you process the output with code, update it.

  • Fight history has a new field, division. Before, amateur and pro exhibition fights were mixed in with pro fights.
  • eventDate and birthDate are ISO dates (2024-11-16), not Nov / 16 / 2024.
  • method is split: "TKO (Punches)" is now method: "TKO", methodDetail: "Punches", methodCategory: "KO/TKO".
  • New fields: sherdogId, opponentId, eventId, timeSeconds, winRate, finishRate, currentStreak, debutDate, lastFightDate, proFightCount, amateurFightCount.
  • The units input is removed. Height and weight come in both units: height and heightCm, weightLbs and weightKg.
  • New inputs: startUrls (fighter and event URLs), outputType, dateFrom, includeAmateur.
  • upcomingFight.eventSherdogUrl is filled in. It was always null before.