feed.index

Resource information

URL	https://api.softnetsport.com/v2/feed
XSD	https://api.softnetsport.com/assets/API/docs/xsd/feed.index.xsd
Method	GET
Description	Returns incidents generated by the scouts for all the events from last 24 hours
Package	This resource is included in the SCOUTSFEED package
Cache	0 seconds
Authorization required	Yes

Method parameters

Name	Type	Description
There are not method parameters in this resource

Query parameters

Name	Type	Description
token	xsd:string	REQUIRED. More information concerning oAuth token: oAuth 2.0 authorization
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 50. Possible values: 5, 10, 25, 50, 100, 250, 500
timestamp	xsd:unix_timestamp	Selection date, format UNIX_TIMESTAMP. Only incidents which occured or was updated after this timestamp will be returned. By default (if no parameter given) incidents from last 24 hours.
timestamp_to	xsd:unix_timestamp	Selection date, format UNIX_TIMESTAMP. Only incidents occured before this timestamp will be returned.
important_for_trader	xsd:string	Determines type of incidents (if is important for trader). By default all types are included. Allowed values: yes - returns only incidents important for trader no - returns only incidents not important for trader
sport_id	xsd:int	Identifier of the sport. Allows to filter incidents for the selected sport. softnetSPORT API provides the following sports: sports.index

Method calling examples

Link	Description
https://api.softnetsport.com/v2/feed.xml?token={{YOUR_TOKEN}}	Returns all event's incidents from last 24 hours in XML format
https://api.softnetsport.com/v2/feed?token={{YOUR_TOKEN}}	Returns all event's incidents from last 24 hours in JSON format
https://api.softnetsport.com/v2/feed.xml?token={{YOUR_TOKEN}}&sport_id=1	Returns all events's incidents from last 24 hours in basketball events

Output elements

.messages
..message
id	Unique identifier of the incident occured in the event
type	Possible value: incident event_changes
source	Internal attribute, please dont use this attribute for you service
ut	Information about date and time when message was created. Format UNIX_TIMESTAMP.
...data
....incident	node available only if message type
id	Unique identifier of the incident occured in the event
incident_id	Identifier of the incident. softnetSPORT API provides the following incidents: incidents.index
incident_name	Name of the incident. I.e goal, yellow card, red card etc.
participant_id	Unique identifier of participant (player, team or coach) name related to incident. softnetSPORT API provides the following participants: participants.index
participant_name	Participant (player, team or coach) name related to incident.
subparticipant_id	Team id which player or coach is part of. softnetSPORT API provides the following subparticipants: participants.index
subparticipant_name	Team name which player or coach is part of
info	Internal attribute, please dont use this attribute
add_data	Internal attribute, please dont use this attribute
show_popup	Internal attribute, please dont use this attribute
show_scores	Internal attribute, please dont use this attribute
show_time	Internal attribute, please dont use this attribute
show_action	Internal attribute, please dont use this attribute
show_on_timeline	Internal attribute, please dont use this attribute
action	Describes type of scout operation on the incident. Possible values: insert - new incident generated by the scout update - incident was updated by the scout (f.e. incident "yellow card" is updated when scout fill the name of the player (participant) delete - incident was deleted (f.e. when scout add some incident by mistake, he can delete it)
ut	Information about date and time when record was last updated. Format UNIX_TIMESTAMP.
....event
id	Identifier of the event
name	Name of the event
start_date	Start date for the event in format: YYYY-MM-DD hh:mm
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: from_venue - means the scout is relating the event directly from the stadium (max. latency 1 second) from_low_latency_tv - means the scout is relating the event from tv transmission (max. latency 3 seconds) from_tv - means the scout is relating the event from tv transmission (max. latency 8 seconds) basic - for this type of coverage we don't provide detailed events incidents (max. latency around 60 seconds)
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 won't be available for the event
status_id	Unique identifier of the event status. softnetSPORT API provides the following statuses: statuses.index
status_name	Name of the current event status
status_type	Type of the status. Possible values: live scheduled finished cancelled interrupted deleted other
sport_id	Identifier of the sport which the event is played. softnetSPORT API provides the following sports: sports.index
sport_name	Name of the sport in which event is played
day	Day in the season
neutral_venue	Determines if event is played on 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 case when event was added by mistake
clock_time	Number of seconds passed in current period
clock_status	Clock status. Possible value: running stopped
result	Result for the event in format: "1:2". Available only for the events contains 2 participants.
area_name	Name of area in which competitions are played
competition_id	Unique identifier for the competition. softnetSPORT API provides the following competitions: competitions.index
competition_short_name	Competition short name, max length: 20 characters
season_id	Unique identifier for the season.
season_name	Name of the season f.e: Premiership 2014/15
stage_id	Unique identifier for the stage
stage_name	Name of the stage
tour_name	Name of the tour in which competition is played
tour_id	Unique identifier of the tour in which competition is played. softnetSPORT API provides the following tours: tours.index
gender	Competition gender. Possible values: male female mixed
bet_status	Bet status. Possible values: active suspended
ut	Information about date and time when record was last updated. Format UNIX_TIMESTAMP.
.....details	The details node is filled only at the moment when some changes were made in this node. This nodes are always returned, but sometimes can include an empty array.
id	Unique identifier for the detail. Possible values are different depending on the sport. For more information please find node details in the sports.show: sports.show
value	Value related to the detail
.....participants
counter	Number of participant in the event. Participant with counter="1" is home team, "2" is away team
id	Unique identifier of the participant. softnetSPORT API provides the following subparticipants: participants.index
name	Participant name
short_name	Participant short name, max length: 20 characters
acronym	Max 3 characters length mini name, f.e: BAR, REA
area_id	Unique identifier of the area represented by the participant. softnetSPORT API provides the following areas: areas.index
area_name	Area name represented by the participant
area_code	Max 3 characters length of the short area name f.e: GER, POL, FRA
ut	Information about date and time when the record was last updated. Format UNIX_TIMESTAMP
......results	The results node is filled only at the moment when some changes were made in this node. This nodes are always returned, but sometimes can include an empty array.
id	Unique identifier for the result. Possible values are different depending on the sport. For more information please find node details in the sports.show: sports.show
value	Value related to the results
......stats	The stats node is filled only at the moment when some changes were made in this node. This nodes are always returned, but sometimes can include an empty array.
id	Unique identifier for the statistic. Possible values are different depending on the sport. For more information please find node details in the sports.show: sports.show
value	Value related to the statistic