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 |
| 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 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 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. 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 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
| .messages | |
|---|---|
| ..message | |
| 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 |
| incident_id | Identifier for the incident. softnetSPORT API provides the following incidents: incidents.index |
| 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. softnetSPORT API provides the following participants: participants.index |
| participant_name | 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.index |
| subparticipant_name | Team name that the 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 for the incident. Possible values:
|
| ....event | |
| id | Identifier of the event |
| 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. softnetSPORT API provides the following statuses: statuses.index |
| sport_id | Identifier for the sport in which the event is played. softnetSPORT API provides the following sports: sports.index |
| round_id | Unique identifier for the round in which event is played. Possible null value. softnetSPORT API provides the following rounds: rounds.index |
| 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:
|
| 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.index |
| 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:
|
| .....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 participants in the event. Participant with counter="1" is the home team, "2" is the 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 |