A
A
API 3.0 (BETA)
Football API 3.0 (BETA)
Search…
⌃K

GET Topscorers by Season ID

This endpoint returns all the topscorers per stage of the requested season.
Base URL
Example Response
Field Description
https://api.sportmonks.com/v3/football/topscorers/seasons/{ID}
{
"data": [
{
"league_id": 8,
"season_id": 18378,
"stage_id": 77453700,
"player_id": 1183,
"team_id": 1,
"type_id": 83,
"position": 1,
"total": 2,
},
{
"league_id": 8,
"season_id": 18378,
"stage_id": 77453700,
"player_id": 160217,
"team_id": 29,
"type_id": 83,
"position": 2,
"total": 2,
},
Field
Description
Type
league_id
Refers to the league related to the topscorer
integer
season_id
Refers to the season related to the topscorer
integer
stage_id
Refers to the stage related to the topscorer
integer
player_id
Refers to the player related to the topscorer
integer
team_id
Refers to the team related to the topscorer
integer
type_id
Refers to the type related to the topscorer
integer
position
Displays the position of the topscorer
integer
total
The number of goals, assists or cards off the topscorer
integer

Parameters

Query Parameters
Required?
Description
api_token
YES
Your unique API token
include
NO
Enrich the API with more data by using includes
select
NO
Select specific fields on the base entity

Pagination

YES

Include options

Related Entities:
Get an overview and explanation of all the fields returned in the API response. The related entities for the topscorer endpoints are:

Code Example

Ruby
Python
PHP
Java
Node.js
Go
require "uri"
require "net/http"
url = URI("https://api.sportmonks.com/v3/football/topscorers/seasons/{ID}?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
import http.client
conn = http.client.HTTPSConnection("api.sportmonks.com")
payload = ''
headers = {}
conn.request("GET", "/v3/football/topscorers/seasons/{ID}?api_token={your_token}", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.sportmonks.com/v3/football/topscorers/seasons/{ID}?api_token={your_token}',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
));
$response = curl_exec($curl);
curl_close($curl);
echo $respons
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
Request request = new Request.Builder()
.url("https://api.sportmonks.com/v3/football/topscorers/seasons/{ID}?api_token={your_token}")
.method("GET", null)
.build();
Response response = client.newCall(request).execute();
var unirest = require('unirest');
var req = unirest('GET', 'https://api.sportmonks.com/v3/football/topscorers/seasons/{ID}?api_token={your_token}')
.end(function (res) {
if (res.error) throw new Error(res.error);
console.log(res.raw_body);
});
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.sportmonks.com/v3/football/topscorers/seasons/{ID}?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))
}