boxrec.com APIboxrec.com ↗
Retrieve boxer stats, career records, KO percentages, and fight histories from BoxRec. Access trending fighters and detailed bout results via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/40f10f57-6691-4b9a-80e2-859b4cd5a6a2/get_boxer_stats?boxer_id=659772' \ -H 'X-API-Key: $PARSE_API_KEY'
Get detailed statistics, division, career span, KO percentage, and recent fight history for a professional boxer by their BoxRec ID. Returns fighter profile data and a list of recent bouts with results.
| Param | Type | Description |
|---|---|---|
| boxer_idrequired | string | The numeric BoxRec ID of the boxer (e.g. '659772' for Oleksandr Usyk, '628407' for Naoya Inoue). |
{
"type": "object",
"fields": {
"fighter_info": "object containing id, name, division, bouts, rounds, kos percentage, career span, debut date, and titles",
"recent_fights": "array of fight objects with date, opponent, result, method, and venue"
},
"sample": {
"data": {
"fighter_info": {
"id": "659772",
"kos": "62.5%",
"name": "Oleksandr Usyk",
"bouts": "24",
"debut": "2013-11-09",
"career": "2013-2025",
"rounds": "206",
"division": "heavy"
},
"recent_fights": [
{
"date": "Jul 25",
"venue": "eventboutwiki",
"method": "",
"result": "win",
"opponent": "Daniel Dubois*"
},
{
"date": "Dec 24",
"venue": "eventboutwiki",
"method": "",
"result": "win",
"opponent": "Tyson Fury"
}
]
},
"status": "success"
}
}About the boxrec.com API
The BoxRec API provides access to professional boxing data through 2 endpoints covering individual fighter profiles and site-wide trending fighters. The get_boxer_stats endpoint returns a fighter's full career summary — division, total bouts, rounds, KO percentage, debut date, and active titles — alongside a chronological list of recent fights with opponent names, results, methods, and venue details, all keyed by BoxRec's numeric fighter ID.
Fighter Profiles
The get_boxer_stats endpoint accepts a single required parameter, boxer_id, which is the numeric ID BoxRec assigns each fighter (for example, 659772 for Oleksandr Usyk or 628407 for Naoya Inoue). The response returns a fighter_info object covering the fighter's name, weight division, total bouts, total rounds, KO percentage, career span, debut date, and any titles currently held. The recent_fights array pairs with this object, providing a dated log of bouts — each entry includes the opponent name, result, method of victory or defeat, and venue.
Trending Fighters
The get_trending_fighters endpoint takes no parameters and returns up to 30 boxers currently featured as trending on BoxRec. Each entry in the trending_fighters array contains the fighter's numeric BoxRec id and full name. This endpoint is useful for surfacing which fighters are drawing current attention, and the returned IDs can feed directly into get_boxer_stats calls to pull full profiles for any of those fighters.
Coverage Notes
Data covers professional boxing records as maintained on BoxRec. The endpoints expose summary career statistics and recent fight history rather than round-by-round scoring or historical ranking timelines. The boxer_id must be known in advance; there is no search-by-name endpoint in the current API surface.
- Pull a fighter's KO percentage and total bouts to build comparison tables for upcoming matchups
- Track career debut dates and division histories for historical analysis of professional boxers
- Fetch trending fighters daily to populate a boxing news or fantasy sports dashboard
- Use recent fight results and methods to identify fighters on win streaks or coming off losses
- Map title holdings from
fighter_info.titlesto produce division-level championship trackers - Seed a fighter database by iterating trending IDs through
get_boxer_statsfor bulk profile ingestion - Correlate venue data from
recent_fightswith fight outcomes for location-based performance analysis
| 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 BoxRec have an official developer API?+
What does `get_boxer_stats` return beyond a win-loss record?+
recent_fights array with per-bout details including opponent, result, method (e.g. KO, TKO, UD), and venue.Can I search for a boxer by name instead of by BoxRec ID?+
boxer_id for get_boxer_stats. The get_trending_fighters endpoint returns IDs paired with names, which can serve as a starting point. You can fork this API on Parse and revise it to add a name-based search endpoint.