Sportmonks

https://docs.sportmonks.com/v3
Admin
Sportmonks is a comprehensive sports data API platform providing access to football/soccer data...
Tokens:1,531,779
Snippets:9,528
Trust Score:9.7
Update:1 day ago
Show doc for...
Tokens:
Raw
### GET All Cities - Python Example

Source: https://docs.sportmonks.com/v3/core-api/endpoints/cities/get-all-cities

Python code example using http.client to make a GET request to the GET All Cities endpoint.

```python
import http.client

conn = http.client.HTTPSConnection("api.sportmonks.com")
payload = ''
headers = {}
conn.request("GET", "/v3/core/cities?api_token={your_token}", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

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

### GET All Markets - Ruby Example

Source: https://docs.sportmonks.com/v3/odds-api/getting-started/endpoints/markets/get-all-markets

Ruby code example using Net::HTTP to make a GET request to the Markets endpoint.

```ruby
require "uri"
require "net/http"

url = URI("https://api.sportmonks.com/v3/odds/markets?api_token={your_token}")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body
```

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

### Python Code Example for GET All Entity Filters

Source: https://docs.sportmonks.com/v3/core-api/endpoints/filters/get-all-entity-filters

Python example using http.client to make a GET request to the endpoint.

```python
import http.client

conn = http.client.HTTPSConnection("api.sportmonks.com")
payload = ''
headers = {}
conn.request("GET", "/v3/core/types?api_token={your_token}", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

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

### Ruby Code Example for GET All Entity Filters

Source: https://docs.sportmonks.com/v3/core-api/endpoints/filters/get-all-entity-filters

Ruby example using Net::HTTP to make a GET request to the endpoint.

```ruby
require "uri"
require "net/http"

url = URI("https://api.sportmonks.com/v3/core/types?api_token={your_token}")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body
```

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

### Static Filter Example for GET All Stages

Source: https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/stages/get-all-stages.md

Example usage of the static filter 'IdAfter' for the GET All Stages endpoint. This filter retrieves all stages starting from a certain stage ID, useful for incremental imports.

```text
&filters=IdAfter:stageID
```

```text
&filters=IdAfter:1100
```

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

### Complete league initialization example in JavaScript

Source: https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/leagues-and-seasons/leagues.md

JavaScript class `FootballAPI` with methods to fetch leagues, a specific league, and live leagues. Demonstrates using `select` and `include` parameters. Requires a modern environment with `fetch` and top-level await.

```javascript
class FootballAPI {
  constructor(apiToken) {
    this.token = apiToken;
    this.baseURL = 'https://api.sportmonks.com/v3/football';
  }

  async getLeagues(params = {}) {
    const query = new URLSearchParams({ api_token: this.token, ...params });
    const r = await fetch(`${this.baseURL}/leagues?${query}`);
    if (!r.ok) throw new Error(`HTTP ${r.status}`);
    return r.json();
  }

  async getLeague(leagueId, params = {}) {
    const query = new URLSearchParams({ api_token: this.token, ...params });
    const r = await fetch(`${this.baseURL}/leagues/${leagueId}?${query}`);
    if (!r.ok) throw new Error(`HTTP ${r.status}`);
    return r.json();
  }

  async getLiveLeagues(params = {}) {
    const query = new URLSearchParams({ api_token: this.token, ...params });
    const r = await fetch(`${this.baseURL}/leagues/live?${query}`);
    if (!r.ok) throw new Error(`HTTP ${r.status}`);
    return r.json();
  }
}

const api = new FootballAPI('YOUR_API_TOKEN');

// Populate league selector with name and logo only
const leagueList = await api.getLeagues({ select: 'name,image_path' });

// Get Scottish Premiership with current season info
const scottishPrem = await api.getLeague(501, { include: 'currentSeason' });
const currentSeasonId = scottishPrem.data.current_season?.id;

// Show only leagues with live matches
const liveLeagues = await api.getLiveLeagues({ include: 'currentSeason' });
```

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

### GET All Regions - Static Filter Example

Source: https://docs.sportmonks.com/v3/core-api/endpoints/regions/get-all-regions

Example of the static filter IdAfter to filter regions starting from a certain region ID.

```text
&filters=IdAfter:regionID
```

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

### Go example for GET My Enrichments

Source: https://docs.sportmonks.com/v3/core-api/my-sportmonks/get-my-enrichments.md

Go code example using net/http to make a GET request to the endpoint. Replace {your_token} with your API token.

```go
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.sportmonks.com/v3/my/enrichments?api_token={your_token}"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

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

### Complete league initialization example in PHP

Source: https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/leagues-and-seasons/leagues.md

PHP class `FootballAPI` using cURL to fetch leagues and a specific league. Demonstrates using `select` and `include` parameters. Requires cURL extension.

```php
<?php
class FootballAPI {
    private $token;
    private $baseURL = 'https://api.sportmonks.com/v3/football';

    public function __construct($apiToken) {
        $this->token = $apiToken;
    }

    public function getLeagues($params = []) {
        $params['api_token'] = $this->token;
        $url = "{$this->baseURL}/leagues?" . http_build_query($params);

        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 30);
        $response = curl_exec($ch);
        curl_close($ch);

        return json_decode($response, true);
    }

    public function getLeague($leagueId, $params = []) {
        $params['api_token'] = $this->token;
        $url = "{$this->baseURL}/leagues/{$leagueId}?" . http_build_query($params);

        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_TIMEOUT, 30);
        $response = curl_exec($ch);
        curl_close($ch);

        return json_decode($response, true);
    }
}

