Page Comparison

Resource information

URL	https://api.

softnetsport

statscore.com/v2/livescore

XSD

https://api.softnetsport.com/assets/API/docs/xsd/livescore.index.xsd

Method	GET
Description	Returns

the

LIVE events related

with

to competitions, seasons, stages and groups

Package

This resource is included in the LIVESCORE package

Cache	30 seconds
Authorization required	Yes

Method parameters

Name	Type	Description
There are

not

no method parameters in this resource

Query parameters

Name	Type	Description
token	xsd:string	REQUIRED.

More

There is more information concerning

oAuth token: oAuth 2.0 authorization

authorization in the API introduction section
lang	xsd:string	Determines the language for the output data.

softnetSPORT API provides the following languages:

The complete list of possible languages can be retrieved using the API resource: languages.index
page	xsd:int	Determines offset of paginated data. Default value is 1 which means first page
limit	xsd:int	Determines maximum number of returned records on page. Used in paginated data. Default value

is 100

is 50.

Possible values: 5, 10, 25, 50, 100

, 250, 500


date_from	xsd:string	Selection datetime, format 'yyyy-mm-dd hh:mm:ss'. Date from which events should be returned. If you use a single date_from parameter you will receive all events that start in the 24 hours from requested date
date_to	xsd:string	Selection datetime, format 'yyyy-mm-dd hh:mm:ss'. End date of returned events. The maximum period beetwen date_from and date_to parameter is 30 days. This rule is not valid when you use the following query parameter in your request: season_id, stage_id, group_id, participant_id
sport_id	xsd:int	Determines the sport identifier in which the events are played

. softnetSPORT API provides the following sports:

. Possibility to input multiple identifiers, separated by comma. The complete list of possible sports can be retrieved using the API resource: sports.index
area_id	xsd:int	Determines the area identifier in which the events are played

. softnetSPORT API provides the following sports:

. Possibility to input multiple identifiers, separated by comma. The complete list of possible areas can be retrieved using the API resource: areas.index
competition_id	xsd:int	Determines the competition identifier in which the events are played

. softnetSPORT API provides the following sports:

. Possibility to input multiple identifiers, separated by comma. The complete list of possible competitions can be retrieved using the API resource: competitions.index
season_id	xsd:int	Determines the season identifier in which the events are played.

softnetSPORT API provides the following sports:

The complete list of possible seasons can be retrieved using the API resource: seasons.index
stage_id	xsd:int	Determines the stage identifier in which the events are played.

softnetSPORT API provides the following sports:

Possibility to input multiple identifiers, separated by comma. The complete list of possible stages can be retrieved using the API resource: stages.index
group_id	xsd:int	Determines the group identifier in which the events are played

. softnetSPORT API provides the following sports:

. Possibility to input multiple identifiers, separated by comma. The complete list of possible groups can be retrieved using the API resource: groups.index
participant_id	xsd:int	Determines the identifier of the participant.

softnetSPORT API provides the following statuses:

The complete list of possible participants can be retrieved using the API resource: participants.index

events

multi_

detailscompetitions_details

ids	xsd:string

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

yes - events subnodes will be shown
no - events subnodes will not be hidden

List of events identifiers separated by a comma (e.g. 123,234,321) for which you want to get the events details. (Up to 100 ids)
venue_type	xsd:string

Determines if parent nodes of events will be visible.competitions ..competition idUnique identifier for the competitionnameName of the the competition i.e.: U19 World Champshort_nameShorter name of the competition i.e.: U19 WCH, Max 20 charactersmini_name

Mini name of the competition. Max 3 characters length i.e.: U19

gender

Competition gender. Possible values:

male
female
mixed
undefined

type

Competitions type. Possible values:

country_league - i.e.: Premier Division
country_cups - i.e.: FA Cup
international - i.e.: World Cup
international_clubs - i.e.: 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 of area in which competitions are played. softnetSPORT API provides the following areas: areas.indexarea_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 the country, i.e. Premier League is 1st and the Championship is 2nd in English competitions. Sorting direction is ascendingarea_codeMax 3 characters length of area in which competitions are playedoverall_sortThe parameter used to sort competitions. Sorting direction is ascending
sport_idUnique identifier of the sport in which competition is played. softnetSPORT API provides the following sports: sports.indexsport_nameName of the sport in which competition is playedtour_idUnique identifier of the tour in which competition is played. softnetSPORT API provides the following tours: tours.indextour_nameName of the tour in which competition is playedutInformation about date and time 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

....season

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

Determines the season year f.e:

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

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

.....stages

.....stage

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 a standings. Possible values:

yes
no

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

Possible values:

yes
no

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

......groups

......group

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

........events

.........event

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

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

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

coverage_type

Type of event coverage. Possible values:

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

scoutsfeed

Information concerning scouts coverage. Possible values:

yes
no

status_idUnique identifier of the event status. softnetSPORT API provides the following statuses: statuses.indexstatus_name

Name of the event status

status_type

Type of the status. Possible values:

live
scheduled
finished
cancelled
interrupted
deleted
other

