Page Comparison

Resource information

URL	https://api.softnetsportstatscore.com/v2/participants/{participant_id}/compare	XSD	https://api.softnetsport.com/assets/API/docs/xsd/participants.compare.xsd
Method	GET
Description	Returns the comparisons between two participants
Cache	60 seconds
Authorization required	Yes

...

Name	Data type	Description
token	xsd:string	REQUIRED. More information concerning authorization in API introduction section
lang	xsd:string	Determines language for the output data
compare_participant_id	xsd:int	REQUIRED. Second participant id to compare
date_from	xsd:string	Selection datetime, format 'yyyy-mm-dd hh:mm:ss'. Date from which events should be returned
events_details	xsd:string	Determines if subnodes of events will be visible. Possible values: yes - events subnodes will be shown no - events subnodes will be hidden
competition_id	xsd:string	It allows for comparison within matches played in selected competitions
competitions_details	xsd: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
tz	xsd:string	Determines timezone for the output data

...

Method calling examples

softnetsport.xml&sport_id=5 XML format

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

Output elements

.

participants

....details

participants > participant

idUnique identifier of the participanttype

Participant type. Possible values:

team
person

nameParticipant nameshort_nameParticipant abbreviated name , max length: 20 charactersacronymMax 3 characters in length mini name, e.g. BAR, REAgender

Participant gender. Possible value:

male
female
mixed (e.g for doubles in tennis)

area_idUnique identifier for the area represented by the participant
area_nameArea name represented by the participantarea_codeMax 3 characters in length for the abbreviated area name e.g: GER, POL, FRAsport_idUnique identifier for the sport in which participant takes part sport_nameName of the sport in which participant takes partnational

Determines if participant is a national team. Possible values:

yes
no

websiteParticipants official websiteutInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMPold_participant_iddeprecated. The attribute will be removed in next API versionslugfriendly url for participantlogoAttribute for internal purposes

Include Page

	Participant node
	Participant node

participants > participant > details

participants > participant > details > detail

founded	Date when the team was founded
phone	Phone number
email	Email address
address	Address where the team is located
venue_id	Unique identifier for the venue in which the team plays home games
venue_name	Name of the venue in which the team plays home games
weight	Participants weight
height	Participants height
nickname	Participants nickname
position_name	Name of the

participants

participants position
birthdate	Participants date of birth
born_place	Participants 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_won	Number of matches won for the first particant (first compare team) in all head2head matches
participant1_draw	Number of draws for the first particant (first compare team) in all head2head matches
participant1_lost	Number of matches lost for the first particant (first compare team) in all head2head matches
participant2_won	Number of matches won for the second particant (second compare team) in all head2head matches
participant2_draw	Number of draws for the second particant (second compare team) in all head2head matches
participant2_lost	Number of matches lost for the second particant (second compare team) in all head2head matches
total_events_played	Number of events played

..

head2head > last_10_matches_stats

participant1_won	Number of matches won for the first particant (first compare team) in the last 10 matches
participant1_draw	Number of draws for the first particant (first compare team) in the last 10 matches
participant1_lost	Number of matches lost for the first particant (first compare team) in the last 10 matches
participant2_won	Number of matches won for the second particant (second compare team) in the last 10 matches
participant2_draw	Number of draws for the second particant (second compare team) in the last 10 matches
participant2_lost	Number of matches lost for the second particant (second compare team) in the last 10 matches

..

head2head > h2h_events

...competitionsidUnique identifier for the competitionnameName of the the competition e.g. U19 World Champshort_nameAbbreviated name of the competition e.g. U19 WCH, Max 20 charactersmini_name

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

gender

Competition gender. Possible values:

male
female
mixed
undefined

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 area_nameName of area in which competitions are playedarea_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 ascendingarea_codeMax 3 characters in length for the area in which competitions are playedoverall_sortThe parameter used to sort competitions. Sorting direction is ascending
sport_idUnique identifier for the sport in which a competition is playedsport_nameName of the sport in which a competition is playedtour_idUnique identifier for the tour in which competition is played tour_nameName of the tour in which competition is playedutInformation about the date and time of when the competition record was last updated. Format UNIX_TIMESTAMPold_competition_iddeprecated. The attribute will be removed in the next API versionslugfriendly url for competition

....seasons

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

Determines the year of the season e.g.

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

utInformation about the date and time of when the season record was last updated. Format UNIX_TIMESTAMPold_season_iddeprecated. The attribute will be removed in the next API version

.....stages

