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.
|
| 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:
|
| source | Internal attribute, please dont use this attribute for your 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 |
| action | Describes type of scout operation on the incident. Possible values:
|
| ....event | |
| id | Identifier 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:
|
| coverage_type | Type of event coverage. Possible values:
|
| status_id | Unique identifier of the event status. softnetSPORT API provides the following statuses: statuses.index |
| sport_id | Identifier of the sport which the event is played. softnetSPORT API provides the following sports: sports.index |
| day | Day in the season |
| neutral_venue | Determines if event is played on neutral venue. Possible values:
|
| item_status | Describes status of the item (record). Possible values:
|
| clock_time | Number of seconds passed in the current period |
| clock_status | Clock status. Possible value:
|
| area_id | Identifier of the area in which competitions are played |
| competition_id | Unique identifier for the competition. softnetSPORT API provides the following competitions: competitions.index |
| season_id | Unique identifier for the season. |
| stage_id | Unique identifier for the stage |
| 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:
|
| bet_status | Bet status. Possible values:
|
| .....details | |
| 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 |
| ......results | |
| 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 |