participants.compare.index

Resource information

URLhttps://api.statscore.com/v2/participants/{participant_id}/compare
MethodGET

Description

Returns the comparisons between two participants
Cache60 seconds
Authorization requiredYes

Method parameters

NameData typeDescription
participant_idxsd:intREQUIRED. The requested participant identifier to compare

Query parameters

NameData typeDescription
tokenxsd:stringREQUIRED. More information concerning authorization in API introduction section
langxsd:string

Determines language for the output data

compare_participant_idxsd:intREQUIRED. Second participant id to compare
date_fromxsd:stringSelection datetime, format 'yyyy-mm-dd hh:mm:ss'. Date from which events should be returned
events_detailsxsd:string

Determines if subnodes of events will be visible. Possible values:

  • yes - events subnodes will be shown
  • no - events subnodes will be hidden
competition_idxsd:stringIt allows for comparison within matches played in selected competitions 
competitions_detailsxsd:string

Determines if parent nodes of events will be visible. Possible values:

  • yes - events parent nodes will be shown
  • no - events parent nodes will be hidden
tzxsd:stringDetermines timezone for the output data 


Method calling examples

Link
Description
https://api.statscore.com/v2/participants/136928/compare?token={{YOUR_TOKEN}}&compare_participant_id=136929Returns comparisons between two participants in JSON format

Output elements

participants
participants > participant

idUnique identifier of the participant
type

Participant type. Possible values:

  • team
  • person
  • double
nameParticipants name
short_nameParticipants abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g. BAR, REA
gender

Participants gender. Possible value:

  • male
  • female
  • mixed (e.g for mixed doubles in tennis )
area_idUnique identifier for the area represented by the participant.  
area_nameArea name represented by the participant.
area_codeMax 3 characters in length for the abbreviated area name e.g. GER, POL, FRA.
sport_idUnique identifier for the sport in which the participant is involved.
sport_nameName of the sport in which the participant is involved.
national

Determines if participant is a national team. Possible values:

  • yes
  • no
websiteParticipants official website
utInformation about when the date and time of the record was last updated. Format UNIX_TIMESTAMP
old_participant_iddeprecated. The attribute will be removed in the next API version
slugfriendly url for participant
logoAttribute for internal purpose
virtual

Determines if the participant is real player / team or virtual. Possible values:

  • yes
  • no
shirt_nrInformation about player's season number

participants > participant > details
participants > participant > details > detail
foundedDate when the team was founded
phonePhone number
emailEmail address
addressAddress where the team is located
venue_idUnique identifier for the venue in which the team plays home games
venue_nameName of the venue in which the team plays home games
weightParticipants weight
heightParticipants height
nicknameParticipants nickname
position_nameName of the participants position
birthdateParticipants date of birth
born_placeParticipants place of birth
is_retired

Determines if participant has retired. Possible values:

  • yes
  • no
subtype

Participant subtype name. Possible values:

  • athlete
  • coach
  • referee
  • director
head2head
head2head > all_matches_stats
participant1_wonNumber of matches won for the first particant (first compare team) in all head2head matches
participant1_drawNumber of draws for the first particant (first compare team) in all head2head matches
participant1_lostNumber of matches lost for the first particant (first compare team) in all head2head matches
participant2_wonNumber of matches won for the second particant (second compare team) in all head2head matches
participant2_drawNumber of draws for the second particant (second compare team) in all head2head matches
participant2_lostNumber of matches lost for the second particant (second compare team) in all head2head matches
total_events_playedNumber of events played
head2head > last_10_matches_stats
participant1_wonNumber of matches won for the first particant (first compare team) in the last 10 matches
participant1_drawNumber of draws for the first particant (first compare team) in the last 10 matches
participant1_lostNumber of matches lost for the first particant (first compare team) in the last 10 matches
participant2_wonNumber of matches won for the second particant (second compare team) in the last 10 matches
participant2_drawNumber of draws for the second particant (second compare team) in the last 10 matches
participant2_lostNumber of matches lost for the second particant (second compare team) in the last 10 matches
head2head > h2h_events
head2head > h2h_events > competitions
head2head > h2h_events > competitions > competition

idUnique identifier for the competition
ls_idFor internal purposes
nameName of the the competition e.g. U19 World Champ. Possible translation of the attribute
sourceFor internal purposes
source_dcFor internal purposes
source_superFor internal purposes
short_nameAbbreviated name of the competition e.g. U19 WCH, Max 20 characters. Possible translation of the attribute
mini_name

Mini name of the competition. Max 3 characters in length e.g. U19

gender

Competition gender. Possible values:

  • male
  • female
  • mixed
type