$api = new FootballAPI('YOUR_API_TOKEN');
$leagueList = $api->getLeagues(['select' => 'name,image_path']);
$scottishPrem = $api->getLeague(501, ['include' => 'currentSeason']);
$currentSeasonId = $scottishPrem['data']['current_season']['id'];
print_r($leagueList);
?>
```

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

### Static Filter Example: IdAfter

Source: https://docs.sportmonks.com/v3/core-api/endpoints/countries/get-all-countries

Example of the static filter 'IdAfter' for the GET All Countries endpoint. Filters all countries starting from a certain country ID, useful for imports.

```http
&filters=IdAfter:countryID
```

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

### GET Fixture with pressure include

Source: https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/trends

Retrieves Pressure Index trends for a fixture by adding the 'pressure' include to a GET Fixture by ID request. This is the quick example shown in the guide.

```HTTP
GET /v3/football/fixtures/18804442?include=pressure
```

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

### Go GET My Resources

Source: https://docs.sportmonks.com/v3/core-api/my-sportmonks/get-my-resources.md

Go example using net/http to call the GET My Resources endpoint. Replace {your_token} with your API token.

```go
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.sportmonks.com/v3/my/resources?api_token={your_token}"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

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

### Complete league initialization example in Python

Source: https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/leagues-and-seasons/leagues.md

Python class `FootballAPI` using `requests` to fetch leagues and a specific league. Demonstrates using `select` and `include` parameters. Requires the `requests` library.

```python
import requests

class FootballAPI:
    def __init__(self, api_token):
        self.token = api_token
        self.base_url = 'https://api.sportmonks.com/v3/football'

    def get_leagues(self, params=None):
        params = params or {}
        params['api_token'] = self.token
        r = requests.get(f'{self.base_url}/leagues', params=params, timeout=30)
        r.raise_for_status()
        return r.json()

    def get_league(self, league_id, params=None):
        params = params or {}
        params['api_token'] = self.token
        r = requests.get(f'{self.base_url}/leagues/{league_id}', params=params, timeout=30)
        r.raise_for_status()
        return r.json()

api = FootballAPI('YOUR_API_TOKEN')
league_list = api.get_leagues({'select': 'name,image_path'})
scottish_prem = api.get_league(501, {'include': 'currentSeason'})
current_season_id = scottish_prem['data']['current_season']['id']
```

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

### Static Filter Example: IdAfter

Source: https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/referees/get-all-referees.md

Shows how to use the IdAfter static filter to get referees starting from a certain ID. The example uses 'refereeID' as a placeholder and a concrete ID 18535487.

```plaintext
&filters=IdAfter:refereeID
&filters=IdAfter:18535487
```

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

### Example Response for GET Upcoming Fixtures by Market ID

Source: https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/fixtures/get-upcoming-fixtures-by-market-id.md

Example JSON response showing fixture data including id, league, season, venue, and starting time. The response is truncated in the source.

```json
{
    "data": [
        {
            "id": 19230783,
            "sport_id": 1,
            "league_id": 612,
            "season_id": 24157,
            "stage_id": 77472830,
            "group_id": 251075,
            "aggregate_id": null,
            "round_id": 350222,
            "state_id": 1,
            "venue_id": 4241,
            "name": "Nyva Ternopil' vs Epitsentr Dunayivtsi",
            "starting_at": "2024-08-08 14:00:00",
            "result_info": null,
            "leg": "1/1",
            "details": null,
            "length": 90,
            "placeholder": false,
            "has_odds": true,
            "has_premium_odds": true,
            "starting_at_timestamp": 1723125600
        },
        {
            "id": 19110346,
            "sport_id": 1,
            "league_id": 396,
            "season_id": 23369,
            "stage_id": 77470477,
            "group_id": null,
            "aggregate_id": null,
            "round_id": 336772,
            "state_id": 1,
            "venue_id": 4149,
            "name": "Taraz vs Arys",
            "starting_at": "2024-08-08 14:00:00",
            "result_info": null,
            "leg": "1/1",
            "details": null,
            "length": 90,
            "placeholder": false,
            "has_odds": true,
            "has_premium_odds": true,
            "starting_at_timestamp": 1723125600

```

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

