Contents
Overview of Sportmonks’ top scorers endpoint
The Sportmonks top scorers API makes it easy to get quick leaderboards for key player stats.
What stats you can get
– Goals: See who scores the most.
– Assists: Find players who create goal chances.
– Cards: Track discipline (red = 2 points, yellow = 1 point).
You can get all of them at once or just pick one type.
Limit: Top 25 players
Each request shows only the top 25 players for each stat type. This keeps things fast and easy to read, whether you’re looking at a full season or just one stage.
Two ways to use the API
Choose the option that fits your needs:
– By season ID: Combines all stages of the season (great for full-season stats).
– By stage ID: Focuses on just one stage (like group stage or semi-finals).
Season vs Stage endpoints – What’s the difference?
Both endpoints work the same way – they use the same structure, parameters, and features. The only difference is how much data they cover.
🏆 Top scorers by season ID
GET https://api.sportmonks.com/v3/football/topscorers/seasons/{season_id}
– Shows top scorers across all stages of a season.
– You can add extra info like: player, team, stage, and type (up to 4 levels deep).
– Filter by scorer type with: seasontopscorerTypes:[type_id]
– Supports pagination (per_page, page) and sorting (order=asc|desc).
Example:
GET https://api.sportmonks.com/v3/football/topscorers/seasons/{season_id}?api_token=YOUR_TOKEN&include=player,participant,type&order=desc
🎯 Top scorers by stage ID
GET https://api.sportmonks.com/v3/football/topscorers/stages/{stage_id}
– Shows top scorers for just one stage (like a group or knockout round).
– Works the same as the season version, same includes, filters, and sorting.
Example:
GET https://api.sportmonks.com/v3/football/topscorers/stages/{stage_id}?api_token=YOUR_TOKEN&include=player,participant,type&order=desc
Filtering & including data (API v3)
Sportmonks v3 topscorers endpoints support robust includes and filters, enabling you to enrich data and tailor results efficiently.
Including related entities
You can request detailed contextual data along with stats using up to 4 nested includes:
Common includes are: player, participant (the team), stage,season,type (goals, assists, cards)
Examples:
– Fetch goalscorers with player and team details:
&include=player,participant,type
– Add stage or season context if needed:
&include=player,participant,stage,season,type
This way, a single call returns not only the total goals or assists, but also the player’s name, photo URL, team name/logo, and stage information.
Filtering by scorer type
Use dynamic filters to limit results to specific categories:
– Types filter applied even without the type include:
&filters=seasontopscorerTypes:208
e.g. fetching only goal scorers in a season.
For stage endpoint:
&filters=stagetopscorerTypes:208
Supported type IDs:
– 208 = Goal Topscorer
– (others include assists and cards)
This returns only players from the selected category instead of all three.
Pagination & sorting
– Order: Sort by performance rank (position):
&order=desc
(Default is ascending)
– Pagination: Control amount and page number of results:
&per_page=25 &page=1
Combined URL example
Fetch the top 25 goal scorers in a season, including full entity details:
GET https://api.sportmonks.com/v3/football/topscorers/seasons/{season_id}?api_token=YOUR_TOKEN&include=player,participant,type,stage&filters=seasontopscorerTypes:208&order=desc&per_page=25
Practical implementation (API v3)
Here are concrete examples showing how to fetch and handle topscorers data using Sportmonks football API v3, from simple HTTP requests to structured handling in Python and Node.js.
A. Python example (requests)
import requests
API_TOKEN = "YOUR_TOKEN"
season_id = 23744 # Example: Bundesliga 2024/25
url = (
f"https://api.sportmonks.com/v3/football/topscorers/seasons/{season_id}"
)
params = {
"api_token": API_TOKEN,
"include": "player,participant,type",
"filters": "seasontopscorerTypes:208", # only goals
"order": "desc",
"per_page": 25
}
resp = requests.get(url, params=params)
if resp.status_code == 200:
for item in resp.json()["data"]:
player = item["player"]["data"]["common_name"]
team = item["participant"]["data"]["name"]
goals = item["total"]
print(f"{player} ({team}) — {goals}")
else:
print("Error:", resp.status_code, resp.text)
Fetches top goal-scorers for the season with player and team info, sorted descending.
Node.js example (unirest)
const unirest = require('unirest');
const API_TOKEN = "YOUR_TOKEN";
const seasonId = 23744; # Example: Bundesliga 2024/25
unirest('GET', `https://api.sportmonks.com/v3/football/topscorers/seasons/${seasonId}`)
.query({
api_token: API_TOKEN,
include: 'player,participant,type',
filters: 'seasontopscorerTypes:208',
order: 'desc',
per_page: 25
})
.end(res => {
if (res.error) throw new Error(res.error);
res.body.data.forEach(item => {
console.log(
`${item.player.data.common_name} (${item.participant.data.name}) — ${item.total}`
);
});
});
How the top scorers API works across competitions
Sportmonks’ top scorers API is used across major football competitions, helping developers create rich, tailored leaderboards and stat displays for fans.
1. UEFA Europa League
– Use a dedicated endpoint to show top scorers, like “Top goal scorers this season.”
– Easily filter by goals, assists, or cards.
– Includes extra player details (like name, image, and team) in one call using the include option.
2. Serie A (Italy)
– Offers full access to top performers, scorers, assist providers, and card stats.
– Filter by team to show custom lists like “Inter’s top scorers this season.”
– Works smoothly with other Serie A data like matches, standings, and lineups, perfect for building all-in-one football apps.
3. Brazilian Serie A & other global leagues
– Works just like the European leagues, includes goals, assists, cards, and player details.
– Sportmonks supports 2,500+ global competitions, including UEFA Champions League, Copa Libertadores, National and regional leagues
All use a consistent API structure, making it easy to scale across multiple competitions.
Developer ecosystem, pricing & rate limits (API v3)
Sportmonks offers a developer-friendly platform with flexible plans, helpful tools, and clear usage limits.
Free access & trial options
– Free plan: Access to selected leagues like the Scottish Premiership and Danish Superliga. No expiry and unlimited usage.
– 14-day free trial: Try any paid plan (European, Worldwide, or Custom) for 14 days before subscribing.
Choose your plan
Find the perfect plan to get the data you need. All plans include 3,000 calls per hour, per entity, ensuring reliable and fast access to data.
European
Perfect for focused analysis on major European football.
– Leagues covered: ~27 top European leagues (e.g., Premier League, La Liga, Serie A, Bundesliga, Ligue 1)
– Price: €34/month (billed annually)
Worldwide
Expand your reach with comprehensive global coverage.
– Leagues covered: 111+ leagues worldwide
– Price: Higher-tier pricing – € 112 ( billed annually)
Enterprise
Tailored solutions for extensive data needs and custom integrations.
– Leagues covered: 2,500+ leagues globally
– Includes: Optional modules and custom solutions
– Price: Custom Quote – Contact Sales
Understanding rate limits
– Default: 3,000 calls/hour per entity (like topscorers, teams, or fixtures)
– Calls are grouped by entity – all calls to the same data type count together.
– Each response includes a rate_limit object with remaining (calls left), resets_in_seconds (when it resets) and HTTP headers like X-Ratelimit-Remaining also included
What happens when you hit the limit?
– You’ll get a 429 error (Too many requests)
– The limit resets 1 hour after your first call
– To avoid issues use exponential backoff, track your remaining calls and cache results when data doesn’t change often
Need more? You can increase your limits through your MySportmonks dashboard.
Developer tools & support
– SDKs & tutorials: Python, JavaScript, Crystal, best-practices, and a “Football API coach”
– Support: Friendly, fast help via [email protected]
– Docs & tools: API tester, Postman collection, ID finder
Keep fans engaged with real-time top scorers from Sportmonks
Add excitement to your apps with live rankings of top scorers, assist makers, and card collectors, all powered by Sportmonks’ football API. Whether you’re building a match hub, a fantasy game, or a stat-driven blog, you can show users who’s leading the charts, moment by moment.
It’s simple to use and packed with detail. With one easy API call, you can fetch the top 25 players per stat type ie goals, assists, or cards. You can even include player names, team logos, and stage details with just a few query parameters. Available by season or competition stage, it’s perfect for both full-season overviews and knockout-stage spotlights.
Start using the Sportmonks top players API today and build experiences fans will return to every matchday.
FAQs about Sportmonks’ top scorers API
