Matches WyID Events

  • Category
  • Date March 25, 2019





GET /v2/matches/{wyId}/events


GET /v2/matches/{wyId}/events

back to index


Table of contents

Overview

Retrieves informations about a given match's events.

Request URL: https://apirest.wyscout.com/v2/matches/{wyId}/events

Parameters

( * parameters are mandatory)

Name Type Default Description
wyId * integer null Unique ID for the required match
details string null Objects to be detailed (separated by commas). See Notes(1) for available objects
fetch string null Objects to be fetched (separated by commas). See Notes(2) for available objects

Output

Property Type Condition Value Description
match object fetch=match Dynamic Match details (see GET matches/{wyId} for more info)
players object fetch=players See Notes(3) Players' list divided by teamId
coaches object fetch=coaches See Notes(4) Coaches' list divided by teamId
referee object fetch=referee See Notes(5) List of referees
teams object fetch=teams Dynamic Teams details (see GET teams/{wyId} for more info)
formations object fetch=formations See Notes(6) Teams' formations
substitutions object fetch=substitutions See Notes(7) Teams' substitutions
events array always Dynamic Events happened in the given match
-id integer always Dynamic Unique ID of this event happening
-playerId integer always Dynamic Unique ID of the player related to the event
-teamId integer always Dynamic Unique ID of the player's team
-matchId integer always Dynamic Unique ID of the match
-matchPeriod string always See Notes(8) Period of the match
-eventSec float always Dynamic seconds elapsed since the start of the match period (1H,2H,E1,E2,P)
-eventId integer always See Notes(9) Event Unique ID
-eventName string always See Notes(9) Label for the event
-subEventId integer always See Notes(9) Sub event Unique ID
-subEventName string always See Notes(9) Label forthe sub event
-positions array always Dynamic Positions in which this event started/ended (only start if not a movement)
–x integer always Dynamic X position in percentage from the left corner of the attacking team
–y integer always Dynamic Y position in percentage from the left corner of the attacking team
-tags array always Dynamic List of additional tags attached to this event
–id integer always See Notes(10) Tag Unique ID
–tag array details=tag Dynamic Container for the tag's labels
—label string always Dynamic Label related to the tag ID

Notes

1. Available objects for additional details

Object Description
tag Add the label to the event tags

2. Available objects for fetching

Object Description
match Match details (see GET matches/{wyId} for more info)
players Players details (see GET players/{wyId} for more info)
coaches Coach details (see GET coaches/{wyId} for more info)
referees Referee details (see GET referees/{wyId} for more info)
teams Teams details (see GET teams/{wyId} for more info)
formations Formations details (see Notes(6) for more info)
substitutions Substitutions details (see Notes(7) for more info)

3. Details of players object

Property Type Value Description
teamId array Dynamic List of players related to the team with ID teamId
-player object Dynamic Player details (see GET players/{wyId} for more info)

4. Details of coaches object

Property Type Value Description
teamId array Dynamic List of coaches related to the team with ID teamId
-coach object Dynamic Coach details (see GET coaches/{wyId} for more info)

5. Details of referees object

Property Type Value Description
refereeId integer Dynamic Referee Unique ID
role string See Notes(5a) Role of the referee in the referee team

5a. Available roles for referees

Role
referee
firstAssistant
secondAssistant
fourthOfficial

6. Details of formations object

Property Type Value Description
teamId object Dynamic Formations related to the team with ID teamId
–matchPeriod object Dynamic Formations related to the period matchPeriod
–startSec object Dynamic The second in which the formation started being used
—scheme object See Notes(6b) Scheme used. (see Notes(6a) for more info)
—-scheme string See Notes(6b) Scheme used. (see Notes(6a) for more info)
—-matchPeriod string See Notes(8) Match period. (see Notes(8) for more info)
—-startSec integer Dynamic The second in which the formation started being used
—-players array Dynamic List of player in the current formation
—–playerId object Dynamic The ID of the player
——playerId integer Dynamic The ID of the player
——position string See Notes(6b) Code of the position. (see Notes(6b) for more info)

6a. Available schemes and relative positions

