A freestyle wrestling API you can build on.
Professional freestyle wrestling as JSON: Real American Freestyle's cards, scores by period, takedowns, tech falls and pins, athlete records, and the scoring rules themselves as data. One key, no scraping.
- Real American Freestyle
- Scoring rules as data
- 500 free requests / month
{ "success": true, "data": { "format": "Modified freestyle wrestling, individual bouts", "periods": 3, "periodSeconds": 120, "techFallMargin": 10, "scoring": [ { "action": "takedown", "points": 2 }, { "action": "standing_exposure", "points": "4-5" }, { "action": "step_out", "points": 1 }, ... ] }}Seamless Integration with our MCP Server
Give Claude, Cursor, and ChatGPT the RAF card. One command writes the MCP config; agents call combat_card, combat_bout, and combat_athlete with league raf instead of guessing bout IDs, and your key stays on your machine.
MCPInstall the Cito MCP server
Wrestling data, structured
Everything a wrestling app, bot or model needs from a pro freestyle league. This data comes from the RAF wrestling API, Cito's API for Real American Freestyle.
Bout results
Winner, final score and method for every bout: decision, criteria, tech fall or fall.
Points per period
Each period's points and the running score.
Takedowns
Takedowns per athlete, and takedown points by period on Starter.
Athlete records
Profiles with country, club and hometown, every bout, and career scoring stats.
Head-to-head
Every meeting between two athletes and the series record.
Rules as data
Scoring actions, point values and win methods, versioned by event.
Which wrestling does this API cover?
Professional freestyle wrestling from Real American Freestyle (RAF), the US league that launched in 2025: every card, bout and athlete. It does not cover United World Wrestling (Olympic and World Championship) events, NCAA college, high school or folkstyle, and it does not cover pro wrestling entertainment.
How is a freestyle bout scored here?
RAF's ruleset is in the API at /raf/rules. The main scoring actions:
| Action | Points |
|---|---|
| Takedown | 2 |
| Standing exposure | 4-5 |
| Ground exposure | 2 |
| Reversal | 1 |
| Step out | 1 |
| Shot clock violation | 1 to the opponent |
| Caution | 1 to the opponent |
Endpoints you can ship with
Five groups, one key: events, bouts and scoring, athletes, titles, and event night.
Events & cards
Every Real American Freestyle card since RAF 01 in August 2025, with local start time, venue and the card in running order.
- GET
/api/v1/raf/events/upcomingScheduled cards, soonest first, with date, local time, time zone and venue.
- GET
/api/v1/raf/events/recentFinished cards, newest first.
- GET
/api/v1/raf/events/{slug}One card: name, headline, date, location and bout counts.
- GET
/api/v1/raf/events/{slug}/boutsThe card in running order: weight class, title fights, scores and results.
- GET
/api/v1/raf/events/{slug}/resultsWinners, methods and final scores for a card.
- GET
/api/v1/public/calendars/raf.icsEvery scheduled RAF card as a calendar feed. No key needed.
Bouts & scoring
Each bout's final score, how it ended (decision, criteria, tech fall, fall), the period it ended in and the clock, with points per period.
- GET
/api/v1/raf/boutsQuery bouts by event, athlete, division or method.
- GET
/api/v1/raf/bouts/{boutId}One bout: athletes, score, takedowns, method, end period and clock.
- GET
/api/v1/raf/bouts/{boutId}/periodsPoints per period and the running score.
- GET
/api/v1/raf/bouts/{boutId}/statsStarter: points, takedowns and takedown points per athlete, by period.
- GET
/api/v1/raf/rulesThe ruleset as data: scoring actions, win methods, tech-fall margin, rule versions.
Athletes
Athlete profiles with country, club, hometown and official headshot, every bout they wrestled, and career scoring stats.
- GET
/api/v1/raf/athletesEvery athlete, searchable and paginated.
- GET
/api/v1/raf/athletes/{slug}Profile: country, age, club, hometown, record and headshot.
- GET
/api/v1/raf/athletes/{slug}/boutsEvery RAF bout an athlete wrestled, newest first.
- GET
/api/v1/raf/athletes/{slug}/statsStarter: points for and against, takedowns, wins by method, points by period, streak.
- GET
/api/v1/raf/h2h?athlete1={slug}&athlete2={slug}Head-to-head record and every meeting between two athletes.
- GET
/api/v1/raf/search?q={name}Find athletes and events by name.
Titles
The current champion of every RAF title, each title's history, and the divisions.
- GET
/api/v1/raf/championsCurrent champion of every title, men's and women's.
- GET
/api/v1/raf/titles/{titleKey}One title and its changes.
- GET
/api/v1/raf/divisionsDivisions with weight limits.
Event night
During a card, results are polled every 90 seconds and land as each bout is posted. RAF publishes no in-bout scoring feed, so the API carries results, not a live clock.
- GET
/api/v1/raf/liveCards in progress with each bout's state.
- GET
/api/v1/raf/live/events/{slug}One live card.
- GET
/api/v1/raf/live/{boutId}One bout on a live card.
- GET
/api/v1/raf/live/streamServer-Sent Events push of card updates.
FAQs
Coverage, scoring and plans
Can't find what you're looking for? Contact our customer support team
More wrestling data
- RAF wrestling APIReal American Freestyle cards, bouts, athletes and titles.
- RAF results APIScores by period, takedowns and how each bout ended.
- RAF API docsEvery RAF endpoint, its parameters and a real response.
- BKFC APIEvery BKFC card since 2018: results, fighters, rankings and punch stats.
- Cito MCP serverRAF and BKFC tools for Claude, Cursor and other MCP clients.
Build wrestling apps
Create a free key and pull your first freestyle wrestling result in a minute.