Live-score API Documentation

https://live-score-api.com/documentation/
Admin
This documentation provides everything needed to start using the football API, offering an overview,...
Tokens:73,772
Snippets:498
Trust Score:9.2
Update:4 months ago
Show doc for...
Tokens:
Raw
### Example API Endpoint Structure

Source: https://live-score-api.com/documentation/reference/9/making_requests

Demonstrates the basic structure of a GET request to the API, including the root path, module, controller, response format, and query parameters.

```http
GET: http://livescore-api.com/api-client/matches/live.json?key=demo_key&secret=demo_secret
```

--------------------------------

### Get Competitions List using Python

Source: https://live-score-api.com/documentation/reference/11/getting-leagues-list

This Python example shows how to fetch competition data using the urllib2 library. Remember to substitute the placeholder key and secret with your own.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/competitions/list.json?key=demo_key&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Get All Fixtures (Python)

Source: https://live-score-api.com/documentation/reference/13/getting-scheduled-games

This Python example uses urllib2 to retrieve all scheduled fixtures. Remember to substitute 'demo_key' and 'demo_secret' with your valid API credentials.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/fixtures/list.json?key=demo_key\&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Get Competitions by Federation ID (Python)

Source: https://live-score-api.com/documentation/reference/11/getting-leagues-list

This Python example demonstrates how to retrieve competitions for a federation using its ID via the urllib2 library.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/competitions/list.json?key=demo_key&secret=demo_secret&federation_id=2')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Get Today's Fixtures (Python)

Source: https://live-score-api.com/documentation/reference/13/getting-scheduled-games

This Python example uses urllib2 to fetch today's scheduled fixtures. Replace 'demo_key' and 'demo_secret' with your valid API key and secret.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/fixtures/list.json?date=today&key=demo_key\&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Get Match Lineups

Source: https://live-score-api.com/documentation/reference/26/getting-team-lineups

This endpoint allows you to retrieve the starting lineups and substitutes for a specific match. The availability of lineup data depends on the competition's popularity and match importance.

```APIDOC
## GET /api/v1/match/lineups

### Description
Retrieves the team lineups for a specified match.

### Method
GET

### Endpoint
/api/v1/match/lineups

### Parameters
#### Query Parameters
- **match_id** (Number) - Required - The ID of the match for which to retrieve lineups.
- **lang** (String) - Optional - The language code for the response data (e.g., 'en', 'de').

### Response
#### Success Response (200)
- **data.lineup.home** (Object) - Information about the home team and its players.
  - **team.id** (String) - The ID of the home team.
  - **team.name** (String) - The name of the home team.
  - **players** (Array) - An array of player objects for the home team.
    - **player.name** (String) - The name of the player.
    - **player.substitution** (Number) - Indicates if the player is a substitute (1) or in the starting eleven (0).
    - **player.id** (Number) - The unique ID of the player.
    - **player.shirt_number** (Number) - The player's shirt number.
    - **player.team_id** (Number) - The ID of the team the player belongs to.
- **data.lineup.away** (Object) - Information about the away team and its players (structure similar to home team).

### Response Example
```json
{
    "success": true,
    "data": {
        "lineup": {
            "home": {
                "team": {
                    "id": "2210",
                    "name": "Estudiantes Merida",
                    "stadium": "Estadio Olímpico Metropolitano de Mérida",
                    "location": "Estadio Olímpico Metropolitano de Mérida"
                },
                "players": [
                    {
                        "team_id": "2210",
                        "id": "41983",
                        "name": "Alejandro Araque",
                        "substitution": "0",
                        "shirt_number": "1"
                    }
                ]
            },
            "away": {
                "team": {
                    "id": "2211",
                    "name": "Deportivo Tachira",
                    "stadium": "Estadio Polideportivo de Pueblo Nuevo",
                    "location": "San Cristobal"
                },
                "players": [
                    {
                        "team_id": "2211",
                        "id": "42050",
                        "name": "Jose Contreras",
                        "substitution": "0",
                        "shirt_number": "1"
                    }
                ]
            }
        }
    }
}
```
```

--------------------------------

### Get Group Standings (Python)

Source: https://live-score-api.com/documentation/reference/38/group-standings

This Python example shows how to fetch group standings using the urllib2 library. Remember to substitute your API key and secret.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/groups/table.json?group_id=2684&key=demo_key&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Fetch Countries List using Python