Scheme p0 p1 p2 p3 p4 p5 p6 p7 p8 p9 p10
4-4-2 gk rb rcb lcb lb rw rcmf lcmf lw ss cf
4-4-1-1 gk rb rcb lcb lb rw rcmf lcmf lw amf cf
4-3-2-1 gk rb rcb lcb lb rcmf3 dmf lcmf3 amf amf cf
4-2-3-1 gk rb rcb lcb lb rdmf ldmf ramf amf lamf cf
4-1-4-1 gk rb rcb lcb lb dmf rw rcmf lcmf lw cf
4-1-3-2 gk rb rcb lcb lb dmf ramf amf lamf ss cf
4-3-1-2 gk rb rcb lcb lb rcmf3 dmf lcmf3 amf ss cf
4-3-3 gk rb rcb lcb lb rcmf3 dmf lcmf3 rwf cf lwf
4-5-1 gk rb rcb lcb lb rw rcmf3 dmf lcmf3 lw cf
4-2-2-2 gk rb rcb lcb lb rdmf ldmf ramf lamf ss cf
4-2-1-3 gk rb rcb lcb lb rdmf ldmf amf rwf cf lwf
3-4-3 gk rcb3 cb lcb3 rwb rcmf lcmf lwb rwf cf lwf
3-4-1-2 gk rcb3 cb lcb3 rwb rcmf lcmf lwb amf ss cf
3-4-2-1 gk rcb3 cb lcb3 rwb rcmf lcmf lwb amf amf cf
3-5-2 gk rcb3 cb lcb3 rwb rcmf3 dmf lcmf3 lwb ss cf
3-5-1-1 gk rcb3 cb lcb3 rw rcmf3 dmf lcmf3 lw amf cf
5-3-2 gk rb5 rcb3 cb lcb3 lb5 rcmf3 dmf lcmf3 ss cf
5-4-1 gk rb5 rcb3 cb lcb3 lb5 rw rcmf lcmf lw cf
4-3-2 gk rb rcb lcb lb rcmf3 dmf lcmf3 ss cf esp
4-4-1 gk rb rcb lcb lb rw rcmf lcmf lw cf esp
4-3-1-1 gk rb rcb lcb lb rcmf3 dmf lcmf3 amf cf esp
4-2-2-1 gk rb rcb lcb lb rdmf ldmf amf amf cf esp
4-1-3-1 gk rb rcb lcb lb dmf ramf amf lamf cf esp
4-2-1-2 gk rb rcb lcb lb rdmf ldmf amf ss cf esp
3-4-2 gk rcb3 cb lcb3 rwb rcmf lcmf lwb ss cf esp
3-4-1-1 gk rcb3 cb lcb3 rwb rcmf lcmf lwb amf cf esp
3-5-1 gk rcb3 cb lcb3 rwb rcmf3 dmf lcmf3 lwb cf esp
5-3-1 gk rb5 rcb3 cb lcb3 lb5 rcmf3 dmf lcmf3 cf esp
4-3-1 gk rb rcb lcb lb rcmf3 dmf lcmf3 cf esp esp
4-4-0 gk rb rcb lcb lb rw rcmf lcmf lw esp esp
4-2-2-0 gk rb rcb lcb lb rdmf ldmf amf amf esp esp
3-4-1 gk rcb3 cb lcb3 rwb rcmf lcmf lwb cf esp esp
5-3-0 gk rb5 rcb3 cb lcb3 lb5 rcmf3 dmf lcmf3 esp esp
3-3-3-1 gk rcb3 cb lcb3 rcmf3 dmf lcmf3 ramf amf lamf cf
3-2-3-2 gk rcb3 cb lcb3 rdmf ldmf ramf amf lamf ss cf

6b. Available positions codes

Name Code
Goalkeeper gk
Right Back rb
Right Centre Back rcb
Left Centre Back lcb
Left Back lb
Right Winger rw
Right Centre Midfielder rcmf
Left Centre Midfielder lcmf
Left Winger lw
Second Striker ss
Striker cf
Attacking Midfielder amf
Right Centre Midfielder rcmf3
Defensive Midfielder dmf
Left Centre Midfielder lcmf3
Right Defensive Midfielder rdmf
Left Defensive Midfielder ldmf
Right Attacking Midfielder ramf
Left Attacking Midfielder lamf
Right Wing Forward rwf
Left Wing Forward lwf
Right Centre Back (3 at the back) rcb3
Centre Back cb
Left Centre Back (3 at the back) lcb3
Right Wingback rwb
Left Wingback lwb
Right Back (5 at the back) rb5
Left Back (5 at the back) lb5