Competitions type. Possible values:

  • country_league - e.g Premier Division
  • country_cups - e.g. FA Cup
  • international - e.g. World Cup
  • international_clubs - e.g. Champions League 
  • friendly - friendly matches
  • individual - for speedway individual competitions such as Speedway GP
  • team - for speedway national competitions
  • single - for tennis competitions
  • double - for tennis competitions
  • mixed - for tennis competitions
  • undefined - other
area_idUnique identifier for area in which competitions are played. The complete list of possible areas can be retrieved using the API resource: areas.index
area_nameName of area in which competitions are played. Possible translation of the attribute
area_type

 Type of area in which competitions are played. Possible values:

  • country
  • international
area_sortThe parameter used to sort competitions in a country e.g. Premier League is 1st and the Championship is 2nd in English competitions. Sorting direction is ascending
area_codeMax 3 characters, area in which competitions are played
overall_sortThe parameter used to sort competitions. Sorting direction is ascending
sport_idUnique identifier for the sport in which the competition is played. The complete list of possible sports can be retrieved using the API resource: sports.index 
sport_nameName of the sport in which the competition is played. Possible translation of the attribute
tour_idUnique identifier for the tour in which thecompetition is played. The complete list of possible tours can be retrieved using the API resource: tours.index
tour_nameName of the tour in which the competition is played
utInformation about when the date and time of the competition record was last updated. Format UNIX_TIMESTAMP
old_competition_idDEPRECATED. The attribute will be removed in the next API version
slugfriendly url for competition
status

Possible values:

  • active
  • inactive
  • archived (for competitions that no longer take place)

head2head > h2h_events > competitions > competition > seasons
head2head > h2h_events > competitions > competition > seasons > season

idUnique identifier for the season.
nameName of the season e.g. Premiership 2014/15
year

Determines the season year e.g.

  • 1970
  • 1970/71
  • 1971
  • 1971/72
  • 2000
  • 2000/01
  • 2014
  • 2014/15
actual

Determines if the season is actual. Possible values:

  • yes
  • no
utInformation about the date and time of when the season record was last updated. Format UNIX_TIMESTAMP
old_season_iddeprecated. The attribute will be removed in the next API version
stats_lvlSeason's stats level. Possible values: vip, gold, silver, bronze
team_connectionFor internal usage

head2head > h2h_events > competitions > competition > seasons > season > stages
head2head > h2h_events > competitions > competition > seasons > season > stages > stage

idUnique identifier for the stage
stage_name_idUnique identifier for the stage's name.
nameName of the stage. Possible translation of the attribute
start_dateDate when stage begins. Format YYYY-MM-DD
end_dateDate when stage ends. Format YYYY-MM-DD
show_standings

Determines if the stage contains standings. Possible values:

  • yes
  • no
groups_nrThe number of groups that are part of the stage
sortThe sort order for the stage. Sorting direction is ascending
is_current

Possible values:

  • yes
  • no
utInformation about the date and time of when the stage record was last updated. Format UNIX_TIMESTAMP
old_stage_iddeprecated. The attribute will be removed in the next API version
has_brackets

Information about the availability of tournament bracket for the stage. Possible values:

  • yes
  • no
type

Information about the expected Stage type. Possible values:

  • null 

  • bracket type

  • standing type

head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups
head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups > group

idUnique identifier for the group
nameName of the group
utInformation about the date and time of when the group record was last updated. Format UNIX_TIMESTAMP

head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups > group > events
head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups > group > events > event

idUnique identifier for the event
ls_idInternal
nameName of the event e.g. Spain - Italy
sourceIdentificator of scout related to the event. Attribute for internal purposes
source_dcInternal
source_superInternal
relation_status

Relation status. Attribute for internal purposes. Possible value:

  • not_started - for an event that has not started
  • in_progress - for a live event
  • finished - for an event that has finished
  • 30_min_left - scout confirms his ability to deliver the coverage 30 min before the event
  • 5_min_left - scout confirms his ability to deliver the coverage 5 min before the event
start_dateDate when the event starts in the format DATE_TIME (2015-03-01 11:02)
ft_only

Determines when the result/score of the event is updated. Possible values:

  • yes - result/score is updated only when the event is finished 
  • no - result/score is updated during the event
coverage_type

Type of event coverage. Can be comma separated string. Possible values:

  • from_venue - means the scout is relaying the event directly from the stadium (max. latency 1 second)
  • from_tv - means the scout is relaying the event from TV transmission (max. latency 8 seconds)
  • basic - for this type of coverage we don't provide detailed event incidents (max. latency around 60 seconds)
channel_idInternal
channel_nameInternal
scoutsfeed

Information concerning scouts coverage. Possible values:

  • yes - means that play by play incidents will be available for the event
  • no - means that play by play incidents will not be available for the event
status_idUnique identifier of the event status
status_name

Name of the event status

status_type

Type of status. Possible values:

  • live
  • scheduled
  • finished
  • cancelled
  • interrupted
  • deleted
  • other
