MMAAPI
MMAAPI is your ultimate source for the latest updates, scores, and results from the world of mixed martial arts. Our API covers all major MMA organizations, including UFC, Bellator, KSW, PFL, and many more.Our live scoring and real-time statistics provide a comprehensive view of every fight, making MMAAPI the go-to API to get MMA scores worldwide.
MMAAPI endpoints
| Method | Endpoint | Description |
|---|---|---|
| TV | ||
| GET |
getCountryTVChannels /api/tv/country/{countryCode}/channels |
Retrieves available TV channels for a specific country. |
| GET |
getMatchTVCountries /api/tv/country/all/event/{id} |
Lists the countries and the TV channels within them that are broadcasting a specific match. |
| GET |
getTVChannelSchedule /api/tv/channel/{id}/schedule |
Retrieves the broadcast schedule for a specific TV channel. |
| GET |
getMatchTVChannelVotes /api/tv/channel/{channId}/event/{id} |
Fetches viewer voting data from a specific TV channel that is broadcasting the match. |
| Media | ||
| GET |
getMMAOctagonImage /api/mma/octogon.png |
Retrieves the image of the MMA octagon. |
| GET |
getCountryFlag /api/img/flag/{flag} |
Fetches the PNG flag image asset corresponding to a provided country code. The response is the raw image data. |
| GET |
getCountryFlagImgAPI /api/country/{code}/flag |
Fetches the flag image from the image API by country code. |
| Placeholders | ||
| GET |
getFemaleFighterPlaceholderImage /api/placeholders/fighter-female.svg |
Retrieves a placeholder image for a female fighter. |
| GET |
getPlaceholderTournamentSvg /api/placeholder/tournament.svg |
Returns a static placeholder graphic for a tournament. The response is an SVG image. |
| GET |
getPlaceholderPlayerSvg /api/placeholder/player.svg |
Returns a static placeholder graphic for a player. The response is an SVG image. |
| GET |
getTeamPlaceholderImage /api/placeholder/team.svg |
Returns a static placeholder graphic for a team. The response is an SVG image. |
| GET |
getMaleFighterPlaceholderImage /api/placeholders/fighter-male.svg |
Retrieves a placeholder image for a male fighter. |
| GET |
getPlaceholderTournamentPng /api/placeholder/tournament.png |
Returns a static placeholder graphic for a tournament. The response is an SVG image. |
| GET |
getPlaceholderManagerSvg /api/placeholder/manager.svg |
Returns a static placeholder graphic for a manager. The response is an SVG image. |
| GET |
getPlaceholderManagerPng /api/placeholder/manager.png |
Returns a static placeholder graphic for a manager. The response is an SVG image. |
| GET |
getPlaceholderPlayerPng /api/placeholder/player.png |
Returns a static placeholder graphic for a player. The response is an SVG image. |
| Calendar | ||
| GET |
getMonthsWithEvents /api/mma/calendar/unique-tournament/{id}/{timezoneOffset}/months-with-events |
Retrieves months that have events for a specific tournament. |
| GET |
getCalendarDaysWithEvents /api/calendar/season/{seasonId}/{year}/days-with-events |
Retrieves days that have events for a specific season and year. |
| GET |
getCalendarSportStages /api/mma/calendar/{sportSlug}/{date}/{countryId}/stages |
Retrieves stage events for a sport on a specific date. |
| Categories | ||
| GET |
getUniqueTournamentsByCategory /api/mma/category/{id}/unique-tournaments |
Retrieves all unique MMA tournaments within a specific category (organization). |
| GET |
getMMACategories /api/mma/categories |
Retrieves a list of all available MMA categories, which typically correspond to different organizations (e.g., UFC, KSW). |
| GET |
getCategoryImage /api/category/{categoryId}/image |
Retrieves the image/logo for a sport category. |
| Config | ||
| GET |
getAllCountries /api/countries/all |
Retrieves a list of all available countries. |
| Rankings | ||
| GET |
getTeamRankings /api/rankings/team/{teamId} |
Retrieves rankings for a specific team. |
| GET |
getMMARankingsSummaryForATournament /api/mma/rankings/unique-tournament/{tournamentId}/summary |
Retrieves a summary of rankings for a specific MMA tournament. |
| Search | ||
| GET |
searchMMAEntities /api/mma/search/{term} |
Searches for MMA fighters, events, and tournaments. |
| GET |
searchAllEntities /api/search/all |
Searches across all entity types (teams, players, tournaments). |
| GET |
searchByEntityType /api/search/{entityType} |
Searches for entities of a specific type. |
| GET |
getSearchSuggestions /api/search/suggestions/{entityType} |
Retrieves search suggestions for a specific entity type. |
| GET |
searchUniqueTournaments /api/search/unique-tournaments |
Searches for unique tournaments. |
| Events | ||
| GET |
getMMAMainEventsExtendedByDate /api/mma/main-events/{date}/extended |
Retrieves extended main events for MMA on a specific date. |
| GET |
getMMAEventMetadata /api/mma/event/{id}/meta |
Retrieves metadata for a specific MMA event. |
| GET |
getMMAEventFeaturedOdds /api/mma/event/{id}/odds/{providerId}/featured |
Retrieves featured odds for a specific MMA event and provider. |
| GET |
getHeadToHeadHistoryForAnMMAEvent /api/mma/event/{customId}/h2h/events |
Retrieves the detailed match history for head-to-head encounters between the two fighters in an event. |
| GET |
getFighterStreaksForAnEvent /api/mma/event/{id}/team-streaks |
Provides recent form and streak information for each fighter in an event. |
| GET |
getMMAEventDetailsByID /api/mma/event/{id} |
Retrieves detailed information for a specific MMA event by its ID. |
| GET |
getMMAEventStatistics /api/mma/event/{id}/statistics |
Retrieves comprehensive statistics for a specific MMA event. |
| GET |
getPreGameFormForAnMMAEvent /api/mma/event/{id}/pregame-form |
Retrieves pre-game form and recent performance data for the fighters in a specific event. |
| Tournaments | ||
| GET |
getMMATournamentImage /api/mma/unique-tournament/{tournamentId}/image |
Retrieves the logo image for a specific MMA tournament. |
| GET |
getFeaturedMMAEventsForATournament /api/mma/unique-tournament/{tournamentId}/featured-events |
Retrieves a list of featured MMA events for a specific tournament. |
| GET |
getLastMainEventsForATournament /api/mma/unique-tournament/{tournamentId}/main-events/last/{page} |
Retrieves a paginated list of the last main events for a specific MMA tournament. |
| GET |
getNextMainEventsForATournament /api/mma/unique-tournament/{tournamentId}/main-events/next/{page} |
Retrieves a paginated list of the next main events for a specific MMA tournament. |
| GET |
getAllMMAEventsForATournament /api/mma/unique-tournament/{uniqueTournamentId}/tournament/{tournamentId}/mma-events/all |
Retrieves all MMA events associated with a specific tournament and unique tournament ID. |
| GET |
getMMATournamentDarkThemeImage /api/mma/unique-tournament/{tournamentId}/image/dark |
Retrieves the dark-theme logo image for a specific MMA tournament. |
| GET |
getMMATournamentScheduleByDate /api/mma/unique-tournament/{tournamentId}/schedules/{day}/{month}/{year} |
Retrieves the schedule of events for a specific MMA tournament on a given date. |
| GET |
getMMATournamentDetails /api/mma/unique-tournament/{tournamentId} |
Retrieves detailed information for a specific MMA tournament. |
| GET |
getMMATournamentDetailsByID /api/mma/tournament/{tournamentId} |
Retrieves detailed information for a specific MMA tournament by its ID. |
| GET |
getMMAScheduledMainEventsByMonth /api/mma/unique-tournament/{tournamentId}/schedules/{month}/{year} |
Retrieves the main events scheduled for a specific MMA tournament in a given month and year. |
| Fighters | ||
| GET |
getMMAFighterDetails /api/mma/team/{id} |
Retrieves comprehensive details for a specific MMA fighter. |
| GET |
getLastEventsForAnMMAFighter /api/mma/team/{id}/events/last/{page} |
Retrieves a paginated list of the last events for a specific MMA fighter. |
MMAAPI pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 4 / second |
|
| PRO | $9.99 / month | 6 / second |
|
| ULTRA | $14.99 / month | 8 / second |
|
| MEGA Recommended | $24.99 / month | 10 / second |
|