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.