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 events in the last 24 hours |
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 information concerning 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 it's important for trader). By default all types are included.
|
sport_id | xsd:int | Identifier of the sport. Allows incidents for the selected sport to be filtered |
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
Link | Description |
---|---|
https://api.softnetsport.com/v2/feed.xml?token={{YOUR_TOKEN}} | Returns all event incidents from the last 24 hours in XML format |
https://api.softnetsport.com/v2/feed?token={{YOUR_TOKEN}} | Returns all event incidents from the last 24 hours in JSON format |
https://api.softnetsport.com/v2/feed.xml?token={{YOUR_TOKEN}}&sport_id=1 | Returns all event incidents from the last 24 hours for basketball events |
Output elements
.feed |
---|
id | Unique identifier for the message |
type | Possible value:
|
source | Internal attribute, please dont use this attribute |
ut | Information about the date and time of when the message was created. Format UNIX_TIMESTAMP. |
..data |
...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:
|
incident_id | Identifier for the |
incident | |
incident_name | Name of the incident. e.g. goal, yellow card, red card etc. |
participant_id | Unique identifier of participant (player, team or coach) name related to |
incident | |
participant_name | Participants (player, team or coach) name related to incident. |
subparticipant_id | Team id that the player or coach is part |
of | |
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 |
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 operation for the event. Possible values:
|
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:
|
coverage_type | Type of event coverage. Possible values:
|
status_id | Unique identifier of the event |
status | |
sport_id | Identifier for the sport in which the event is |
competition | |
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 |
gender | Competition gender. Possible values:
|
bet_status | Bet status. Possible values:
|
relation_status | Relation status. Attribute for internal purposes. Possible value:
|
status_type | Type of the status. Possible values:
|
.....details |
---|
id | Unique identifier for the detail. Possible values are different depending on the sport |
value | Value related to the detail |
.....participants |
counter | Number of participants 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 |
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 |
---|
id | Unique identifier for the result. Possible values are different depending on the sport |
value | Value related to the results |
......stats |
id | Unique identifier for the statistic. Possible values are different depending on the sport |
value | Value related to the statistic |