Getting Match Events

This live-score api endpoint allows you to get goal times, goal scorers as well as yellow and red cards information for live football matches as well as finished ones.

Endpoint

In order to get the events of currently football matches being played (if we provide such for this game), the only thing you need to do is the call the url bellow. In the beginning the data array will be empty as there are no events that have happened. Once there are events they will start appearing in the result from the api endpoint. To make this API call you will need the id of the football match. Our live-scores api endpoint provides information about the matches for which you can get data, by providing you with the link to the events api call. In this example, we have used the demo api key and secret pair. If you login in, you will see all examples with your own api key and api secret

GET:

Response


The response contains the following information, for every event element in the list. The same rules apply for the JSON objects and the XML tag elements. In addition to the list with the events, this soccer api endpoint also provides the general match information.

NameTypeExampleDescription
idinteger567the id of the event.
match_idinteger18098 the id of the match in which the event occurred.
playerstringPaul Pogbathe name of the player who is connected to the event.
timeinteger38 the minute since the kick-off when the event occurred.
eventstringYELLOW_CARDthe type of the event.
sortinteger8 the order in which the events occurred starting from 0 and growing in positive numbers direction. Meaning the event number 2 happened before number 3. This will be helpful when 2 events in our real time match events data feed happen in the same minute.
home_awaycharacterh/aindicator whether the player or event is related to the home team (value is h) or the away team (values is a).
{
    "success": true,
    "data": {
        "event": [
            {
                "id": "10509914",
                "match_id": "129180",
                "player": "DEENEY TROY",
                "time": "5",
                "event": "GOAL",
                "sort": "0",
                "home_away": "h"
            },
            {
                "id": "10509915",
                "match_id": "129180",
                "player": "MARIAPPA ADRIAN",
                "time": "13",
                "event": "YELLOW_CARD",
                "sort": "1",
                "home_away": "h"
            },
            {
                "id": "10509916",
                "match_id": "129180",
                "player": "CAPOUE ETIENNE",
                "time": "60",
                "event": "YELLOW_CARD",
                "sort": "2",
                "home_away": "h"
            },
            {
                "id": "10509917",
                "match_id": "129180",
                "player": "DOUCOURE ABDOULAYE",
                "time": "61",
                "event": "YELLOW_CARD",
                "sort": "3",
                "home_away": "h"
            },
            {
                "id": "10509918",
                "match_id": "129180",
                "player": "DEENEY TROY",
                "time": "62",
                "event": "YELLOW_CARD",
                "sort": "4",
                "home_away": "h"
            },
            {
                "id": "10510529",
                "match_id": "129180",
                "player": "VARDY JAMIE",
                "time": "75",
                "event": "GOAL",
                "sort": "5",
                "home_away": "a"
            },
            {
                "id": "10510974",
                "match_id": "129180",
                "player": "PEREIRA RICARDO",
                "time": "84",
                "event": "YELLOW_CARD",
                "sort": "6",
                "home_away": "a"
            },
            {
                "id": "10511398",
                "match_id": "129180",
                "player": "GRAY ANDRE",
                "time": "90",
                "event": "GOAL",
                "sort": "7",
                "home_away": "h"
            },
            {
                "id": "10511625",
                "match_id": "129180",
                "player": "GRAY ANDRE",
                "time": "90",
                "event": "YELLOW_CARD",
                "sort": "8",
                "home_away": "h"
            }
        ],
        "match": {
            "id": "129180",
            "date": "2019-03-03",
            "home_name": "Watford",
            "away_name": "Leicester City",
            "score": "2 - 1",
            "ht_score": "1 - 0",
            "ft_score": "2 - 1",
            "et_score": "",
            "time": "FT",
            "league_id": "25",
            "status": "FINISHED",
            "added": "2019-03-03 11:55:12",
            "last_changed": "2019-03-03 13:58:04",
            "home_id": "11",
            "away_id": "6",
            "competition_id": "2",
            "location": null,
            "fixture_id": null,
            "scheduled": null,
            "home": {
                "id": "11",
                "name": "Watford",
                "stadium": "Vicarage Road Stadium",
                "location": "Vicarage Road Stadium"
            },
            "away": {
                "id": "6",
                "name": "Leicester City",
                "stadium": "King Power Stadium",
                "location": "King Power Stadium"
            },
            "competition": {
                "id": "2",
                "name": "Premier League"
            }
        }
    }
}

Type of events


TypeMeaing
GOALA goal was scored
GOAL_PENALTYA goal was scored from a penalty
OWN_GOALAn own goal was scored
YELLOW_CARDA player has been cautioned by the referee
RED_CARDA player was sent off by the referee
YELLOW_RED_CARDA player has received their second yellow card and they have been sent off.

Code examples


cUrl

curl -XGET http://livescore-api.com/api-client/scores/events.json?key=demo_key\&secret=demo_secret\&id=129180
PHP
file_get_contents('http://livescore-api.com/api-client/scores/events.json?key=demo_key&secret=demo_secret&id=129180');
Python
import urllib2
req = urllib2.Request('http://livescore-api.com/api-client/scores/events.json?key=demo_key&secret=demo_secret&id=129180')
response = urllib2.urlopen(req)
print response.read()