| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Introduction and Table of Contents
The "incident" message is the primary message that our Scout sends during match coverage as part of the ScoutsFeed product. This part of document contains a description of the most important fields and information included in it. Understanding these elements will enable better integration of the product and further exploration of its capabilities.
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
The “Action” field
The key to understanding the differences between single incidents (match events) is the “action” field, which provides clear information about the type of action taken in relation to a specific match incident.
...
Sport | Insert | Update | Delete |
|---|---|---|---|
Soccer | “Shot on target” for FC Barcelona “Goal” for Spain |
| “Shot on target” for FC Barcelona is deleted (for example it was blocked shot) Key incidents are not deleting. We are using the “confirmation/cancelltion” rules (description HERE). Goal might be cancelled in the case of using the VAR system |
Basketball | “2pts shot made” for Boston Celtics |
| “2pts shot made” for Boston Celtics is deleted (for example, when there was a foul before - shot is not counted) |
Ice Hockey | “Suspension” for Colorado Avalanche |
| “Suspension” for Colorado Avalanche is deleted (for example after video review the referee' call is overturned) |
American Football | “Touchdown” for Kansas City Chiefs |
| “Touchdown” for Kansas City Chiefs is deleted (for example there was a yellow flag) |
Handball | “Throw saved” for France |
| “Throw saved” for France is deleted (for example, where there was a foul before - shot is not counted) |
Baseball | “Out” for Los Angeles Dodgers |
| “Out”for Los Angeles Dodgers is deleted |
Fields related to the incident and its level of detail
...
Each incident generated by Scout may have additional information, which is usually sent in an “update” of the specific incident (see the table above). The most important fields describing a specific incident include:
...
incident_id - ID of the sended incident (the list of specific incidents for all ScoutsFeed sports is available HERE)
incident_name - name of the incident
category - possible values:
standard - for all incidents related to a specific sport
emergency -for special set of incidents sent to clients, which inform about an extraordinary situation before/during/after the match (description HERE)
attribute_ids - contains information about the attributes that have been added to a specific incident. Attributes refer to additional, more detailed information regarding the sent incident (for example goal with left foot, outside of the penalty area, after fast attack)
...
Since this field is crucial for clients who wish to use our data to settle match markets, a separate section of the documentation has been dedicated to it, which can be found HERE.