sport_idUnique identifier for the sport in which event is played. The complete list of possible sports can be retrieved using the API resource: sports.index
sport_nameName of the sport in which event is played
dayDay of the season
clock_timeHow many seconds have passed in the current event period. Possible empty value
clock_status

Clock status. Possible value:

  • running
  • stopped
winner_idWho is the winner of the match
progress_idWho advanced to the next round
bet_status

Possible value:

  • active
  • suspended
bet_cards

Changed when there is a possibility of a card. Possible value:

  • active
  • suspended
bet_corners

Changed when there is a possibility of a corner. Possible value:

  • active
  • suspended
neutral_venue

Determines if the event is played at a neutral venue. Possible values:

  • yes
  • no
item_status

Describes status of the item (record). Possible values:

  • active - the record is active
  • deleted - the record was deleted by the admin. When an event was added by mistake
utInformation about when the date and time of the event record was last updated. Format UNIX_TIMESTAMP
old_event_iddeprecated. The attribute will be removed in the next API version
slugfriendly url for event
verified_result

Possible value:

  • yes - result is verified with an official source
  • no - result is not verified with an official source
result_verified_byInternal
result_verified_atInternal
is_protocol_verifiedInternal
protocol_verified_byInternal
protocol_verified_atInternal
round_idUnique identifier for the round in which event is played. Possible null value. 
round_nameName of the round
competition_idUnique identifier for the competition
competition_short_nameAbbreviated name of the competition
client_event_idUnique event identifier for the client.
booked

Possible value:

  • yes - result is booked in selected product
  • no - result is not booked in selected product

Required with product.

booked_by

When the value is 0 then event was autobooked.

Has value only when query parameter product is provided.

inverted_participantsInternal
venue_idDeprecated
bfsInternal
event_stats_lvl

Information about the statistics level. Possible values:

  • bronze
  • silver
  • gold
  • vip
event_stats_lvl_live

Information about expected statistics level when the match is LIVE. Possible values:

  • bronze
  • silver
  • gold
  • vip
event_stats_lvl_after

Information about expected statistics level after the end of the match. Possible values:

  • bronze
  • silver
  • gold
  • vip
due_toInternal
latency

Information about the expected latency. Possible values:

  • null (for the event with scoutsfeed=no parameter)
  • 1-2s
  • 3-6s
  • 7-15s
event_stats_levelInternal
verified_result

Possible value:

  • yes - result is verified with an official source
  • no - result is not verified with an official source
is_coverage_limitedDetermines if event has limited information about players statistics
played_timeShows how many seconds have passed in the event (including additional time). Possible empty value.

head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups > group > events > event > details
head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups > group > events > event > details > detail

idUnique identifier for the detail
nameName of the detail. Possible values are different depending on the sport
valueValue related to the detail

head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups > group > events > event > participants
head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups > group > events > event > participants > participant

idUnique identifier of the participant
type

Participant type. Possible values:

  • team
  • person
  • double
nameParticipants name
short_nameParticipants abbreviated name, max length: 20 characters
acronymMax 3 characters in length mini name, e.g. BAR, REA
gender

Participants gender. Possible value:

  • male
  • female
  • mixed (e.g for mixed doubles in tennis )
area_idUnique identifier for the area represented by the participant.  
area_nameArea name represented by the participant.
area_codeMax 3 characters in length for the abbreviated area name e.g. GER, POL, FRA.
sport_idUnique identifier for the sport in which the participant is involved.
sport_nameName of the sport in which the participant is involved.
national

Determines if participant is a national team. Possible values:

  • yes
  • no
websiteParticipants official website
utInformation about when the date and time of the record was last updated. Format UNIX_TIMESTAMP
old_participant_iddeprecated. The attribute will be removed in the next API version
slugfriendly url for participant
logoAttribute for internal purpose
virtual

Determines if the participant is real player / team or virtual. Possible values:

  • yes
  • no
shirt_nrInformation about player's season number

head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups > group > events > event > participants > participant > results
head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups > group > events > event > participants > participant > results > result

idUnique identifier for the result
short_nameAbbreviated name of the result.
nameName of the result. Possible values are different depending on the sport
valueValue related to the result
data_type

Defines type of field generated on front (internal purpose only)

  • integer
  • decimal
  • binary_text
  • binary
  • text
  • signed_integer

head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups > group > events > event > participants > participant > stats
head2head > h2h_events > competitions > competition > seasons > season > stages > stage > groups > group > events > event > participants > participant > stats > stat

idUnique identifier for the statistic
short_nameAbbreviated name of the statistic.
nameName of the statistic. Possible values are different depending on the sport
valueValue related to the statistic
data_type

Defines type of field generated on front (internal purpose only)

  • integer
  • decimal
  • binary_text
  • binary
  • text
  • signed_integer