Source: https://live-score-api.com/documentation/reference/10/getting-countries-list

This Python example shows how to retrieve the countries list from the API. It utilizes the urllib2 library to send a GET request and print the response. Replace demo credentials with your own.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/countries/list.json?date=today&key=demo_key&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Get Competition Groups using Python

Source: https://live-score-api.com/documentation/reference/29/get-competition-groups

This Python example shows how to retrieve competition groups using the urllib2 library. It makes a GET request to the API endpoint with the specified competition ID and credentials.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/competitions/groups.json?competition_id=387&key=demo_key&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Head to Head API Request with Language

Source: https://live-score-api.com/documentation/reference/21/head-2-head

You can specify a language for the response data using the 'lang' parameter. The example shows how to get data in Arabic.

```bash
GET: https://apiv3.dfsports.com/v3/head-to-head?lang=ar&team1_id=7&team2_id=19
```

--------------------------------

### JSON Match Data Example

Source: https://live-score-api.com/documentation/reference/8/response_formats

This is an example of a JSON response containing detailed information about a live match, including team details, scores, and odds.

```json
{
    "logo": "https://cdn.live-score-api.com/teams/ee2fd3a662dc351faf3b6fa4e1b57074.png",                     "name": "Persik Kediri",                     "country_id": "90"
                },
                "added": "2023-12-18 07:45:07",                 "status": "IN PLAY",                 "federation": null,
                "location": "Stadion Brawijaya",                 "scheduled": "08:00",                 "competition": {
                    "tier": 1,
                    "is_cup": false,
                    "has_groups": true,
                    "id": 27,
                    "active": true,
                    "name": "GO-JEK Liga 1",                     "is_league": true,
                    "national_teams_only": false
                },
                "id": 483253,
                "time": "43",                 "fixture_id": 1624810,
                "odds": {
                    "live": {
                        "1": 2.38,
                        "2": 3.6,
                        "X": 2.43
                    },
                    "pre": {
                        "1": 1.98,
                        "2": 3.3,
                        "X": 3.15
                    }
                },
                "away": {
                    "stadium": "Stadion Andi Mattalatta",                     "id": 204,
                    "logo": "https://cdn.live-score-api.com/teams/d39724be7ff1da90678b25cf3be6e6f1.png",                     "name": "PSM Makassar",                     "country_id": "90"
                },
                "outcomes": {
                    "half_time": null,
                    "full_time": null,
                    "extra_time": null,
                    "penalty_shootout": null
                },
                "scores": {
                    "score": "0 - 0",                     "ht_score": "",                     "ft_score": "",                     "et_score": "",                     "ps_score": ""
                },
                "urls": {
                    "events": "https://livescore-api.com/api-client/scores/events.json?id=483253",                     "statistics": "https://livescore-api.com/api-client/matches/stats.json?match_id=483253",                     "lineups": "https://livescore-api.com/api-client/matches/lineups.json?match_id=483253",                     "head2head": "https://livescore-api.com/api-client/teams/head2head.json?team1_id=5746&team2_id=204"
                }
            }
        ]
    }
}
```

--------------------------------

### Get Live Scores for a Competition (Python)

Source: https://live-score-api.com/documentation/reference/46/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/Spain

Retrieve live scores for a competition using Python's urllib2 library. This example demonstrates making the request and reading the response.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/fantasy/fantasy.json?key=demo_key&secret=demo_secret&match_id=702913&lang=ru')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Get Translated Match Statistics (Python)

Source: https://live-score-api.com/documentation/reference/23/match-statistics

This Python example shows how to fetch translated match statistics. It utilizes the urllib2 library to make the request. Replace placeholders with your valid API credentials and match ID.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/matches/statistics.json?key=demo_key&secret=demo_secret&match_id=702913&lang=da')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Example JSON Response

Source: https://live-score-api.com/documentation/reference/8/response_formats

This is an example of a successful JSON response from the API, containing match data. It includes details about the country, teams, competition, scores, and odds.

