Soccer Extended Live Timelines provides a play-by-play event timeline for currently live matches. Matches appear a few minutes before kick-off and disappear a few minutes after the match reaches “ended” status.
Update Frequency1s Time To Live / Cache
Data Points
Player:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | statistics - competitor - player | String | Unique ID of a player ex. sr:player:159665 |
name | statistics - competitor - player | String | Name of a player ex. Salah, Mohamed |
Sport Event Situation:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
played | sport_event_status - clock | String | Match clock time in minutes90:00 |
stoppage_time_played | sport_event_status - clock | String | Stoppage time played in minutes5:49 |
stoppage_time_announced | sport_event_status - clock | String | Stoppage time announced in minutes5:00 |
status | sport_event_status - match_situation | String | Current situtation status of a matchsafe, dangerous, attack |
qualifier | sport_event_status - match_situation | String | Defines the team in the current situation statushome, away |
updated_at | sport_event_status - match_situation | Date-Time | Timestamp of the most recent match situation update ex. 2024-04-14T14:57:28+00:00 |
away_score | sport_event_status - period_scores - period_score | Integer | Away team period score |
home_score | sport_event_status - period_scores - period_score | Integer | Home team period score |
number | sport_event_status - period_scores - period_score | Integer | Period number |
type | sport_event_status - period_scores - period_score | String | Period typeregular_period, overtime, penalties, pause, awaiting_extra, extra_time_halftime, interrupted |
Sport Event Status:
Attribute | Parent Element | Type | Description |
|---|---|---|---|
|
| Integer | Aggregate score (of multiple sport events) for the away team |
|
| Integer | Aggregate score (of multiple sport events) for the home team |
|
| String | Unique ID of the aggregate score winner |
|
| Integer | Score for the away team in normal time |
|
| Integer | Score for the away team in overtime |
|
| Integer | Total score for the away team in the match |
|
| Integer | Score for the home team in normal time |
|
| Integer | Score for the home team in overtime |
|
| Integer | Total score for the home team in the match |
|
| Boolean | Signifies a match result was decided by the federation when |
|
| String | Status within a match. Provides more detail on the state of a match when live than |
|
| Boolean | Signifies a match ended in a tie when |
|
| Boolean | Signifies a match was abandoned by a scout when |
|
| String | Status of a match |
|
| String | Unique ID of the match winner |
Ball Location:
Visit our FAQ for additional information on ball location data.
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
order | sport_event_status - ball_locations - ball_location | Integer | Sequential order of a ball location event. The most recent location is 4 and the oldest location is 1. |
qualifier | sport_event_status - ball_locations - ball_location | String | Designation of a competitor for a ball location entryhome, away |
x | sport_event_status - ball_locations - ball_location | String | Horizontal X coordinate of the pitch. x is a number between 0 and 100. The reference point 0 is at the home team’s goal. |
y | sport_event_status - ball_locations - ball_location | String | Vertical Y coordinate of the pitch. y is a number between 0 and 100. The reference point 0 is on the top of the pitch where the home team’s goal is on the left hand side. |
Match Timeline:
Attribute | Parent Element | Type | Description |
|---|---|---|---|
|
| String | Unique Id of a sport event |
|
| Date-time | Start time of a sport event |
|
| Integer | Score for the away team after a timeline event |
|
| String | Brief description of a break event |
|
| String | Description of the scenario during a card event |
|
| String | Description of the scenario during a card event |
|
| String | Designation of a competitor for a timeline event |
|
| String | Description of an event. |
|
| Integer | Score for the home team after a timeline event |
|
| Integer | Unique ID for a timeline event |
|
| Integer | Amount of injury time announced in minutes |
|
| String | Match clock value for a timeline event, in minutes and seconds |
|
| Integer | Match clock value of a timeline event, in minutes |
|
| String | Method of a scored goal |
|
| String | Outcome of a missed goal |
|
| Integer | Period number of a timeline event |
|
| String | Period name of a timeline event, appearing at the beginning of a period |
|
| String | Period type of a timeline event |
|
| Integer | Away team shootout score after a timeline event |
|
| Integer | Home team shootout score after a timeline event |
|
| Integer | Home team shootout score after a timeline event |
|
| String | Status available during penalty shootouts ( |
|
| Integer | Stoppage time value for a timeline event |
|
| String | Stoppage time clock value for a timeline event |
|
| String | Type of timeline event. See our FAQ for a complete list of event types |
|
| Date-time | Timestamp of a timeline event |
|
| Integer | Horizontal X coordinate of a timeline event. |
|
| Integer | Vertical Y coordinate of a timeline event. |
Player Event Details:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | event - player | String | Unique player Id associated with a timeline event ex. sr:player:2367105 |
name | event - player | String | Player name associated with a timeline event ex. Luna, Diego |
type | event - player | String | Player activity type associated with a timeline event. Signifies if a player scored a goal, recorded an assist, or participated in a substitution. ex. scorer, assist, substituted_in, substituted_out |