Top Scorers

GEThttps://devapi.admin.iotait.tech/api/v1/football/players/top-scorers

Leading goalscorers for a competition and season.

Open in API explorer
Freshness — cached for 15 minutes. Repeating the same query inside that window is answered from cache in single digit milliseconds, and meta.cache reads HIT.

Query parameters

NameTypeExampleDescription
competitionrequiredinteger100090Competition identifier, from the competitions endpoint.
seasonrequiredinteger2026Season, as a four digit start year.

Example request

Paste this straight into Postman with Import → Raw text.

curl
curl --location --request GET 'https://devapi.admin.iotait.tech/api/v1/football/players/top-scorers?competition=100090&season=2026' \
--header 'Accept: application/json' \
--header 'X-API-Key: api_mart_your_key_here'

Response

json
{
    "success": true,
    "data": [
        {
            "id": 100075,
            "name": "E. Haaland",
            "firstname": "Erling",
            "lastname": "Braut Haaland",
            "age": 25,
            "birth": {
                "date": "2000-07-21",
                "place": "Leeds",
                "country": "England"
            },
            "nationality": "Norway",
            "height": "195",
            "weight": "88",
            "is_injured": false,
            "photo": "https://apinex.iotait.tech/images/players/100075.png",
            "statistics": [
                {
                    "team": {
                        "id": 100030,
                        "name": "Manchester City",
                        "logo": "https://apinex.iotait.tech/images/teams/100030.png"
                    },
                    "competition": {
                        "id": 100001,
                        "name": "Premier League",
                        "season": 2025,
                        "country": "England",
                        "logo": "https://apinex.iotait.tech/images/competitions/100001.png",
                        "flag": "https://apinex.iotait.tech/images/flags/gb-eng.svg"
                    },
                    "games": {
                        "appearances": 35,
                        "lineups": 34,
                        "minutes": 2958,
                        "number": 9,
                        "position": "Attacker",
                        "rating": "7.31",
                        "captain": false
                    },
                    "substitutes": {
                        "in": 1,
                        "out": 8,
                        "bench": 2
                    },
                    "shots": {
                        "total": 102,
                        "on": 59
                    },
                    "goals": {
                        "total": 27,
                        "conceded": 0,
                        "assists": 8,
                        "saves": null
                    },
                    "passes": {
                        "total": 380,
                        "key": 25,
                        "accuracy": 65
                    },
                    "tackles": {
                        "total": 15,
                        "blocks": 1,
                        "interceptions": 5
                    },
                    "duels": {
                        "total": 240,
                        "won": 129
                    },
                    "dribbles": {
                        "attempts": 31,
                        "success": 16,
                        "past": null
                    },
                    "fouls": {
                        "drawn": 25,
                        "committed": 24
                    },
                    "cards": {
                        "yellow": 2,
                        "yellowred": 0,
                        "red": 0
                    },
                    "penalty": {
                        "won": null,
                        "commited": null,
                        "scored": 3,
                        "missed": 1,
                        "saved": null
                    }
                }
            ]
        }
    ],
    "meta": {
        "results": 20,
        "page": 1,
        "total_pages": 1
    }
}