```json
{
    "success": true,
    "data": {
        "match": [
            {
                "country": {
                    "is_real": true,
                    "id": 71,
                    "uefa_code": "",
                    "name": "Australia",
                    "fifa_code": "AUS",
                    "flag": "AUS.png"
                },
                "last_changed": "2023-12-18 08:42:53",
                "home": {
                    "stadium": "Campbelltown Stadium",
                    "id": 6581,
                    "logo": "https://cdn.live-score-api.com/teams/b9d463b08c43de617618f7ec65a54cc3.png",
                    "name": "Macarthur",
                    "country_id": "71"
                },
                "added": "2023-12-18 07:45:06",
                "status": "IN PLAY",
                "federation": null,
                "location": "Campbelltown Stadium",
                "scheduled": "08:00",
                "competition": {
                    "tier": 1,
                    "is_cup": false,
                    "has_groups": true,
                    "id": 67,
                    "active": true,
                    "name": "Hyundai A-League",
                    "is_league": true,
                    "national_teams_only": false
                },
                "id": 483252,
                "time": "43",
                "fixture_id": 1657338,
                "odds": {
                    "live": {
                        "1": 5.6,
                        "2": 1.61,
                        "X": 3.55
                    },
                    "pre": {
                        "1": 2,
                        "2": 3.45,
                        "X": 3.85
                    }
                },
                "away": {
                    "stadium": "Westpac Stadium",
                    "id": 202,
                    "logo": "https://cdn.live-score-api.com/teams/004d52954bd4936cc14e30b4511073ab.png",
                    "name": "Wellington Phoenix",
                    "country_id": "71"
                },
                "outcomes": {
                    "half_time": null,
                    "full_time": null,
                    "extra_time": null,
                    "penalty_shootout": null
                },
                "scores": {
                    "score": "0 - 1",
                    "ht_score": "",
                    "ft_score": "",
                    "et_score": "",
                    "ps_score": ""
                },
                "urls": {
                    "events": "https://livescore-api.com/api-client/scores/events.json?id=483252",
                    "statistics": "https://livescore-api.com/api-client/matches/stats.json?match_id=483252",
                    "lineups": "https://livescore-api.com/api-client/matches/lineups.json?match_id=483252",
                    "head2head": "https://livescore-api.com/api-client/teams/head2head.json?team1_id=6581&team2_id=202"
                }
            },
            {
                "country": {
                    "is_real": true,
                    "id": 90,
                    "uefa_code": "",
                    "name": "Indonesia",
                    "fifa_code": "IDN",
                    "flag": "IDN.png"
                },
                "last_changed": "2023-12-18 08:42:52",
                "home": {
                    "stadium": "Stadion Brawijaya",
                    "id": 5746,
                }
            }
        ]
    }
}
```

--------------------------------

### Verify API Key and Secret

Source: https://live-score-api.com/documentation/reference/5/verify_api_key_and_secret

To validate your API key and secret pair, you can use the provided URL. If the response includes "success": "true", your credentials are valid and you can begin accessing data. The example below uses demo credentials; when logged in, examples will reflect your own API key and secret.

```APIDOC
## GET /verify

### Description
This endpoint verifies if the provided API key and secret are valid and working correctly with the Football API.

### Method
GET

### Endpoint
/verify

### Parameters
No parameters are explicitly mentioned for this endpoint in the source text.

### Request Example
No request body or parameters are shown for this example.

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the API key and secret are valid.
- **data** (object) - Contains additional information about the response.
  - **message** (string) - A confirmation message that the API key and secret are working correctly.

#### Response Example
```json
{
    "success": true,
    "data": {
        "message": "You API key and API secret are working correctly"
    }
}
```
```

--------------------------------

### Example Teams API Response

Source: https://live-score-api.com/documentation/reference/20/getting-list-of-teams

This is an example of the JSON response received when requesting a list of teams. It includes details for each team, its associated country, and federation.

