UFC Data API


Use The API



Login or Sign Up to use the API.

About The API



This API provides data about past UFC fights. Data is returned in the following JSON format:

[{"date":"2022-05-22",
"promotion":"UFC",
"event":"271",
"main_or_prelim":"Main",
"card_placement":1,
"fighter_1":"Israel Adesanya",
"fighter_2":"Robert Whittaker",
"rematch":2,
"winner":"Israel Adesanya",
"method":"Decision",
"round":5,
"time":"5:00",
"fighting_tomatoes_aggregate_rating":62,
"fighting_tomatoes_number_ratings":19}]




URL API Requests



You may access the API by direct URL request. To do so, format the URL as follows:

https://fightingtomatoes.com/API/{api-key}/{year}/{event}/{fighter}




API Key



Each request must include your API Key. You are allowed up to 200 API requests per month. You have used of 200 this month.

Login or Sign Up to get and API key and use the API.




Year



Enter a year 1993 - 2022 or 'Any'.

Example:https://fightingtomatoes.com/API/{api-key}/2018/any/any




Event



Identify PPV events by number. For example, '281' or '65'.
Identify Fight Night events by headliner last names. For example, 'Kattar vs Allen' or 'Velasquez vs Dos Santos'.

Example:https://fightingtomatoes.com/API/{api-key}/any/Velasquez vs Dos Santos/any




Fighter



Enter fighter first and last name. For example, 'Georges St-Pierre' or 'Conor McGregor',

Example:https://fightingtomatoes.com/API/{api-key}/any/any/Conor McGregor




Fighting Tomatoes Aggregate Rating



This is the average score this fight has received by fightingtomatoes.com website users. It is a score out of 100. Higher means users found the fight more entertaining.




API Support



If you have any questions about the API or encounter any errors in the data or system, please let us know at hello@fightingtomatoes.com