Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Competitor Profile

Provides top-level information for a given team, including the full team roster, manager, home venue, and team colors.

⏱️

Update Frequency

TTL / Cache: 300 seconds

Data Updates: Player/roster data checks occur two weeks before the competition start


Data Points

Category & Sport
AttributeParent ElementTypeDescription
country_codecompetitor_profile - categoryStringCountry code for a competitor's category

ex. ENG (England)
idcompetitor_profile - categoryStringUnique category ID for a competitor

ex. sr:category:1
namecompetitor_profile - categoryStringName for a competitor's category

ex. England (Premier League)
idcompetitor_profile - sportStringUnique sport ID for a competitor

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

ex. Soccer
Competitor
AttributeParent ElementTypeDescription
abbreviationcompetitorStringAbbreviation for a competitor name

ex. LIV (Liverpool FC)
age_groupcompetitorStringAge group of a competitor, when applicable

ex. U23
countrycompetitorStringCountry of a competitor

ex. England
country_codecompetitorStringCountry code of a competitor

ex. ENG (England)
gendercompetitorStringGender for a competitor

male, female
idcompetitorStringUnique ID for a competitor

ex. sr:competitor:44 (Liverpool FC)
namecompetitorStringName for a competitor

ex. Liverpool FC
short_namecompetitorStringName for a competitor

ex. Liverpool
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
horizontal_stripes_colorjerseys - jerseyStringRGB color code of a competitor's horizontal jersey stripes

ex. e41e2c
numberjerseys - jerseyStringRGB color code of a competitor's jersey number

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

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

ex. e41e2c
sleeve_detailjerseys - jerseyStringRGB color code of a competitor's jersey sleeves detail

ex. ffffff
splitjerseys - jerseyBooleanSignifies a competitor's jersey is split when true
split_colorjerseys - jerseyStringRGB color code of a competitor's jersey split

ex. ffffff
squaresjerseys - jerseyBooleanSignifies a competitor's jersey is squares when true
squares_colorjerseys - jerseyStringRGB color code of a competitor's jersey squares

ex. ffffff
stripesjerseys - jerseyBooleanSignifies a competitor's jersey has stripes when true
stripes_colorjerseys - jerseyStringRGB color code of a competitor's jersey stripes

ex. ffffff
typejerseys - jerseyStringType of competitor jersey entry

ex. home, away, goalkeeper, third
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
preferred_footmanagerStringPreferred foot of a manager

left, right
Player
AttributeParent ElementTypeDescription
country_codeplayers - playerStringCountry code of a player

ex. EGY (Egypt)
country_of_birthplayers - playerStringBirth country of a player

ex. Egypt
date_of_birthplayers - playerDateDate of birth of a player

ex. 1992-06-15
genderplayers - playerStringGender of a player

male, female
heightplayers - playerIntegerHeight of a player in centimeters

ex. 175
idplayers - playerStringUnique ID of a player

ex. sr:player:159665
jersey_numberplayers - playerIntegerJersey number of a player
loaned_to_competitor_idplayers - playerStringUnique ID of the competitor a player is currently on loan to

ex. sr:competitor:9
nameplayers - playerStringName of a player

ex. Salah, Mohamed
nationalityplayers - playerStringNationality of a player

ex. Egypt
nicknameplayers - playerStringNickname of a player
on_loanplayers - playerBooleanSignifies a player is on loan to this team when true
place_of_birthplayers - playerStringPlace of birth of a player

ex. Basyoun, El Gharbia
preferred_footplayers - playerStringPreferred foot of a player

left, right
typeplayers - playerStringPosition of a player

goalkeeper, defender, midfielder, forward
weightplayers - playerIntegerWeight of a player in kilograms

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

ex. 60000
changedvenueBooleanSignifies a venue has been changed when true
city_namevenueStringCity name of a competitor's home venue

ex. Liverpool
country_codevenueStringCountry code of a competitor's home venue

ex. ENG (England)
country_namevenueStringCountry name of a competitor's home venue

ex. England
idvenueStringUnique ID of a competitor's home venue

ex. sr:venue:579
map_coordinatesvenueStringCoordinates of a competitor's home venue

ex. 53.430622,-2.960919
namevenueStringName of a competitor's home venue

ex. Anfield
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/London
Language
Credentials
Header
Click Try It! to start a request and see the response here!