Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Introduction

The Squash API provides schedules and results for top leagues. Data is collected via Sportradar operators.

The API is consistent in structure, format and behavior with other General Sport APIs. Primary feeds will return competitions, seasons, schedules, and results.

Additional feeds provide complementary stats, including:

  • Competitor profiles
  • Match win probabilities
  • Historical results
  • Head-to-head statistics

🗝️

Authentication is required for all API calls.

API Map

To best utilize the Squash 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 season, sport event, and competitor feeds.


Endpoint Descriptions

Competition Info - Provides the name, id, gender, and type of a given competition.

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 - Provides a list of all available 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 - Provides top-level information for a given competitor.

Competitor Summaries - Provides previous and upcoming match information for a given competitor, including results for past matches and scheduling info for upcoming matches. 

Competitor vs Competitor - Provides previous and upcoming matches between two competitors, including scoring information.

Daily Summaries - Provides match schedules for a given day, including scoring information.

Live Summaries - Provides match information for all currently live matches, including team scoring. This feed updates in real time as matches are played.

Live Timelines - Provides an event timeline for currently live matches. 

Live Timelines Delta - Provides a 10 second live delta of match information, including scoring and an event timeline. 

Season Competitors - Provides a list of competitors participating for a given season. 

Season Info - Provides detailed information for a given season, including participating competitors and league structure. 

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 - Provides 2-way match win probabilities (home team win, away team win) for all matches for a given season. 

Season Summaries - Provides schedule information and results for all matches from a given 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 - Provides scoring for a given match. Please note that data returned is determined by coverage level.

Sport Event Timeline - Provides scoring and an event timeline for a given match. Please note that data returned is determined by coverage level.

Sport Events Created – Provides ids for sport evens that have been created in the last 24 hours.

Sport Events Removed - Provides ids for sport events that have been removed or deleted.

Sport Events Updated - Provides ids for sport events that have been updated in the last 24 hours.


Data Retrieval Sample

To find the probability of a home competitor win for a given match:

  1. Call the Daily Summaries feed for the day the match takes place and find the Season Id for the chosen match
  2. Make note of the Sport Event Id for the given match
  3. Call the Season Probabilities endpoint using the Season Id
  4. Find Sport Event Id and within the results locate the home competitor and the outcome probability

The probability of a home competitor win is displayed.


Integration Links

OpenAPI Spec

Our Squash API is available via OpenAPI. Click below to view and/or download the specs.

Squash v2 OpenAPI

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Squash 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 Squash API XSD schema.

Squash v2 Schema