Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Competitor Summaries

Global Basketball Competitor Summaries provides scheduling information for upcoming matches and statistics for the 30 most recent completed matches of a specified competitor.

⏱️

Update Frequency

300s Time To Live / Cache



Data Points

Category & Sport:
AttributeParent ElementTypeDescription
country_codesport_event_context - categoryStringCountry code for a competition category
ex. FRA (France)
idsport_event_context - categoryStringUnique category ID for a competition
ex. sr:category:110
namesport_event_context - categoryStringName for a competition category
ex. France
idsport_event_context - sportStringUnique sport ID for a competitor
ex. sr:sport:2
namesport_event_context - sportStringName for a competitor's sport
ex. Basketball
Competition:
AttributeParent ElementTypeDescription
gendersport_event_context - competitionStringGender for a competition
men, women
idsport_event_context - competitionStringUnique ID for a competition
ex. sr:competition:264 (Liga ACB)
namesport_event_context - competitionStringName of a competition
ex. Pro A, NBA
parent_idsport_event_context - competitionStringUnique parent ID for a competition. Typically present for group competitions
ex. sr:competition:30190 used to group NCAA postseason tournaments.
Groups:
AttributeParent ElementTypeDescription
idsport_event_context - groups - groupStringUnique ID for a sport event's group
ex. sr:league:76103 (Euroleague 23/24)
namesport_event_context - groups - groupStringName of a sport event's group
ex. Euroleague 23/24
group_namesport_event_context - groups - groupStringAbbreviated name of a sport event's group
ex. D
Rounds:
AttributeParent ElementTypeDescription
competition_sport_event_numbersport_event_context - roundIntegerSport event number within a competition. Used for competitions that have fixed match numbers.
cup_round_idsport_event_context - roundStringUnique ID for a sport event's cup round
ex. sr:cup_round:1988995
cup_round_number_of_sport_eventssport_event_context - roundIntegerNumber of events in a sport event's round
cup_round_sport_event_numbersport_event_context - roundIntegerNumber within the cup_round of a match ID. For example, 1st leg of 2
namesport_event_context - roundStringName of a sport event's round
ex. round_3 or round_of_16
numbersport_event_context - roundIntegerNumber of a sport event's round
other_sport_event_idsport_event_context - roundStringA linked sport event ID, typically in a two-legged tie
ex. sr:sport_event:47395897
Seasons:
AttributeParent ElementTypeDescription
competition_idsport_event_context - seasonStringUnique ID for the competition a sport event belongs to
ex. sr:competition:264 (Liga ACB)
disabledsport_event_context - seasonBooleanSignifies a season has been disabled when true
end_datesport_event_context - seasonDateEnd date of a sport event's season
ex. 2024-06-17
idsport_event_context - seasonStringUnique ID for a sport event's season
ex. sr:season:108577 (Liga ACB 23/24)
namesport_event_context - seasonStringName of a sport event's season
ex. Liga ACB 23/24
start_datesport_event_context - seasonDateStart date of a sport event's season
ex. 2023-09-23
yearsport_event_context - seasonStringYear of a sport event's season
ex. 23/24
Stages:

Attribute

Parent Element

Type

Description

end_date

sport_event_context - stage

Date

End date of a sport event's stage
ex. 2024-05-19

order

sport_event_context - stage

Integer

Order of a stage within a season

phase

sport_event_context - stage

String

Name of a sport event's stage
ex. regular season, conference, playoffs

See the enum_phase entry in our Global Basketball OpenAPI spec for a complete list of valid phase enum values

start_date

sport_event_context - stage

Date

Start date of a sport event's stage
ex. 2023-08-11

type

sport_event_context - stage

String

Type of a sport event's stage
cup, league

year

sport_event_context - stage

String

Year of a sport event's stage
ex. 23/24

