Sherdog Scraper – UFC & MMA Fighter Records, Fight History
Pricing
from $1.00 / 1,000 results
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š
Maintained by CommunityActor stats
1
Bookmarked
38
Total users
1
Monthly active users
11 days ago
Last modified
Categories
Features
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 search | fighters (default) | fights |
|---|---|---|
| Fighter URL, search | The fighter | Every fight in the fighter's history |
| Event URL | Every fighter on the card | Every bout on the card |
| Organization URL | Every fighter on the selected cards | Every bout on the selected cards |
| Field | What it does |
|---|---|
startUrls | Sherdog 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). |
searchTerm | Part of a fighter's name or nickname, for example McGregor. |
weightClass | Search one weight class (code, see below). |
association | Search one gym or team, for example American Top Team. |
resultsLimit | Maximum fighters from the search. Default 10. Does not limit URLs. |
maxEvents | Organization URLs only. How many completed events to take, newest first. Default 10. All upcoming events are always included. |
outputType | fighters (default) or fights. See the table above. |
dateFrom | YYYY-MM-DD. Organization URLs: only completed events on or after this date. Fighters with fights: only fights on or after this date. |
includeAmateur | Fighter 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:completedorupcoming. 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
winnerNameorwinnerIdfor the winner; it isnullfor draws, no contests and upcoming bouts.
Field notes
division:pro,pro_exhibitionoramateur. Sherdog lists these in separate tables.methodCategory:KO/TKO,Submission,DecisionorOther(DQ, no contest, overturned). Use it for grouping.methodandmethodDetailkeep 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 arenull. resultisnullwhen 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 plan | Per 1,000 results | Per 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; useoutputType: "fighters"for that. -
New: organization URLs and the
maxEventsinput. -
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 asno_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. eventDateandbirthDateare ISO dates (2024-11-16), notNov / 16 / 2024.methodis split:"TKO (Punches)"is nowmethod: "TKO",methodDetail: "Punches",methodCategory: "KO/TKO".- New fields:
sherdogId,opponentId,eventId,timeSeconds,winRate,finishRate,currentStreak,debutDate,lastFightDate,proFightCount,amateurFightCount. - The
unitsinput is removed. Height and weight come in both units:heightandheightCm,weightLbsandweightKg. - New inputs:
startUrls(fighter and event URLs),outputType,dateFrom,includeAmateur. upcomingFight.eventSherdogUrlis filled in. It was alwaysnullbefore.