7. Details of substitutions object

Property Type Value Description
teamId object Dynamic The substitutions related to the team with ID teamId
–matchPeriod object See Notes(8) The match period. (see Notes(8) for more info)
—startSec object Dynamic The substitution that happened at startSec seconds elapsed from the start
—in array Dynamic The entrance of a player as a substitute
—-playerId integer Dynamic The ID of the player subbed in
—out array Dynamic The exit of a player from the field (red cards included)
—-playerId integer Dynamic The ID of the player sent out

8. Available match periods

Period Description
1H First Half Time
2H Second Half Time
E1 First Extra Time
E2 Second Extra Time
P Pentalties Time

9. Available event and sub event IDs combinations

Event SubEvent Label (event – subevent)
1 10 Duel – Air duel
1 11 Duel – Ground attacking duel
1 12 Duel – Ground defending duel
1 13 Duel – Ground loose ball duel
2 20 Foul – Foul
2 21 Foul – Hand foul
2 22 Foul – Late card foul
2 23 Foul – Out of game foul
2 24 Foul – Protest
2 25 Foul – Simulation
2 26 Foul – Time lost foul
2 27 Foul – Violent Foul
3 30 Free Kick – Corner
3 31 Free Kick – Free Kick
3 32 Free Kick – Free kick cross
3 33 Free Kick – Free kick shot
3 34 Free Kick – Goal kick
3 35 Free Kick – Penalty
3 36 Free Kick – Throw in
4 40 Goalkeeper leaving line – Goalkeeper leaving line
5 50 Interruption – Ball out of the field
5 51 Interruption – Whistle
6 60 Offside – Offside
7 70 Others on the ball – Acceleration
7 71 Others on the ball – Clearance
7 72 Others on the ball – Touch
8 80 Pass – Cross
8 81 Pass – Hand pass
8 82 Pass – Head pass
8 83 Pass – High pass
8 84 Pass – Launch
8 85 Pass – Simple pass
8 86 Pass – Smart pass
9 90 Save attempt – Reflexes
9 91 Save attempt – Save attempt
10 100 Shot – Shot

10. Available tag IDs

Tag Label Description
101 Goal Goal
102 own_goal Own goal
301 assist Assist
302 keyPass Key pass
1901 counter_attack Counter attack
401 Left Left foot
402 Right Right foot
403 head/body Head/body
1101 direct Direct
1102 indirect Indirect
2001 dangerous_ball_lost Dangerous ball lost
2101 blocked Blocked
801 high High
802 low Low
1401 interception Interception
1501 clearance Clearance
201 opportunity Opportunity
1301 Feint Feint
1302 missed ball Missed ball
501 free_space_r Free space right
502 free_space_l Free space left
503 take_on_l Take on left
504 take_on_r Take on right
1601 sliding_tackle Sliding tackle
601 anticipated Anticipated
602 anticipation Anticipation
1701 red_card Red card
1702 yellow_card Yellow card
1703 second_yellow_card Second yellow card
1201 gb Position: Goal low center
1202 gbr Position: Goal low right
1203 gc Position: Goal center
1204 gl Position: Goal center left
1205 glb Position: Goal low left
1206 gr Position: Goal center right
1207 gt Position: Goal high center
1208 gtl Position: Goal high left
1209 gtr Position: Goal high right
1210 obr Position: Out low right
1211 ol Position: Out center left
1212 olb Position: Out low left
1213 or Position: Out center right
1214 ot Position: Out high center
1215 otl Position: Out high left
1216 otr Position: Out high right
1217 pbr Position: Post low right
1218 pl Position: Post center left
1219 plb Position: Post low left
1220 pr Position: Post center right
1221 pt Position: Post high center
1222 ptl Position: Post high left
1223 ptr Position: Post high right
901 through Through
1001 fairplay Fairplay
701 lost Lost
702 neutral Neutral
703 won Won
1801 accurate Accurate
1802 not accurate Not accurate

back to index



Tags