```json
{
    "success": true,
    "data": {
        "teams": [
            {
                "team": {
                    "id": 1742,
                    "name": "Albania",
                    "stadium": "Stadiumi Loro Bori\u00e7i",
                    "country_id": 115,
                    "logo": "https:\/\/cdn.live-score-api.com\/teams\/f2680adbce2edcc4bdab5588f871bd57.png"
                },
                "country": {
                    "id": 115,
                    "name": "UEFA",
                    "flag": "uefa.png",
                    "fifa_code": "",
                    "uefa_code": "",
                    "is_real": false
                },
                "federation": {
                    "id": 2,
                    "name": "UEFA"
                }
            },
            {
                "team": {
                    "id": 2680,
                    "name": "Armenia",
                    "stadium": "Vazgen Sargsyan anvan Hanrapetakan Marzadasht",
                    "country_id": 115,
                    "logo": "https:\/\/cdn.live-score-api.com\/teams\/4e0d1ec0fb84e65525fff1ae5c53154b.png"
                },
                "country": {
                    "id": 115,
                    "name": "UEFA",
                    "flag": "uefa.png",
                    "fifa_code": "",
                    "uefa_code": "",
                    "is_real": false
                },
                "federation": {
                    "id": 2,
                    "name": "UEFA"
                }
            }
        ]
    }
}
```

--------------------------------

### Example Response for Fantasy Players Statistics

Source: https://live-score-api.com/documentation/reference/46/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/Spain

This is an example of the JSON response structure for the fantasy players statistics endpoint. It includes match details and statistics for players involved.

```JSON
{
    "success": true,
    "data": [
        {
            "match": {
                "ht_score": "2 - 3",
                "time": "FT",
                "ft_score": "4 - 3",
                "year": "2026",
                "et_score": "",
                "home": {
                    "stadium": "Allianz Arena",
                    "name": "Bayern Munich",
                    "logo": "https:\/\/cdn.live-score-api.com\/teams\/facc74833d4d77c1e5eb8e6a5a872250.png"
                }
            }
        }
    ]
}
```

--------------------------------

### Get Fantasy Player Statistics

Source: https://live-score-api.com/documentation/reference/46/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/Spain

To get the live-scores only for a certain competition, you have to provide the id of the competition as a get parameter in the api endpoint URL. In the example below, we show you how to get all the live-scores for Italy's Seria A.

```APIDOC
## Get Fantasy Player Statistics

### Description
Retrieves fantasy player statistics for a specific match.

### Method
GET

### Endpoint
https://livescore-api.com/api-client/fantasy/fantasy.json

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key.
- **secret** (string) - Required - Your API secret.
- **match_id** (integer) - Required - The ID of the match to get statistics for.
- **lang** (string) - Optional - The language code for the response (e.g., 'ru').

### Request Example
```bash
curl -XGET "https://livescore-api.com/api-client/fantasy/fantasy.json?key=demo_key&secret=demo_secret&match_id=702913&lang=ru"
```

### Response
#### Success Response (200)
- **data** (object) - Contains player statistics.
  - **player_statistics** (array) - An array of player statistics objects.
    - **fouls_committed** (integer)
    - **passes_into_final_third** (integer)
    - **tackles_total** (integer)
    - **defensive_actions** (integer)
    - **aerials_duels_total** (integer)
    - **chances_created** (integer)
    - **blocked_opposition_shots** (integer)
    - **interceptions** (integer)
    - **assists** (integer)
    - **long_balls_accurate** (integer)
    - **corners** (integer)

#### Response Example
```json
{
    "data": {
        "player_statistics": [
            {
                "fouls_committed": 0,
                "passes_into_final_third": 16,
                "tackles_total": 4,
                "defensive_actions": 6,
                "aerials_duels_total": 1,
                "chances_created": 4,
                "blocked_opposition_shots": 0,
                "interceptions": 2,
                "assists": 1,
                "long_balls_accurate": 8,
                "corners": 6
            }
        ]
    }
}
```
```

--------------------------------

### Choosing XML Response Format

Source: https://live-score-api.com/documentation/reference/9/making_requests

Illustrates how to specify XML as the desired response format by using the '.xml' file extension.

```http
GET: http://livescore-api.com/api-client/matches/live.xml?key=demo_key&secret=demo_secret
```

--------------------------------

### Get Top Disciplinary Records (Python)

Source: https://live-score-api.com/documentation/reference/30/getting-competition-top-disciplinary

Fetch top disciplinary records for a competition in Python. This example demonstrates making an HTTP GET request and printing the response.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/competitions/topcards.json?key=demo_key&secret=demo_secret&competition_id=362&lang=ar')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Get Live Scores for a Competition (cURL)

Source: https://live-score-api.com/documentation/reference/46/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/%28/leagues/league/43/Spain

Fetch live scores for a specific competition by providing its ID in the API endpoint. This example shows how to get scores for Italy's Seria A.

