API
The RUWT? Sports API allows developers to create applications using RUWT?'s integrated sports and television data, as well as RUWTbot's RUWT? Rating for each game. The interface is RESTful and returns data in XML format.
Until a proper Terms of Use is created, please contact us before starting development, or if you have any questions or feedback.
Endpoints
Games
Returns information about upcoming games. Parameters can be combined to customize information.
Parameters:
- sport - The abbreviation for a sport, such as mlb, nfl, or ncaab. Multiple sports can be specified by passing in multiple values, i.e. sport=nba&sport=mlb&sport=nhl.
- gameID - The ID of a game.
- teamID - The ID of a team.
- providerID - The ID of a cable or satellite provider.
- showJustTelevisedGames - Filters out all games that aren't available on the specified provider. ProviderID must be also included when this is used.
Examples:
Providers
Returns the cable and satellite providers for a postal code.
Parameters:
- postalCode - A five-digit U.S. ZIP Code or a six-character Canadian Postal Code.
Examples:
Teams
Returns all teams for a specific sport.
Parameters:
- sport - The abbreviation for a sport (mlb, nfl, ncaab, etc.)
Examples:
Schema
Most elements in the response are self-explanatory. Here is more information on a few elements that may need explanation.
<points>
The value of the points element is the total number of current "roots" for the game. It also has three attributes that are always present:
- level - A verbal description of the points level, either Guarded, High, Elevated or Severe (you may recognize those). Currently the points level for each are 0-49, 50-99, 100-99, and 200+ respectively. The points level may change as the site grows, but the names of the levels will not.
- high - The highest points total the game has reached—some games get exciting and then peter out.
- color - This is the hex color that we use on the site for this point level. The colors are roughly Blue, Yellow, Orange, and then Red.
<date> and <time>
In most cases the <date> element can be ignored, and the time of the game will be in the <time> element. However, if the time of a game is TBA, the <time> element will be empty and the value of the <date> element will be the date of the game.
<timeLeft>
The value of the timeLeft element is the amount of time left in the game such as "3rd Quarter - 4:30", or "End of 1st". If the game is over, the value will be something like "Final" or "Final/2OT". If the game has not yet started, the element will be empty.
