What Livescore feeds are
Livescore feeds — data about football (soccer) competitions in format applicable for data exchange between computer programs.
First program is our server, the second is your application designed to collect data from us.
We provide feeds in our own format based on several most common data exchange formats: XML,
JSON and format of
serialized PHP arrays (see docs for PHP serialize,
How to use Livescore feeds
Our feeds can be received using PULL method i.e as a response to client's requests to our service.
In order to use our feeds you will need client application – a program which will run on your server
and grab feeds from our server. After receiving our feed it will need to process it i.e extract data from feed and put to your storage.
Depending on format of feed, it may be XML-parser or simple function which extracts data from JSON string.
For users who have apps written on PHP it's recommended to get feeds in PHP-format, which can be easily extracted to PHP arrays using
What data contained in Livescore feeds
Our feeds contain data about matches and standings tables for each competition.
It is possible to get info about already finished matches, macthes scheduled to be played in future and also track live matches in real time mode with small delay (about 1-2 minutes).
Info about each match contains following fields:
Live matches will contain some additional info about current status of game such as current minute and period (first-, second half or half-time break).
- unique match ID
- competition ID
- kick off date and time
- teams taking part in this match (full names and ID's)
- current score
- current match status (live, finished, not started)
- brief info about match (matchday number, playoff stage, etc...)
Besides of it live and finished matches contain info about match events such as goals, yellow and red cards.
Data update rates
Info about online matches updated once per minute. Delay between event in real game and appearance in our feeds usually not more than 2 minutes, sometimes it may take longer.
Standings tables are updated once per day and correct number of points, goals and teams positions will not appear right after teams play their matches.
Competition schedules updates once per day.
Limits and restrictions
In order to use our data the clients must receive personal API key.
One key allows to get feeds from one network address (client address).
Usually this is an IP address or hostname of machine where client runs software which collects feeds from us. This address is specified in special form after user completes payment.
There is a restriction limiting number of requests from each client – not more than 1500 requests per day,
it's more than one request per minute and it's more than enough for all tasks.
Violation of these conditions may involve service stoppage with or without notifications.