Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Competitor Profile

Global Basketball Competitor Profile Provides top-level information for a given team, including the full team roster, home venue, and team colors.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

300s Time To Live / Cache


Data Points

Category & Sport
AttributeParent ElementTypeDescription
country_codecompetitor_profile - categoryStringCountry code for a competition category

ex. FRA (France)
idcompetitor_profile - categoryStringUnique category ID for a competition

ex. sr:category:110
namecompetitor_profile - categoryStringName for a competition category

ex. France
idcompetitor_profile - sportStringUnique sport ID for a competitor

ex. sr:sport:2
namecompetitor_profile - sportStringName for a competitor's sport

ex. Basketball
Competitor
AttributeParent ElementTypeDescription
abbreviationcompetitorStringAbbreviation for a competitor name

ex. RMA (Real Madrid)
age_groupcompetitorStringAge group of a competitor, when applicable

ex. U23
countrycompetitorStringCountry of a competitor

ex. Spain
country_codecompetitorStringCountry code of a competitor

ex. ESP (Spain)
divisioncompetitorIntegerDivision number for a competitor
gendercompetitorStringGender for a competitor

male, female
idcompetitorStringUnique ID for a competitor

ex. sr:competitor:3540 (Real Madrid)
namecompetitorStringName for a competitor

ex. Real Madrid
statecompetitorStringState of a competitor

ex. TX (Texas)
virtualcompetitorBooleanSignifies a competitor is a virtual team when true. Used for placeholder teams in TBD vs TBD matchups.
Jersey
AttributeParent ElementTypeDescription
basejerseys - jerseyStringRGB color code of a competitor's base jersey

ex. e41e2c
horizontal_stripesjerseys - jerseyBooleanSignifies a competitor's jersey has horizontal stripes when true
numberjerseys - jerseyStringRGB color code of a competitor's jersey number

ex. ffffff
shirt_typejerseys - jerseyStringShirt type of a competitor's jersey

ex. no_sleeves
sleevejerseys - jerseyStringRGB color code of a competitor's jersey sleeves

ex. e41e2c
splitjerseys - jerseyBooleanSignifies a competitor's jersey is split when true
squaresjerseys - jerseyBooleanSignifies a competitor's jersey is squares when true
stripesjerseys - jerseyBooleanSignifies a competitor's jersey has stripes when true
typejerseys - jerseyStringType of competitor jersey entry

ex. home, away
Manager
AttributeParent ElementTypeDescription
country_codemanagerStringCountry code of a manager

ex. ENG (England)
date_of_birthmanagerDateDate of birth of a manager

ex. 1967-06-16
gendermanagerStringGender of a manager

male, female
idmanagerStringUnique ID of a manager

ex. sr:player:52829
namemanagerStringName of a manager

ex. Klopp, Jurgen
nationalitymanagerStringNationality of a manager

ex. Germany
nicknamemanagerStringNickname of a manager
Player
AttributeParent ElementTypeDescription
country_codeplayers - playerStringCountry code of a player

ex. CPV (Cape Verde)
date_of_birthplayers - playerDateDate of birth of a player

ex. 1992-03-22
heightplayers - playerIntegerHeight of a player in centimeters

ex. 220
idplayers - playerStringUnique ID of a player

ex. sr:player:608026
jersey_numberplayers - playerIntegerJersey number of a player
nameplayers - playerStringName of a player

ex. Tavares, Edy
nationalityplayers - playerStringNationality of a player

ex. Cape verde
nicknameplayers - playerStringNickname of a player
typeplayers - playerStringPosition of a player

NA, G, G-F, C, F-G, F-C, C-F, PF, PG, SF, SG, F
weightplayers - playerIntegerWeight of a player in kilograms

ex. 120
Venue
AttributeParent ElementTypeDescription
capacityvenueIntegerCapacity of a competitor's home venue

ex. 15000
changedvenueBooleanSignifies a venue has been changed when true
city_idvenueStringUnique ID of a city

ex. sr:city:59
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 restricted capacity
timezonevenueStringTimezone of a competitor's home venue

ex. Europe/Madrid
Path Params
string
enum
required
Defaults to trial

The access level of your API key

trial, production

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

da (Danish), de (German), el (Greek), en (English), es (Spanish), fi (Finnish), fr (French), hi (Hindi), hu (Hungarian), id (Indonesian), it (Italian), ja (Japanese), ko (Korean), nl (Dutch), no (Norwegian), pt (Portuguese), ru (Russian), sr (Serbian), srl (Serbian Latin), sv (Swedish), th (Thai), tr (Turkish), zh (Chinese - simplified), zht (Chinese - traditional)

The above codes are the fully supported languages for this API. Click here for valid language codes and a tabular list of available languages per competition.

string
required
Defaults to sr:competitor:3426

Unique Id of a competitor

Example: sr:competitor:3426

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json