Docs
Coverage MatrixDocumentationRelease LogLog In

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:

  1. Call the Daily Schedule for the day the sport event takes place and find the Season Id for the chosen sport event
  2. Make note of the Sport Event Id for the given sport event
  3. Call the Season Probabilities using the Season Id
  4. 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.

Badminton v2 OpenAPI

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.

Badminton v2 Schema