Resource information
softnetsport/feedXSD | https://api.softnetsport.com/assets/API/docsxsd/.index.xsd |
Method | GET |
---|
Description | Returns incidents generated by the scouts for all events in the 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 no method parameters in this |
resource ...
Query parameters
Name | Type | Description |
---|
token | xsd:string | REQUIRED. |
More More information concerning |
oAuth token: oAuth 2.0 authorization authorization in API introduction section |
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 that occurred or were 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 that occurred before this timestamp will be returned. |
important_for_trader | xsd:string | Determines type of incidents (if |
is it's 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 incidents for the selected sport to be filtered |
. softnetSPORT API provides the following sports: sports.index
Method calling examples
| |
---|
https://api.softnetsport.com/v2/feed.xml?token={{YOUR_TOKEN}} | Returns all event incidents from the last 24 hours in XML format |
type | xsd:string | Determines type of message |
incident_ids | xsd:string | List of incidents type identifiers separated by a comma (e.g. 123,234,321) for which you want to get the incident details. |
status_id | xsd:int | Determines the event status identifier. |
Method calling examples
softnetsportsoftnetsport.xml in Output elements
messages | ..
|
---|
id | Unique identifier for the message |
id | identifier for an incident that occurred in the eventIdentifier for the massage. Note: for certain messages, such as updates to a previous, related message, the UUID may be the same. This intentional duplication allows clients to establish correlations between messages, aiding in tracking updates or related data across a system. |
type | Possible value: |
_changes |
source | Internal attribute, please dont use this attribute |
ut | Information about the date and time of when the message was created. Format UNIX_TIMESTAMP. |
.. |
---|
. | .
|
---|
...incident | node available only if message type is incident |
---|
id | Unique identifier for the incident occurred in the event |
action | Describes type of scout operation for the incident. Possible values: - insert - new incident generated by the scout
- update - incident was updated by the scout (e.g. incident "yellow card" is updated when scout fills in the name of the player (participant)
- delete - incident was deleted (e.g. when the scout adds an incident by mistake, he can delete it)
|
incident_id | Identifier for the |
incident. softnetSPORT API provides the following incidents: incidents.indexincident |
incident_name | Name of the incident. e.g. goal, yellow card, red card etc. |
attribute_ids | Attributes identifiers related to incident, separated by a comma (e.g. [397, 398]) |
confirmation | Describes confirmation status for the incident. Possible values: - tbd – appears as default for Goal, Penalty, Red card, Yellow card and Corner incidents.
- confirmed – appears when the following incident will be confirmed by referee.
- cancelled – appears when the following incident will be cancelled by referee. Incidents with this value have no effect on statistics.
|
participant_id | Unique identifier of participant (player, team or coach) name related to |
incident. softnetSPORT API provides the following participants: participants.indexincident |
participant_name |
Participant Participants (player, team or coach) name related to incident. |
|
subparticipant_id | Team id that the player or coach is part |
of. softnetSPORT API provides the following subparticipants: participants.indexof |
subparticipant_name | Team name that the player or coach is part of |
info | Internal attribute, please dont use this attribute |
important_for_trader | Possible values: |
important | 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_action | Internal attribute, please dont use this attribute |
show_time | Internal attribute, please dont use this attribute |
show_on_timeline | Internal attribute, please dont use this attribute |
event_time | Information when the incident occurs in format MM:SS |
event_status_id | Unique identifier of the event status |
event_status_name | Name of the event status |
period_timer | Informations regarding game clock |
direction | Contains information about timer direction. Possible values: |
time | Time in sync with the game clock |
x_pos | Ball position on X axis (percents) |
y_pos | Ball position on Y axis (percents) |
...event | node available only if message type is event |
---|
id | Identifier of the event |
action | Describes type of |
scout incident incident by the scout incident was updated by the scout (e.g. incident "yellow card" is updated when scout fills in the name of the player (participant)- event was updated
- delete -
|
incident (e.g. when the scout adds an incident by mistake, he can delete it)....event | |
---|
id | Identifier |
name | The name of the event |
start_date | Start date for the event in format: YYYY-MM-DD hh:mm |
ft_only | Determines if only the full time result/score of the event is given . 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. Possible values: - from_venue - means the scout is relaying the event directly from the stadium (max. latency 1 second)
- from_low_latency_tv - means the scout is relaying the event from tv transmission (max. latency 3 seconds)
- 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)
|
status_id | Unique identifier of the event |
status. softnetSPORT API provides the following statuses: statuses.indexstatus |
sport_id | Identifier for the sport in which the event is |
played. softnetSPORT API provides the following sports: sports.indexplayed |
round_id | Unique identifier for the round in which event is played. Possible null value |
round_name | Name of the round. Possible null value. |
day | Day of the season |
neutral_venue | Determines if event is played at a neutral venue. Possible values: |
item_status | Describes status for 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
|
clock_time | Number of seconds that have passed in the current period |
clock_status | Clock status. Possible value: |
area_id | Identifier for the area in which the competitions are played |
competition_id | Unique identifier for the |
competition. softnetSPORT API provides the following competitions: competitions.indexcompetition |
season_id | Unique identifier for the season. |
stage_id | Unique identifier for the stage |
tour_id | Unique identifier for the tour in which a competition is played |
. softnetSPORT API provides the following tours: tours.index |
gender | Competition gender. Possible values: |
bet_status | Bet status. Possible values: |
bet_cards | Changed when there is a possibility of a card. Possible value: |
bet_corners | Changed when there is a possibility of a corner. Possible value: |
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
|
status_type | Type of the status. Possible values: - live
- scheduled
- finished
- cancelled
- interrupted
- deleted
- other
|
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
|
latency | Information about the expected latency. Possible values: - null (for the event with scoutsfeed=no parameter)
- 1-2s
- 3-6s
- 7-15s
|
event_stats_level | Internal information, please do not use this field |
verified_result | Possible value: - yes - result is verified with an official source
- no - result is not verified with an official source
|
is_coverage_limited | Determines if event has limited information about players statistics |
played_time | Only for soccer. Number of seconds passed in the current period, including additional time |
....details |
---|
|
---|
.....detail |
|
---|
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 |
.
|
---|
.....participant |
|
---|
counter | Number of |
participants participant in the event. Participant with counter="1" is the home team, "2" is the away team |
id | Unique identifier of the participant |
name | Participants name |
short_name | Participants abbreviated name, max length: 20 characters |
acronym | Max 3 characters in length mini name, e.g. BAR, REA |
area_id | Unique identifier for the area represented by the participant |
area_name | Area name represented by the participant |
. softnetSPORT API provides the following subparticipants: participants.index |
area_code | Max 3 characters in length for the abbreviated area name e.g. GER, POL, FRA |
ut | Information about the date and time of when the record was last updated. Format UNIX_TIMESTAMP |
......results |
---|
|
---|
.......result |
|
---|
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.
|
---|
.......stat |
|
---|
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 |
event_status_stats | Sending only with incidents ending the previous part of the game. Contains statistics from previous part of the game |
|
|
---|
|
|
---|
id | Unique identifier of the participant |
counter | Number of subparticipant in the event |
name | Participants name |
short_name | Participants abbreviated name, max length: 20 characters |
acronym | Max 3 characters in length mini name, e.g. BAR, REA |
area_id | Unique identifier for the area represented by the participant |
area_name | Area name represented by the participant |
area_code | Max 3 characters in length for the abbreviated area name e.g. GER, POL, FRA |
ut | Information about the date and time of when the record was last updated. Format UNIX_TIMESTAMP |
........results |
|
---|
.........result |
|
---|
id | Unique identifier for the result |
value | Value related to the result |
........stats |
|
---|
.........stat |
|
---|
id | Unique identifier for the statistic |
value | Value related to the statistic |
.........betting |
|
---|
.........bet_statuses |
|
---|
name | Internal information, please do not use this node |
value | Internal information, please do not use this node |