Introduction
The Badminton API provides real-time scoring and statistics (when available) and an array of supplementary data.
All major men’s and women’s competitions are covered, for both singles and doubles. Select the Badminton package in our Coverage Matrix for competitions and data offered.
The API is consistent in structure, format, and behavior with the other General Sport APIs. Primary feeds will return seasons, competitions, team and player data, and real-time scores.
Additional feeds provide a host of complementary stats, including:
- Standings
- Rankings
- Player profiles
- Historical results
- Match lineups
- Match win probabilities
Real-time customers are also offered two delivery Push Feeds to enhance speed.
Authentication is required for all API calls.
API Map
To best utilize the Badminton API, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.
The primary feeds require only a date or human-readable parameters to call the endpoints. Those feeds provide Sport Event Ids, Competitor Ids, or Season Ids which can be used to generate the match, team, and tournament feeds.
Endpoint Descriptions
Competition Info - Displays a listing of competition information with IDs for parent and child competitions.
Competition Seasons - Provides historical season information for a given competition. Competitions will return a maximum of three seasons of data, including current or newly created seasons.
Competitions - Lists all competitions in the package, can filter results to only display parent competitions.
Competitor Merge Mappings - Provides the valid Sportradar Id in cases when two competitors have been merged into one. Mapping entries will remain in the feed for 7 days.
Competitor Profile - Returns information and stats for a competitor.
Competitor Summaries - Displays match summaries for a specific competitor.
Competitor vs Competitor - Compares past results and schedules upcoming matches given two competitor IDs.
Daily Summaries - Displays match summaries for a specific day.
Live Summaries - Displays match summaries for currently live matches.
Live Timelines - Displays information for live matches including a timeline of events, live (assuming coverage levels dictate that it is live).
Live Timelines Delta – Displays a 10 second delta of information for live matches including a timeline of events, live (assuming coverage levels dictate that it is live).
Rankings - Returns a list of various rankings for the current week.
Season Competitors - Provides teams for a particular season.
Season Info - Provides information pertaining to a given season.
Season Links - Provides information about linked cup rounds for a given season. Use this feed to compile full advancement brackets for relevant seasons/tournaments. Links between all matches and rounds are available when competitors (TBD vs. TBD) are not yet known.
Season Probabilities - Returns the pre-match 2-way probabilities of winning for both competitors for matches in a given season.
Season Standings - Returns the current standings for a given season.
Season Summaries - Displays match summaries for a specific season.
Seasons – Provides a list of historical season information for all competitions. Competitions will return a maximum of three seasons of data, including current or newly created seasons.
Sport Event Summary - Displays summarized information about a specific sport event.
Sport Event Timeline - Displays information for a specific sport event including a timeline of events.
Sport Event Created – Displays information for sports events that have been created in the last 24 hours.
Sport Event Removed - Displays information for sport events that have been removed or deleted.
Sport Event Updated - Displays information for sport events that have been updated in the last 24 hours.
Push Events - Displays current event information, scoring, and play-by-play event timeline.
Data Retrieval Sample
To find the probability of a home team win for a given game:
- Call the Daily Schedule for the day the sport event takes place and find the Season Id for the chosen sport event
- Make note of the Sport Event Id for the given sport event
- Call the Season Probabilities using the Season Id
- Find Sport Event Id within the results locate the home team and the outcome probability
The probability of a home team win is displayed.
Integration Links
OpenAPI Spec
Our Badminton API is available via OpenAPI. Click below to view and/or download the specs.
Postman Workspace
Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Badminton API collection.
Feel free to follow and/or fork any collections to receive updates.
Schema Download
Open the zip file below to access our entire Badminton API XSD schema.