Why Is Gathering Boxing Data So Difficult?
For sports analysts, boxing journalists, app developers, and fantasy sports platforms, keeping track of professional boxers is a major challenge. Unlike team sports with centralized league databases, boxing data is scattered across various promotional companies, sanctioning bodies, and regional commissions.
If you are building a boxing news aggregator, a fighter comparison tool, or a sports analytics dashboard, manually copy-pasting career records is incredibly inefficient. You need structured, clean data on demand—such as a fighter's nationality, height, weight division, and profile images.
The Boxing Stats Scraper is a specialized automation tool designed to solve this problem. By leveraging the free public API from TheSportsDB, this actor allows you to programmatically extract comprehensive boxing profiles and weight class structures without writing complex scrapers from scratch.
What is the Boxing Stats Scraper?
The Boxing Stats Scraper is a pre-built web scraping and automation tool available on Apify. It falls under the Automation, Developer Tools, and Integrations categories, making it easy to incorporate into your existing developer workflows or data pipelines.
The tool operates by querying TheSportsDB free public API. Because it uses this free public tier, you do not need to obtain or configure your own API key to start pulling data.
Supported Features and Scraping Modes
The scraper is designed with two distinct modes to help you get the exact datasets you need:
- search mode: This mode allows you to find any professional boxer by their name. It is ideal for targeted searches when you need to build individual fighter profile cards or update a specific athlete's stats in your database.
- teams mode: In the context of TheSportsDB boxing data, this mode lists the different boxing weight divisions. This is highly useful for mapping out weight classes to structure your sports application or website navigation.
Key Input Fields and Search Parameters
To get the exact boxing datasets you need, the Boxing Stats Scraper provides a simple input schema with a few key parameters:
-
mode(string, required): Choose betweensearchto look up specific boxers, orteamsto retrieve weight division structures. -
searchQuery(string): The name of the boxer you want to search for (used when the search mode is active). -
maxItems(integer): Control your data budget by limiting the maximum number of records returned (supports a range from 1 to 200).
What Data Fields Can You Extract?
Once the scraper completes its run, it delivers structured data directly to your dataset. The output fields returned for boxing profiles include:
-
fighterId: The unique identifier for the boxer. -
fighterName: The full name of the professional athlete. -
team: The associated team or promotional entity. -
nationality: The athlete's home country. -
position: The role or specific category of the fighter. -
height: The height of the fighter. -
weight: The weight or weight class. -
birthDate: The fighter's date of birth. -
imageUrl: A direct link to the athlete's profile or headshot image. -
profileUrl: The official profile page link on the source database.
With access to image URLs and key physical stats, developers can instantly populate user interfaces with rich visual and textual content.
How to Use the Boxing Stats Scraper: Step-by-Step
Getting started with the scraper is straightforward, even if you do not have extensive programming experience. Follow these steps to run your first task:
- Access the Actor: Navigate to the Apify platform and search for the boxing-stats-scraper in the store.
- Select Your Mode: In the input configuration, set the
modefield to eithersearch(to find a specific boxer) orteams(to list weight divisions). - Define Your Search: If you selected the search mode, enter the boxer's name in the
searchQueryfield. - Set Limits: Specify the maximum number of records you wish to retrieve in the
maxItemsfield. - Run the Scraper: Click the "Start" button. The actor will query the API and process the results.
- Download Your Data: Once the run is finished, you can export your clean structured data in formats like JSON, CSV, or Excel directly from the Apify console.
Frequently Asked Questions
Is an API key required to run this scraper?
No, an API key is not required. The Boxing Stats Scraper utilizes the free public tier of TheSportsDB to pull fighter profiles and weight divisions, meaning you can start gathering data immediately without registering for external API credentials.
Can I filter the results by weight class?
Yes, the input schema allows you to filter your queries by selecting a weight class to refine the returned records.
How many records can I retrieve in a single run?
The actor allows you to set the maxItems parameter to retrieve up to 200 records per run, making it quick and easy to gather bulk datasets on multiple fighters or divisions at once.
Ready to try it yourself? Run *Boxing Stats Scraper** on the Apify Store -- no setup required.*
Top comments (0)