```bash
curl -XGET "https://livescore-api.com/api-client/fantasy/fantasy.json?key=demo_key&secret=demo_secret&match_id=702913&lang=ru"
```

--------------------------------

### Example .ini Configuration File

Source: https://live-score-api.com/documentation/tutorials/4/keeping_api_pain_out_of_source_code

Store API keys and secrets in a separate .ini file to keep them out of your source code. Ensure this file is not committed to version control and is protected from public access.

```ini
LIVESCORE_API_KEY = demo_key
LIVESCORE_API_SECRET = demo_secret

```

--------------------------------

### Get Match Statistics

Source: https://live-score-api.com/documentation/reference/23/match-statistics

Retrieve statistics for a specific match using its ID. The match must have started to have statistics available. An optional language parameter can be used to get translated statistic names.

```APIDOC
## Get Match Statistics

### Description
Retrieves statistics for a given match ID. This endpoint is useful for displaying real-time or post-match statistics for football games.

### Method
GET

### Endpoint
/match/statistics

### Parameters
#### Query Parameters
- **match_id** (number) - Required - The ID of the match for which to retrieve statistics.
- **lang** (string) - Optional - The language code (e.g., 'fr') to translate the statistic names.

### Request Example
GET /match/statistics?match_id=172252&lang=fr

### Response
#### Success Response (200)
- **statistics** (object) - Contains statistics for the match, broken down by team.
  - **home_team** (object) - Statistics for the home team.
  - **away_team** (object) - Statistics for the away team.

#### Response Example
{
  "statistics": {
    "home_team": {
      "Shots": 15,
      "Possession": 60,
      "Corners": 7
    },
    "away_team": {
      "Shots": 10,
      "Possession": 40,
      "Corners": 5
    }
  }
}
```

--------------------------------

### Fetch Live Standings (Python)

Source: https://live-score-api.com/documentation/reference/43/live-standings-competitions

This Python example shows how to retrieve live standings using the urllib2 library. Remember to substitute your specific competition ID, key, and secret.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/standings/live.json?competition_id=2&key=demo_key&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Match Lineups Response Example

Source: https://live-score-api.com/documentation/reference/26/getting-team-lineups

This JSON object shows a sample response for the Match Lineups endpoint. It includes team information and a list of players with their details such as substitution status and shirt number.

```json
{
    "success": true,
    "data": {
        "lineup": {
            "home": {
                "team": {
                    "id": "2210",
                    "name": "Estudiantes Merida",
                    "stadium": "Estadio Olmpico Metropolitano de Mmpida",
                    "location": "Estadio Olmpico Metropolitano de Mmpida"
                },
                "players": [
                    {
                        "team_id": "2210",
                        "id": "41983",
                        "name": "Alejandro Araque",
                        "substitution": "0",
                        "shirt_number": "1"
                    },
                    {
                        "team_id": "2210",
                        "id": "42001",
                        "name": "Daniel Linarez",
                        "substitution": "0",
                        "shirt_number": "3"
                    },
                    {
                        "team_id": "2210",
                        "id": "41998",
                        "name": "Christian Flores",
                        "substitution": "0",
                        "shirt_number": "7"
                    },
                    {
                        "team_id": "2210",
                        "id": "41997",
                        "name": "Jesus Meza",
                        "substitution": "0",
                        "shirt_number": "10"
                    },
                    {
                        "team_id": "2210",
                        "id": "42016",
                        "name": "Jose Luis Marrufo",
                        "substitution": "0",
                        "shirt_number": "13"
                    },
                    {
                        "team_id": "2210",
                        "id": "41991",
                        "name": "Cristian Rivas",
                        "substitution": "0",
                        "shirt_number": "15"
                    },
                    {
                        "team_id": "2210",
                        "id": "41958",
                        "name": "Armando Jose Araque Pena",
                        "substitution": "0",
                        "shirt_number": "17"
                    },
                    {
                        "team_id": "2210",
                        "id": "41999",
                        "name": "Jose Manriquez",
                        "substitution": "0",

```

--------------------------------

### Example API Request Structure

Source: https://live-score-api.com/documentation/reference/9/making_requests

Demonstrates the general structure of an API endpoint URL, including the root path, module, controller, response format, and query parameters for authentication.