sport_idUnique identifier of the sport in which event is played. softnetSPORT API provides the following sports: sports.indexsport_nameName of the sport in which event is playeddayDay in the seasonneutral_venue

Determines if event is played on neutral venue. Possible values:

yes
no

item_statusDescribes status of

Additional parameter for participant filter. Works only when participant_id query is used. Determines if the provided participant plays as the home or away team.
By default the value of "all" is set. Possible values:

yes - events parent nodes will be shown
no - events parent nodes will not be hidden

tzxsd:stringDetermines timezone for the output data. softnetSPORT API provides the following timezones: timezones

Method calling examples

Link	Description
https://api.softnetsport.com/v2/livescore.xml?token={{YOUR_TOKEN}}	Returns list of all in progress (live) events in XML format
https://api.softnetsport.com/v2/livescore?token={{YOUR_TOKEN}}	Returns list of all in progress (live) events in JSON format

Output elements

...

home - filters events in which the selected participant plays as the home team away - filters events in which the selected participant plays as the away team all - filters events in which the selected participant plays as the home team or the away team
sort_type	xsd:string	Determines sort order of data. Possible values: day - events are sorted by the day of the event competition - events are sorted by the name of the competitinon start_date - events are sorted by the start_date most_popular - competitions are sorted by the overall_sort
sort_order	xsd:string	Additional parameter for sort_type which determines the direction of sorting (ascending, descending) By default the value of "desc" is set. Possible values: asc - sort ascending desc - sort descending
status_id	xsd:string	Determines the identifier of the event status. The complete list of possible statuses can be retrieved using the API resource: statuses.index
status_type	xsd:string	Determines the identifier of the status type. Can be comma separated string. Possible values: Possible values: live scheduled finished cancelled interrupted deleted other
coverage_type	xsd:string	Determines coverage type. 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)
scoutsfeed	xsd:string	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
latency	xsd:string	Information about the expected latency. Possible values: null (for the event with scoutsfeed=no parameter) 1-2s 3-6s 7-15s
event_stats_lvl	xsd:string	Information about the statistics level. Possible values: bronze silver gold vip
event_stats_lvl_live	xsd:string	Information about expected statistics level when the match is LIVE. Possible values: bronze silver gold vip
event_stats_lvl_after	xsd:string	Information about expected statistics level after the end of the match. Possible values: bronze silver gold vip
events_details	xsd:string	Determines if subnodes of events will be visible. Possible values: yes - events subnodes will be shown no - events subnodes will not be shown
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 not be shown
item_status	xsd:string	Describes the status for the item (record). Possible values: active - the record is active deleted - the record was deleted by the admin.

In case when event was

When in the case of an event being added by mistake

utInformation about date and time when the event record was last updated. Format UNIX_TIMESTAMPold_event_iddeprecated. The attribute will be removed in the next API versionslugfriendly url for event

.........details

additional information related to event

..........detail

idUnique identifier for the detailnameName of the detail. Possible values are different depending on the sport. For more information please find node details in the sports.show: sports.showvalueValue related to the detail

.........participants

..........participant

counterNumber of participant in the event. Participant with counter="1" is home team.idUnique identifier of the participanttype

Participant type. Possible values:

team
person

nameParticipant nameshort_nameParticipant short name, max length: 20 charactersacronymMax 3 characters length mini name, f.e: BAR, REAgender

Participant gender. Possible value:

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

area_idUnique identifier of the area represented by the participant. softnetSPORT API provides the following areas: areas.index
area_nameArea name represented by the participantarea_codeMax 3 characters length of the short area name f.e: GER, POL, FRAsport_idUnique identifier of the sport in which participant occures. softnetSPORT API provides the following sports: sports.indexsport_nameName of the sport in which participant occuresnational

Determines if participant is national team. Possible values:

yes
no

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

...........results

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

idUnique identifier for the resultnameName of the result. Possible values are different depending on the sport. For more information please find node details in the sports.show: sports.showvalueValue related to the result

...........stats

............stat

idUnique identifier for the statisticnameName of the statistic. Possible values are different depending on the sport. For more information please find node details in the sports.show: sports.showvalueValue related to the statistic

verified_result	xsd:string	Possible value: yes - result is verified with official source no - result is not verified with official source
product	xsd:string	Possible values: scoutsfeed livescorepro Required with booked.
booked	xsd:string	Possible value: yes - result is booked in selected product no - result is not booked in selected product Required with product.
tz	xsd:string	Determines timezone for the output data. The complete list of possible time zones is included in the API introduction section
timestamp	xsd:unix_timestamp	Selection date, format UNIX_TIMESTAMP. Only changes in events that occurred or were updated after this timestamp will be returned.

Method calling examples

Link	Description
https://api.statscore.com/v2/livescore?token={{YOUR_TOKEN}}	Returns a list of all in progress (live) events in JSON format

Insert excerpt

	events.index
	events.index
nopanel	true

Versions Compared

Old Version 19

New Version Current

Key

Resource information

Method parameters

Query parameters

Method calling examples

Output elements

Method calling examples