Football Terms

This page explains commonly used terms and metrics in the Sportmonks Football API.

Term
Type ID
API Code / Developer Name
Description

Corners

34

corners / CORNERS

Indicates how many corner kicks a team took.

Shots Off Target

41

shots-off-target / SHOTS_OFF_TARGET

Number of shots attempted that did not hit the goal frame.

Shots Total

42

shots-total / SHOTS_TOTAL

Total number of shot attempts (includes on target, off target, blocked).

Attacks

43

attacks / ATTACKS

Number of attacks (offensive moves) made by the team.

Dangerous Attacks

44

dangerous-attacks / DANGEROUS_ATTACKS

Attacks classified as “dangerous” (higher threat) by analysis.

Ball Possession

45

ball-possession / BALL_POSSESSION

Percentage of game time the team held possession.

Ball Safe

46

ball-safe / BALL_SAFE

Times the attacking team played the ball back safely (retained possession) rather than risking an attack.

Penalties

47

penalties / PENALTIES

Number of penalty kicks awarded or taken.

Shots Inside Box

49

shots-insidebox / SHOTS_INSIDEBOX

Number of shots taken from inside the penalty box.

Shots Outside Box

50

shots-outsidebox / SHOTS_OUTSIDEBOX

Shots taken from outside the penalty box.

Offsides

51

offsides / OFFSIDES

Number of offside infractions.

Goals

52

goals / GOALS

Total goals scored by the team.

Goal Kicks

53

goals-kicks / GOAL_KICKS

Number of goal kicks (kick by goalie).

Goal Attempts

54

goal-attempts / GOAL_ATTEMPTS

Shots intended at goal (attempted goals) including misses, etc.

Free Kicks

55

free-kicks / FREE_KICKS

Number of free kicks awarded.

Fouls

56

fouls / FOULS

Number of fouls committed by the team.

Saves

57

saves / SAVES

Number of saves made by the goalkeeper.

Shots Blocked

58

shots-blocked / SHOTS_BLOCKED

Number of shots blocked by defenders.

Substitutions

59

substitutions / SUBSTITUTIONS

Number of substitutions made by the team.

Throw-ins

60

throwins / THROWINS

Number of throw-ins awarded / taken.

Long Passes

62

long-passes / LONG_PASSES

Number of attempted long passes.

Hit Woodwork

64

hit-woodwork / HIT_WOODWORK

Times the shot hit the post or crossbar.

Successful Headers

65

successful-headers / SUCCESSFUL_HEADERS

Headers that were completed to a teammate.

Successful Interceptions

66

successful-interceptions / SUCCESSFUL_INTERCEPTIONS

Number of interceptions successfully made.

Substitutions Overtime

68

substitutions-overtime / SUBSTITUTIONS_OVERTIME

Substitutions made during overtime.

Offsides Overtime

69

offsides-overtime / OFFSIDES_OVERTIME

Offside infractions during overtime.

Headers

70

headers / HEADERS

Number of header attempts (successful or not).

Yellowcards Overtime

74

yellowcards-overtime / YELLOWCARDS_OVERTIME

Yellow cards issued during overtime periods.

Challenges

77

challenges / CHALLENGES

Count of physical or defensive challenges in the match.

Tackles

78

tackles / TACKLES

Number of tackle attempts by the team.

Assists

79

assists / ASSISTS

Number of assists recorded.

Passes

80

passes / PASSES

Total number of pass attempts.

Successful Passes

81

successful-passes / SUCCESSFUL_PASSES

Number of completed passes.

Successful Passes Percentage

82

successful-passes-percentage / SUCCESSFUL_PASSES_PERCENTAGE

Percentage of successful passes over total attempts.

Redcards

83

redcards / REDCARDS

Number of straight red cards.

Yellowcards

84

yellowcards / YELLOWCARDS

Number of yellow cards issued.

Yellow-Red Cards

85

yellowred-cards / YELLOWRED_CARDS

Cases where a second yellow leads to a red.

Shots On Target

86

shots-on-target / SHOTS_ON_TARGET

Number of shot attempts that were on goal.

Injuries

87

injuries / INJURIES

Number of recorded injuries.

Last updated

Was this helpful?