### Java example for GET My Enrichments

Source: https://docs.sportmonks.com/v3/core-api/my-sportmonks/get-my-enrichments.md

Java code example using OkHttpClient to make a GET request to the endpoint. Replace {your_token} with your API token.

```java
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://api.sportmonks.com/v3/my/enrichments?api_token={your_token}")
  .method("GET", null)
  .build();
Response response = client.newCall(request).execute();
```

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

### Static Filter Example: IdAfter

Source: https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/tv-stations/get-all-tv-stations.md

Static filter to get all TV stations starting from a certain ID. Use with the filters query parameter.

```text
&filters=IdAfter:tvStationID
```

```text
&filters=IdAfter:370
```

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

### Go code example for GET Type by Entity

Source: https://docs.sportmonks.com/v3/core-api/endpoints/types/get-type-by-entity.md

Go example using net/http to make a GET request to the endpoint. Replace {your_token} with your API token.

```go
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.sportmonks.com/v3/core/types/1?api_token={your_token}"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

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

### GET Fixtures by Date response

Source: https://docs.sportmonks.com/v3/tutorials-and-guides/guides/how-to-keep-your-database-in-sync

Example response showing fixtures for the date 2022-09-03, including match details like IDs, names, and starting times.

```json
{
  "data": [
    {
      "id": 18528309,
      "sport_id": 1,
      "league_id": 743,
      "season_id": 19684,
      "stage_id": 77457688,
      "group_id": null,
      "aggregate_id": null,
      "round_id": 273906,
      "state_id": 5,
      "venue_id": 2315,
      "name": "Necaxa vs León",
      "starting_at": "2022-09-03 00:00:00",
      "result_info": "León won after full-time.",
      "leg": "1/1",
      "details": null,
      "length": 90,
      "placeholder": false,
      "last_processed_at": "2023-03-02 17:48:14",
      "has_odds": true,
      "starting_at_timestamp": 1662163200
    },
    {
      "id": 18573151,
      "sport_id": 1,
      "league_id": 2034,
      "season_id": 19430,
      "stage_id": 77456822,
      "group_id": null,
      "aggregate_id": null,
      "round_id": 278917,
      "state_id": 5,
      "venue_id": null,
      "name": "Mario Mendez vs Panamá Oeste",
      "starting_at": "2022-09-03 00:00:00",
      "result_info": "Game ended in draw.",
      "leg": "1/1",
      "details": null,
      "length": 90,
      "placeholder": false,
      "last_processed_at": "2023-02-06 16:01:12",
      "has_odds": true,
      "starting_at_timestamp": 1662163200
    },
    //And more
}
```

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

### Example Response for GET All Markets

Source: https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/odds-and-predictions/markets

Example response excerpt showing market objects with id, legacy_id, name, developer_name, and has_winning_calculations fields.

```json
{
  "data": [
    {
      "id": 1,
      "legacy_id": 1,
      "name": "Fulltime Result",
      "developer_name": "FULLTIME_RESULT",
      "has_winning_calculations": true
    },
    {
      "id": 2,
      "legacy_id": 63,
      "name": "Double Chance",
      "developer_name": "DOUBLE_CHANCE",
      "has_winning_calculations": false
    },
    {
      "id": 3,
      "legacy_id": null,
      "name": "X Goal",
      "developer_name": "X_GOAL",
      "has_winning_calculations": false
    }
  ]
}
```

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

### Go example for live probabilities

Source: https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/predictions/get-live-probabilities.md

Use net/http in Go to make a GET request to the live probabilities endpoint. Replace YOUR_TOKEN with your API token.

```go
package main

import (
  "fmt"
  "io/ioutil"
  "net/http"
)

func main() {
  url := "https://api.sportmonks.com/v3/football/predictions/live/probabilities?api_token=YOUR_TOKEN"

  client := &http.Client{}
  req, err := http.NewRequest("GET", url, nil)
  if err != nil {
    fmt.Println(err)
    return
  }

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

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

### GET All Cities - Ruby Example

Source: https://docs.sportmonks.com/v3/core-api/endpoints/cities/get-all-cities

Ruby code example using Net::HTTP to make a GET request to the GET All Cities endpoint.

```ruby
require "uri"
require "net/http"

url = URI("https://api.sportmonks.com/v3/core/cities?api_token={your_token}")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body
```

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

### Go Code Example: Get All Countries

Source: https://docs.sportmonks.com/v3/core-api/endpoints/countries/get-all-countries.md

Go example using net/http to make a GET request to the countries endpoint. Replace {your_token} with your API token.

```Go
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.sportmonks.com/v3/core/countries?api_token={your_token}"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

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

### Example Response for GET All Rivals

Source: https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/rivals/get-all-rivals

An example response from the GET All Rivals endpoint. The response is an empty object, indicating no rivals data is returned in this example.

```json
{}
```

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

### Java GET My Resources

Source: https://docs.sportmonks.com/v3/core-api/my-sportmonks/get-my-resources.md

Java example using OkHttpClient to call the GET My Resources endpoint. Replace {your_token} with your API token.

```java
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://api.sportmonks.com/v3/my/resources?api_token={your_token}")
  .method("GET", null)
  .build();
Response response = client.newCall(request).execute();
```

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

### Select Parameter Example

Source: https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/transfer-rumours/get-transfer-rumours-by-team-id

Example of using the select parameter to choose specific fields.

```http
&select=id,player_id,amount
```

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

### Example Response for GET Team Squad by Team ID

Source: https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/team-squads/get-team-squad-by-team-id.md

A sample JSON response showing squad records with fields like id, transfer_id, player_id, team_id, position_id, detailed_position_id, jersey_number, start, and end.

```json
{
  "data": [
    {
      "id": 635741,
      "transfer_id": 184008,
      "player_id": 581086,
      "team_id": 62,
      "position_id": 26,
      "detailed_position_id": 157,
      "jersey_number": 13,
      "start": "2023-01-23",
      "end": null
    },
    {
      "id": 6517,
      "transfer_id": 18974,
      "player_id": 758,
      "team_id": 62,
      "position_id": 25,
      "detailed_position_id": 154,
      "jersey_number": 2,
      "start": "2015-07-20",
      "end": "2026-05-31"
    },
    {
      "id": 6541,
      "transfer_id": 26786,
      "player_id": 92276,
      "team_id": 62,
      "position_id": 27,
      "detailed_position_id": 151,
      "jersey_number": 20,
      "start": "2017-07-01",
      "end": "2023-05-31"
    }
  ]
}
```

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

### Usage example for SportmonksAPI

Source: https://docs.sportmonks.com/v3/api/rate-limit.md

Shows how to instantiate the SportmonksAPI class and make single, batched, and cached requests. Demonstrates the expected output messages and error handling.

```php
// Usage Example
try {
    $api = new SportmonksAPI('YOUR_TOKEN_HERE');
    
    // Single fixture with includes
    $fixture = $api->request('/fixtures/123', [
        'include' => 'participants;scores;events'
    ], 'Fixture');
    
    echo "Fixture: {$fixture['data']['name']}\n";
    
    // Batched request
    $multipleFixtures = $api->getFixturesByIds([123, 456, 789]);
    echo "Fetched " . count($multipleFixtures['data']) . " fixtures\n";
    
    // Cached types (only fetches once)
    $types = $api->getTypes();
    echo "Got " . count($types) . " types\n";
    
    // Types from cache (0 API calls)
    $typesAgain = $api->getTypes();
    
} catch (Exception $e) {
    echo "Error: " . $e->getMessage() . "\n";
}
```

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

### Node.js code example for GET Market by ID

Source: https://docs.sportmonks.com/v3/odds-api/getting-started/endpoints/markets/get-market-by-id.md

Node.js example using unirest to make a GET request to the endpoint.

```node.js
var unirest = require('unirest');
var req = unirest('GET', 'https://api.sportmonks.com/v3/odds/markets/{ID}?api_token={your_token}')
  .end(function (res) { 
    if (res.error) throw new Error(res.error); 
    console.log(res.raw_body);
  });
```

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

### GET Region by ID - Python Example

Source: https://docs.sportmonks.com/v3/core-api/endpoints/regions/get-region-by-id

Python code example using http.client to make a GET request to the endpoint.

```python
import http.client

conn = http.client.HTTPSConnection("api.sportmonks.com")
payload = ''
headers = {}
conn.request("GET", "/v3/core/regions/{ID}?api_token={your_token}", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
Tokens:
Raw