```APIDOC
## GET /matches/live.json

### Description
This endpoint retrieves live match data in JSON format.

### Method
GET

### Endpoint
`http://livescore-api.com/api-client/matches/live.json`

### Parameters
#### Query Parameters
- **api_key** (string) - Required - Your API key for authentication.
- **api_secret** (string) - Required - Your API secret for authentication.

### Request Example
```http
GET http://livescore-api.com/api-client/matches/live.json?api_key=YOUR_API_KEY&api_secret=YOUR_API_SECRET
```

### Response
#### Success Response (200)
- **data** (object) - Contains the match information.
- **status** (string) - Indicates the success or failure of the request.

#### Response Example
```json
{
  "data": {
    "matches": [
      {
        "match_id": "12345",
        "home_team": "Team A",
        "away_team": "Team B",
        "score": "1-0"
      }
    ]
  },
  "status": "success"
}
```
```

--------------------------------

### PHP: Initialize LiveScoreApi and Fetch Scores

Source: https://live-score-api.com/documentation/tutorials/24/how-to-create-livescore-website-part-2

This PHP snippet initializes the LiveScoreApi class with credentials and fetches live scores. It includes necessary configuration and class files.

```php
ini_set('display_errors', 'Off');
error_reporting(E_ALL);

require_once 'config.php';
require_once 'classes/LiveScoreApi.class.php';

$LiveScoreApi = new LiveScoreApi(KEY, SECRET, DB_HOST, DB_USER, DB_PASS, DB_NAME);
$scores = $LiveScoreApi->getLivescores();

include 'inc/header.php';
include 'inc/left.php';

// live scores code goes here

include 'inc/rigth.php';
include 'inc/footer.php';


```

--------------------------------

### Get Seasons List

Source: https://live-score-api.com/documentation/reference/31/seasons-list

This endpoint retrieves a list of available seasons. No parameters are required. The response includes season IDs, names, start dates, and end dates.

```json
{
    "success": true,
    "data": {
        "seasons": [
            {
                "id": "12",
                "name": "2023",
                "start": "2023-01-01",
                "end": "2023-12-31"
            },
            {
                "id": "14",
                "name": "2022/2023",
                "start": "2022-07-01",
                "end": "2023-06-30"
            },
            {
                "id": "11",
                "name": "2022",
                "start": "2022-01-01",
                "end": "2022-12-31"
            },
            {
                "id": "13",
                "name": "2021/2022",
                "start": "2021-07-01",
                "end": "2022-06-30"
            }
        ]
    }
}
```

--------------------------------

### Fetch Live Standings (PHP)

Source: https://live-score-api.com/documentation/reference/43/live-standings-competitions

This PHP code snippet demonstrates how to fetch live standings data using file_get_contents. Replace placeholders with your actual API credentials.

```php
file_get_contents('https://livescore-api.com/api-client/standings/live.json?competition_id=2&key=demo_key&secret=demo_secret');
```

--------------------------------

### Get Top Scorers with Language Translation (Python)

Source: https://live-score-api.com/documentation/reference/28/getting-competition-top-goalscorers

This Python example shows how to fetch top goal scorer data with language translation. It uses the `urllib2` library to make the request and print the response.

```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/competitions/topscorers.json?key=demo_key&secret=demo_secret&competition_id=362&lang=ar')
response = urllib2.urlopen(req)
print response.read()
```

--------------------------------

### Get Competitions List using PHP

Source: https://live-score-api.com/documentation/reference/11/getting-leagues-list

This PHP snippet demonstrates how to retrieve competition data using the file_get_contents function. Ensure you replace the demo key and secret with your valid credentials.

```php
file_get_contents('https://livescore-api.com/api-client/competitions/list.json?key=demo_key&secret=demo_secret');
```

--------------------------------

### Get Match Events

Source: https://live-score-api.com/documentation/reference/14/getting_match_events_data

This endpoint allows you to retrieve all events that have occurred during a specific football match, whether it is live or has already finished. The `data` array will be empty at the start of a match and will populate as events unfold.

```APIDOC
## GET Match Events

### Description
Retrieves goal times, scorers, yellow cards, and red cards for a given football match.

### Method
GET

### Endpoint
`GET: /match/events`

### Parameters
#### Query Parameters
- **id** (Number) - Required - The ID of the match for which to retrieve events.
- **lang** (String) - Optional - The 2-letter code for the desired language. Availability depends on the package.