Competitor:
AttributeParent ElementTypeDescription
abbreviationcompetitors - competitorStringAbbreviation for a competitor name
ex. RMA (Real Madrid)
age_groupcompetitors - competitorStringAge group of a competitor, when applicable
ex. U23
countrycompetitors - competitorStringCountry of a competitor
ex. Spain
country_codecompetitors - competitorStringCountry code of a competitor
ex. ESP (Spain)
divisioncompetitors - competitorIntegerDivision number for a competitor
gendercompetitors - competitorStringGender for a competitor
male, female
idcompetitors - competitorStringUnique ID for a competitor
ex. sr:competitor:3540 (Real Madrid)
namecompetitors - competitorStringName for a competitor
ex. Real Madrid
qualifiercompetitors - competitorStringDesignation of a competitor for a sport event
home, away
statecompetitors - competitorStringState of a competitor
ex. TX (Texas)
virtualcompetitors - competitorBooleanSignifies a competitor is a virtual team whan true. Used for placeholder teams in TBD vs TBD matchups.
Player:
AttributeParent ElementTypeDescription
idstatistics - competitor - playerStringUnique ID of a player
ex. sr:player:608026
namestatistics - competitor - playerStringName of a player
ex. Tavares, Edy
Sport Event:
AttributeParent ElementTypeDescription
neutralsport_event_conditions - groundBooleanSignifies a neutral ground sport event when true
idsport_eventStringUnique ID of a sport event
ex. sr:sport_event:49796317
replaced_bysport_eventStringAn alternative sport event ID if the match is postponed and played at a later date
ex. sr:sport_event:47395897
resume_timesport_eventDateAn updated timestamp if there is a delay at the start or interruption during a match
ex. 2024-03-26T20:00:00+00:00
start_timesport_eventDateStart time of a sport event
ex. 2024-03-26T20:00:00+00:00
start_time_confirmedsport_eventBooleanSignifies the start time of a sport event is confirmed when true
Sport Event - Coverage Properties:

Attribute

Parent Element

Type

Description

live

sport_event - coverage

Boolean

Signifies a sport event is covered live when true

type

sport_event - coverage - property

String

Type of coverage for a sport event
ex. boxscore or lineups

See our FAQ for a complete list of coverage types and their descriptions

value

sport_event - coverage - property

Boolean

Signifies a coverage types is available when true

For example, type="lineups" value="true" signifies lineups are available for this sport event

Period Scores:
AttributeParent ElementTypeDescription
away_scoresport_event_status - period_scores - period_scoreIntegerAway team period score
home_scoresport_event_status - period_scores - period_scoreIntegerHome team period score
numbersport_event_status - period_scores - period_scoreIntegerPeriod number
typesport_event_status - period_scores - period_scoreStringPeriod type
regular_period, overtime, 1st_quarter, 2nd_quarter, 3rd_quarter, 4th_quarter, 1st_half, 2nd_half, penalties, 1st_pause, 2nd_pause, 3rd_pause, awaiting_extra, awaiting_penalties, interrupted, 1st_extra, 2nd_extra
Sport Event Status:

Attribute

Parent Element

Type

Description

away_score

sport_event_status

Integer

Total score for the away team in the match

away_normaltime_score

sport_event_status

Integer

Score for the away team in normal time

home_score

sport_event_status

Integer

Total score for the home team in the match

home_normaltime_score

sport_event_status

Integer

Score for the home team in normal time

match_status

sport_event_status

String

Status within a match (sport event). Provides more detail on the state of a sport event when live than status
ex. not_started, 1st_quarter, ended, cancelled

See our FAQ for a complete list of statuses and their definitions.

scount_abandoned

sport_event_status

Boolean

Signifies a sport event was abandoned by a scout when true

status

sport_event_status

String

Status of a sport event
ex. not_started, live, ended, closed

See our FAQ for a complete list of statuses and their definitions.

winner_id

sport_event_status

String

Unique ID of the match winner
ex. sr:competitor:44

