Identifying Games

Every service has their own way of identifying real games. We provide our own internal representation of game ids, which can be requested through the games API request. We also support more free form ways of identifying games, through one of the team’s nick names, as well as the game start time.

For NBA games, we also support the official NBA game id representation

ID by Team Name and Start

It is possible identify a game based on one of the team names in combination with the start date of the game. In Fanvibe API requests, where game identification is needed, we suggest using Fanvibe’s identifiers. But this option is available if required.

Parameters

  • team_short_name – (required) This is the short name of the team (e.g. “Warriors” for the Golden State Warriors)
  • start_date – (required) The start date needs to be approximate to the day. If the start_date includes a specific time of day, we will search for the game starting anytime between 00:00 and 23:59 of the date. See the Date and Time Formatting documentation for information on how to format the time.
  • league_id_string – (optional, defaults to NBA’s id_string) This is Fanvibe’s internal representation of the league, as well as popular stats providers' representation. To get a list of these id strings, see the Leagues API Request.

ID by NBA Identifiers

This is one of the special cases we accept as a game identifier. The Official NBA game identifiers can be obtained with permission through the NBA.

2010-2011 Preseason

NBA game identifiers for the 2010-2011 Preseason will have the prefix 0011, for example:

0011000001

2010-2011 Regular Season

NBA game identifiers for the 2010-2011 Regular Season will have the prefix 0021, for example:

0021000001

Parameters

  • game_id – identifying games varies from one request to another. Use the NBA identifier anywhere you see “game_id” or “id” in the Games API Request.
  • id_type – (required) specify NBA