### Response
#### Success Response (200)
- **event** (String) - The type of event (e.g., YELLOW_CARD).
- **info.id** (Number) - The ID of the second player involved in the event (e.g., substitution). Nullable.
- **info.name** (String) - The name of the second player involved in the event (e.g., assist). Nullable.
- **is_away** (Boolean) - Indicates if the event relates to the away team.
- **is_home** (Boolean) - Indicates if the event relates to the home team.
- **label** (String) - A human-readable label for the event (e.g., Goal).
- **player.id** (Number) - The ID of the player associated with the event. Nullable.
- **player.name** (String) - The name of the player associated with the event.
- **sort** (Number) - The order in which events occurred, useful for events happening in the same minute.
- **time** (Number) - The minute of the match when the event occurred.

### Response Example
```json
{
  "data": [
    {
      "event": "GOAL",
      "info": {
        "id": null,
        "name": null
      },
      "is_away": false,
      "is_home": true,
      "label": "Goal",
      "player": {
        "id": 2170,
        "name": "Paul Pogba"
      },
      "sort": 8,
      "time": 38
    }
  ],
  "match": {
    "id": 129180,
    "competition": {
      "id": 1,
      "name": "Serie A"
    },
    "home_team": {
      "id": 10,
      "name": "Juventus"
    },
    "away_team": {
      "id": 12,
      "name": "Inter Milan"
    }
  }
}
```
```

--------------------------------

### Example URL Object

Source: https://live-score-api.com/documentation/reference/35/standard_response_objects

The urls object provides direct links to related data. Append your key and secret to use these URLs.

```json
{"head2head": "https://livescore-api.com/api-client/teams/head2head.json?team1_id=5746&team2_id=204}"
```

--------------------------------

### Get Match Lineups

Source: https://live-score-api.com/documentation/reference/26/getting-team-lineups

Use this endpoint to fetch team lineups for a specific match. The availability of lineups depends on the competition's popularity and match importance. Requires a match_id.

```bash
GET: 
__
```

--------------------------------

### Edition Object Example

Source: https://live-score-api.com/documentation/reference/35/standard_response_objects

Links a competition to a season, representing a specific annual cycle of a tournament. Use this to differentiate data between different cycles of the same competition.

```json
{
    "edition": {
        "id": 683,
        "season_id": 11,
        "is_current": true
    }
}
```

--------------------------------

### Get Seasons List

Source: https://live-score-api.com/documentation/reference/31/seasons-list

This endpoint retrieves a list of all available seasons. It does not require any parameters and provides persistent season IDs that can be used with other API endpoints to access historical or future competition data. The response includes the season ID, name, start date, and end date.

```APIDOC
## GET /seasons

### Description
Retrieves a list of all available seasons, including their IDs, names, start dates, and end dates. The season IDs are persistent and can be used to query historical or future competition data.

### Method
GET

### Endpoint
/seasons

### Parameters
This endpoint does not accept any parameters.

### Response
#### Success Response (200)
- **data** (object) - Contains the list of seasons.
  - **seasons** (array) - An array of season objects.
    - **id** (number) - The unique identifier for the season.
    - **name** (string) - The human-readable name of the season (e.g., "2023" or "2022/2023").
    - **start** (date) - The approximate start date of the season.
    - **end** (date) - The approximate end date of the season.

#### Response Example
```json
{
    "success": true,
    "data": {
        "seasons": [
            {
                "id": "12",
                "name": "2023",
                "start": "2023-01-01",
                "end": "2023-12-31"
            },
            {
                "id": "14",
                "name": "2022/2023",
                "start": "2022-07-01",
                "end": "2023-06-30"
            }
        ]
    }
}
```
```

--------------------------------

### Get Match Statistics

Source: https://live-score-api.com/documentation/reference/23/match-statistics

Retrieve statistics for a specific match. You can optionally specify a language code to get translated labels.

```APIDOC
## GET /statistics/matches.json

### Description
Retrieves detailed statistics for a given football match. The response includes various metrics such as attacks, shots, possession, and cards for both home and away teams. Supports language localization for statistic labels.

### Method
GET

### Endpoint
/statistics/matches.json

### Parameters
#### Query Parameters
- **key** (string) - Required - Your API key.
- **secret** (string) - Required - Your API secret.
- **match_id** (integer) - Required - The ID of the match to retrieve statistics for.
- **lang** (string) - Optional - The language code for translating statistic labels (e.g., 'da' for Danish).

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (array) - An array of statistic objects.
  - **type** (string) - The type of statistic (e.g., "attacks", "corners", "red_cards").
  - **label** (string) - The human-readable label for the statistic, translated based on the `lang` parameter.
  - **home** (number) - The value of the statistic for the home team.
  - **away** (number) - The value of the statistic for the away team.

### Response Example
```json
{
    "success": true,
    "data": [
        {
            "type": "attacks",
            "label": "Attacks",
            "home": 50,
            "away": 45
        },
        {
            "type": "corners",
            "label": "Corners",
            "home": 5,
            "away": 3
        },
        {
            "type": "red_cards",
            "label": "Red Cards",
            "home": 0,
            "away": 1
        }
    ]
}
```
```

--------------------------------

### Fetch Live Standings (cUrl)

Source: https://live-score-api.com/documentation/reference/43/live-standings-competitions

Use this cUrl command to fetch live standings for a competition. Ensure you replace placeholders with your actual competition ID, key, and secret.

```bash
curl -XGET "https://livescore-api.com/api-client/standings/live.json?competition_id=2&key=demo_key&secret=demo_secret"
```

--------------------------------

### Get Countries List

Source: https://live-score-api.com/documentation/reference/10/getting-countries-list

This endpoint retrieves a list of countries. You can use the country ID in subsequent requests to get more specific data.

```APIDOC
## GET /countries/list.json

### Description
Retrieves a list of countries available in the live score API.

### Method
GET

### Endpoint
/countries/list.json

### Query Parameters
- **date** (string) - Optional - Specifies the date for which to retrieve country data (e.g., 'today').
- **key** (string) - Required - Your API key.
- **secret** (string) - Required - Your API secret.

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **data** (object) - Contains the country data.
  - **country** (array) - A list of country objects.
    - **id** (number) - The unique identifier for the country.
    - **name** (string) - The name of the country.
    - **is_real** (number) - A flag indicating if the country is real (1) or not (0).
    - **leagues** (url) - A URL to the list of leagues for this country.
    - **scores** (url) - A URL to the live scores for this country.
    - **national_team** (object or null) - Information about the country's national team if it's a real country.
    - **federation** (object) - Information about the football federation the country belongs to.
      - **id** (number) - The ID of the federation.
      - **name** (string) - The name of the federation.

### Response Example
```json
{
    "success": true,
    "data": {
        "country": [
            {
                "id": "82",
                "name": "Africa",
                "is_real": "0",
                "leagues": "http:\/\/livescore-api.com\/api-client\/leagues\/list.json?key=demo_key&secret=demo_secret&country=82",
                "scores": "http:\/\/livescore-api.com\/api-client\/scores\/live.json?key=demo_key&secret=demo_secret&country=82",
                "national_team": null,
                "federation": {
                    "id": "3",
                    "name": "CAF"
                }
            }
        ]
    }
}
```

### Example Usage
```bash
curl -XGET https://livescore-api.com/api-client/countries/list.json?date=today&key=demo_key\&secret=demo_secret
```
```python
import urllib2
req = urllib2.Request('https://livescore-api.com/api-client/countries/list.json?date=today&key=demo_key\&secret=demo_secret')
response = urllib2.urlopen(req)
print response.read()
```
```php
file_get_contents('https://livescore-api.com/api-client/countries/list.json?date=today&key=demo_key\&secret=demo_secret');
```
```

--------------------------------

### API and Database Configuration

Source: https://live-score-api.com/documentation/tutorials/22/how-to-create-livescore-website

Configure your website with API keys, secrets, and MySQL database credentials. These settings are essential for connecting to the live-score API and storing data.

```dotenv
KEY=AAAAAAAAAAAAAAAA ; the API key that you get from the live-score-api.com website
SECRET=BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB ; the API secret that you get from the live-score-api.com website
DB_HOST = 'localhost' ; the webser where your database is running
DB_NAME = 'ls_local' ; the name of the database that we are going to use
DB_USER = 'root' ; the username with which we are going to access the database
DB_PASS = 'root' ; the password with which we are going to authenticate

```
Tokens:
Raw