Game Stats (Player):
AttributeParent ElementTypeDescription
assistsplayer - statisticsIntegerNumber of assists for a player in a game
blocksplayer - statisticsIntegerNumber of shots blocked for a player in a game
defensive_reboundsplayer - statisticsIntegerNumber of defensive rebounds for a player in a game
field_goals_attemptedplayer - statisticsIntegerNumber of field goal attempts for a player in a game
field_goals_madeplayer - statisticsIntegerNumber of field goals for a player in a game
free_throws_attemptedplayer - statisticsIntegerNumber of free throw attempts for a player in a game
free_throws_madeplayer - statisticsIntegerNumber of free throws for a player in a game
minutesplayer - statisticsIntegerNumber of minutes played for a player in a game
offensive_reboundsplayer - statisticsIntegerNumber of offensive rebounds for a player in a game
personal_foulsplayer - statisticsIntegerNumber of personal fouls for a player in a game
pointsplayer - statisticsIntegerNumber of points for a player in a game
stealsplayer - statisticsIntegerNumber of steals for a player in a game
technical_foulsplayer - statisticsIntegerNumber of technical fouls for a player in a game
three_pointers_attemptedplayer - statisticsIntegerNumber of three point attempts for a player in a game
three_pointers_madeplayer - statisticsIntegerNumber of three pointers for a player in a game
total_reboundsplayer - statisticsIntegerNumber of total rebounds (offense + defense) for a player in a game
turnoversplayer - statisticsIntegerNumber of turnovers for a player in a game
Game Stats (Team):
AttributeParent ElementTypeDescription
assistscompetitor - statisticsIntegerNumber of assists for a team in a game
ball_possessioncompetitor - statisticsIntegerPercentage of team ball possession for a game
biggest_leadcompetitor - statisticsIntegerBiggest lead in points for a team in a game
defensive_reboundscompetitor - statisticsIntegerNumber of defensive rebounds for a team in a game
foulscompetitor - statisticsIntegerNumber of fouls for a team in a game
free_throw_attempts_successfulcompetitor - statisticsIntegerNumber of free throws for a team in a game
free_throw_attempts_totalcompetitor - statisticsIntegerNumber of free throw attempts for a team in a game
leader_assistscompetitor - statisticsIntegerNumber of assists for the team leader in a game
leader_assists_playercompetitor - statisticsStringUnique player Id for the team assists leader in a game
ex. sr:player:611008
leader_pointscompetitor - statisticsIntegerNumber of points for the team leader in a game
leader_points_playercompetitor - statisticsStringUnique player Id for the team points leader in a game
ex. sr:player:611008
leader_reboundscompetitor - statisticsIntegerNumber of rebounds for the team leader in a game
leader_rebounds_playercompetitor - statisticsStringUnique player Id for the team rebounds leader in a game
ex. sr:player:611008
offensive_reboundscompetitor - statisticsIntegerNumber of offensive rebounds for a team in a game
reboundscompetitor - statisticsIntegerNumber of total rebounds (offense + defense) for a team in a game
shots_blockedcompetitor - statisticsIntegerNumber of shots blocked for a team in a game
stealscompetitor - statisticsIntegerNumber of steals for a team in a game
team_leadscompetitor - statisticsIntegerNumber of times a team had a lead in a game
team_reboundscompetitor - statisticsIntegerNumber of team rebounds in a game
team_turnoverscompetitor - statisticsIntegerNumber of team turnovers in a game
three_point_attempts_successfulcompetitor - statisticsIntegerNumber of three pointers for a team in a game
three_point_attempts_totalcompetitor - statisticsIntegerNumber of three point attempts for a team in a game
time_spent_in_leadcompetitor - statisticsIntegerNumber of minutes a team led in a game
timeoutscompetitor - statisticsIntegerNumber of timeouts used for a team in a game
turnoverscompetitor - statisticsIntegerNumber of turnovers for a team in a game
two_point_attempts_successfulcompetitor - statisticsIntegerNumber of two pointers for a team in a game
two_point_attempts_totalcompetitor - statisticsIntegerNumber of two point attempts for a team in a game
Venue:
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a competitor's home venue
ex. 15000
changedvenueBooleanSignifies a venue has been changed when true
city_namevenueStringCity name of a competitor's home venue
ex. Madrid
country_codevenueStringCountry code of a competitor's home venue
ex. ESP (Spain)
country_namevenueStringCountry name of a competitor's home venue
ex. Spain
idvenueStringUnique ID of a competitor's home venue
ex. sr:venue:7000
map_coordinatesvenueStringCoordinates of a competitor's home venue
ex. 40.423889,-3.671667
namevenueStringName of a competitor's home venue
ex. WiZink Center
reduced_capacityvenueBooleanOptional attribute signifying a venue has a restricted capacity when true
reduced_capacity_maxvenueIntegerValue of a venue's restrictued capacity
timezonevenueStringTimezone of a competitor's home venue
ex. Europe/Madrid
Language
Credentials
Header
Click Try It! to start a request and see the response here!