Unofficial Tapology MMA API

Contents
1.
What is Unofficial Tapology MMA API
1.1. Why Unofficial Tapology MMA API
2.
Endpoint
3.
Data Source and Fair Use

1. What is Unofficial Tapology MMA API

This API provides comprehensive information about MMA fighters worldwide, including their personal details and statistics. Real-time data provided by Tapology.

1.1 Why Unofficial Tapology MMA API

Unofficial Tapology MMA API allows you to retrieve detailed information about fighters. It's perfect for applications, websites, or services that need up-to-date fighter data.

Base URL:

https://unofficial-tapology-api.p.rapidapi.com

Authentication

This API uses two types of authentication depending on how you're accessing it.

a) Through RapidAPI:

The x-rapidapi-proxy-secret header is required and is automatically handled by the platform.

The x-rapidapi-key header is not required when accessing through RapidAPI.

b) Direct API Access:

The x-rapidapi-key header is required for all requests.

This key is provided to you when you subscribe to the API through the platform.

2. Endpoint

Get Fighter Details

Retrieve detailed information about a specific fighter.

Endpoint:

GET /fighter/{fighter_id}

Path Parameters

fighter_id (required): The unique identifier of the fighter. Example: 14607-conor-mcgregor

Query Parameters

fields (optional): Comma-separated list of fields to include in the response. If not specified, all fields are returned.
Available fields:
firstname, lastname, nickname, full_record, losses, draws, no_contest, weight_class, born, current_streak, tko_ko, submission, decision, disqualification

📦 CONOR MCGREGOR

Example Request with fields parameter

GET https://unofficial-tapology-api.p.rapidapi.com/fighter/14607-conor-mcgregor?fields=firstname,lastname,full_record,tko_ko

Example Response

{
  "firstname": "Conor",
  "lastname": "McGregor",
  "full_record": "22-6-0",
  "tko_ko": {
    "wins": 19,
    "losses": 2
  }
}

📦 GEORGE ST-PIERRE

Example Request with all the available objects

GET https://unofficial-tapology-api.p.rapidapi.com/fighter/georges-st-pierre-rush

Examples Response

{
  "firstname": "Georges",
  "lastname": "St-Pierre",
  "nickname": "Rush",
  "full_record": "26-2-0",
  "wins": 26,
  "losses": 2,
  "draws": 0,
  "no_contest": 0,
  "weight_class": "Middleweight",
  "born": "St. Isidore, Quebec, Canada",
  "current_streak": "13 Wins",
  "tko_ko": {
	"wins": 8,
	"losses": 1
   },
  "submission": {
	"wins": 6,
	"losses": 1
   },
  "decision": {
	"wins": 12,
	"losses": 0
   },
  "disqualification": {
	"wins": 0,
	"losses": 0
   }
}

Response Fields

✅ firstname: Fighter's first name

✅ lastname: Fighter's last name

✅ nickname: Fighter's nickname (if any)

✅ full_record: Complete fight record (wins-losses-draws, NC)

✅ wins: Total number of wins

✅ losses: Total number of losses

✅ draws: Total number of draws

✅ no_contest: Number of no contests

✅ weight_class: Fighter's weight class

✅ born: Fighter's place of birth

✅ current_streak: Current winning/losing streak

✅ tko_ko: TKO/KO statistics (wins and losses)

✅ submission: Submission statistics (wins and losses)

✅ decision: Decision statistics (wins and losses)

✅ disqualification: Disqualification statistics (wins and losses)

Error Codes

❌ 400 Bad Request: Invalid request parameters

📋 401 Unauthorized: Missing or invalid API key

❓ 404 Not Found: Fighter not found

⏰ 429 Too Many Requests: Rate limit exceeded

💻 500 Internal Server Error: Server-side error

Plans and Usage Limits

Plan	Price	Rate Limit	Monthly Quota	Use Case
BASIC	Free	2 requests/min	750 requests	Ideal for hobbyists or developers testing the API, allowing experimentation without cost.
PRO	$25/month	4 requests/min	3,000 requests	Suitable for freelance developers or small projects requiring more frequent API calls.
ULTRA	$75/month	12 requests/min	9,000 requests	Great for professional developers working on larger projects or small businesses integrating the API into their products.
MEGA	$150/month	60 requests/min	30,000 requests	Designed for high-traffic applications or businesses heavily relying on the API for core functionalities.

Our per-minute rate limits ensure smooth and responsive API performance while allowing for efficient data retrieval. These limits, combined with the monthly quota, are designed to meet a wide range of usage patterns from occasional testing to high-volume integrations.

Best Practices

Use the fields parameter to request only the data you need, improving response times and reducing data transfer.

Implement caching on your end to store frequently accessed fighter data.

Handle rate limiting by implementing exponential backoff in your requests.

Respect the source data by implementing proper attribution and adhering to fair use principles.

Regularly update cached data to ensure accuracy and freshness of information.

Support

For any questions or issues, please contact us at tech-verdun[at]proton[dot]me.

Changelog

v1.0.0 (22-07-2024): Initial release of the Unofficial Tapology MMA API

3. Data Source and Fair Use

The data provided by this API is sourced from Tapology.com. We respect the intellectual property rights of Tapology and adhere to fair use principles. Users and Developers of this API must also comply with fair use guidelines:

Attribution: When displaying data obtained through this API, always provide clear attribution to Tapology.com as the original source.

Limited Use: Use the data for informational purposes only. Do not use it in a way that could be considered a replacement for Tapology's services.

No Bulk Downloads: Do not attempt to download or cache large portions of the database. Only request the data you need for immediate use.

Respect Rate Limits: Adhere to the rate limits specified in your plan. These limits are in place partly to ensure fair use of Tapology's data.

No Misrepresentation: Do not present the data in a way that could be misleading or out of context.

Freshness: Consider implementing regular updates in your application to ensure the displayed data is current.

Legal Notice

This API is not officially affiliated with, endorsed, or sponsored by Tapology.com. It is an independent service that accesses publicly available data in compliance with fair use doctrine. Users are responsible for ensuring their use of the data complies with all applicable laws and Tapology.com's terms of service.

Unofficial Tapology MMA API

Contents#

1. What is Unofficial Tapology MMA API#

1.1 Why Unofficial Tapology MMA API#

Base URL:#

Authentication#

2. Endpoint#

Get Fighter Details#

Endpoint:#

Response Fields#

Error Codes#

Plans and Usage Limits#

Best Practices#

Support#

Changelog#

3. Data Source and Fair Use#

Legal Notice#

Contents