idUnique identifier for the stagenameName of the stagestart_dateDate when stage begins. Format YYYY-MM-DDend_dateDate when stage ends. Format YYYY-MM-DDshow_standings

Determines if the stage contains standings. Possible values:

yes
no

groups_nrThe number of groups that are part of the stagesortThe sort order for the stage. Sorting direction is ascendingis_current

Possible values:

yes
no

utInformation about the date and time of when the stage record was last updated. Format UNIX_TIMESTAMPold_stage_iddeprecated. The attribute will be removed in the next API version

......group

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

.......events

idUnique identifier for the eventnameName of the event e.g. Spain - Italystart_dateDate when the event starts in format DATE_TIME (2015-03-01 11:02)ft_only

Determines if the result of the event is updated only at full-time. Possible values:

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

coverage_type

Type of event coverage. Possible values:

venue - means the scout is relaying the event directly from the stadium
tv - means the scout is relaying the event from a tv transmission

scoutsfeed

Information concerning scouts coverage. Possible values:

yes
no

status_idUnique identifier of the event status status_name

Name of the event status

status_type

Type of the status. Possible values:

live
scheduled
finished
cancelled
interrupted
deleted
other

sport_idUnique identifier for the sport in which the event takes part sport_nameName of the sport in which the event takes partclock_timeHow many seconds have passed in the current event period. Possible empty valueclock_status

Clock status. Possible value:

running
stopped

bet_status

Possible value:

active
suspended

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

source Identificator of scout related to the event. Attribute for internal purposeswinner_idWho is the winner of the matchprogress_idWho advanced to the next rounddayDay of the seasonround_idUnique identifier for the round in which event is played. Possibble null value round_nameName of the roundneutral_venue

Determines if 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. In the case of when an event was added by mistake

verified_result

Possible value:

yes - result is verified with official source
no - result is not verified with official source

booked

Possible values:

yes
no
empty - if product/booked parameters not set.

booked_by

When the value is 0 then event was autobooked.

Has value only when query parameter product is provided.

client_event_id
Event id in client system (if mapped) or empty if product/booked parameters not set.utInformation about the date and time of when the event record was last updated. Format UNIX_TIMESTAMPold_event_iddeprecated. The attribute will be removed in the next API versionslugfriendly url for eventvenue_idUnique identifier for the venue in which the event is played........details........detailidUnique identifier for the detailnameDetails name e.g. Weather conditionsvalueValue related to the detail

........participants

.........participant

counterNumber of participants in the event. Participant with counter="1" is the home team.idUnique identifier for the participant (team or person)typeType of the participantnameParticipants name e.g. for a team - FC Barcelona, for a person, Gerard Piqueshort_nameShort name of the participantacronymAn acronym is a word or name formed as an abbreviation from the participant name.gender

Participant gender. Possible values:

male
female
mixed (e.g. for doubles in tennis)

area_idUnique identifier for the area represented by the participantarea_nameArea name represented by the participantarea_codeMax 3 characters in length of the abbreviated area name e.g. GER, POL, FRAsport_idUnique identifier for the sport in which the participant takes partsport_nameName of the sport in which participant takes partnational

Determines if participant is a national team. Possible values:

yes
no

websiteParticipants official websiteutInformation about the date and time of when the record was last updated. Format UNIX_TIMESTAMPold_participant_idDeprecated. The attribute will be removed in next API versionslugFriendly url for participantlogoIs the logo of participant available of nor.

..........results

...........result

idUnique identifier of the resultshort_nameAbbreviated name of the result.nameName of the result. Possible values are different depending on the sport valueValue related to the result..........stats...........statidUnique identifier of the statisticshort_nameAbbreviated name of the statistic.nameName of the statistic. Possible values are different depending on the sport valueValue related to the statistic

head2head > h2h_events > competitions

head2head > h2h_events > competitions > competition

Include Page

	Competition node
	Competition node

head2head > h2h_events > competitions > competition > seasons

head2head > h2h_events > competitions > competition > seasons > season

Include Page

	Season node
	Season node

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

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

Include Page

	Stage node
	Stage node

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

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

Include Page

	Group node
	Group node

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

Include Page

	Event node
	Event node

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

Include Page

	Detail2 node
	Detail2 node

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

Include Page

	Participant node
	Participant node

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

Include Page

	Result2 node
	Result2 node

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

Include Page

	Stat2 node
	Stat2 node

Versions Compared

Old Version 46

New Version Current

Key

Resource information

Output elements