Players

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

Players with their season statistics.

Freshness — cached for 1 hour. Repeating the same query inside that window is answered from cache in single digit milliseconds, and meta.cache reads HIT.

Query parameters

NameTypeExampleDescription
idinteger101359Identifier of a single record.
teaminteger100005Team identifier.
competitioninteger100090Competition identifier, from the competitions endpoint.
seasoninteger2026Season, as a four digit start year.
searchstringmanchesterPartial name search. Minimum three characters.
pageinteger1Page number of the result set.

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?id=101359' \
--header 'Accept: application/json' \
--header 'X-API-Key: api_mart_your_key_here'

Response

json
{
    "success": true,
    "data": [
        {
            "id": 100047,
            "name": "Neymar",
            "firstname": "Neymar",
            "lastname": "da Silva Santos Júnior",
            "age": 33,
            "birth": {
                "date": "1992-02-05",
                "place": "Mogi das Cruzes",
                "country": "Brazil"
            },
            "nationality": "Brazil",
            "height": "175",
            "weight": "68",
            "is_injured": false,
            "photo": "https://apinex.iotait.tech/images/players/100047.png",
            "statistics": [
                {
                    "team": {
                        "id": 100048,
                        "name": "Santos",
                        "logo": "https://apinex.iotait.tech/images/teams/100048.png"
                    },
                    "competition": {
                        "id": 100049,
                        "name": "Paulista - A1",
                        "season": 2025,
                        "country": "Brazil",
                        "logo": "https://apinex.iotait.tech/images/competitions/100049.png",
                        "flag": "https://apinex.iotait.tech/images/flags/br.svg"
                    },
                    "games": {
                        "appearances": 7,
                        "lineups": 6,
                        "minutes": 507,
                        "number": null,
                        "position": "Attacker",
                        "rating": "7.300000",
                        "captain": false
                    },
                    "substitutes": {
                        "in": 1,
                        "out": 5,
                        "bench": 2
                    },
                    "shots": {
                        "total": 6,
                        "on": 2
                    },
                    "goals": {
                        "total": 3,
                        "conceded": 0,
                        "assists": 0,
                        "saves": null
                    },
                    "passes": {
                        "total": 85,
                        "key": 6,
                        "accuracy": null
                    },
                    "tackles": {
                        "total": null,
                        "blocks": null,
                        "interceptions": 1
                    },
                    "duels": {
                        "total": 37,
                        "won": 19
                    },
                    "dribbles": {
                        "attempts": 17,
                        "success": 10,
                        "past": null
                    },
                    "fouls": {
                        "drawn": 9,
                        "committed": 4
                    },
                    "cards": {
                        "yellow": 1,
                        "yellowred": 0,
                        "red": 0
                    },
                    "penalty": {
                        "won": null,
                        "commited": null,
                        "scored": 0,
                        "missed": 0,
                        "saved": null
                    }
                },
                {
                    "team": {
                        "id": 100048,
                        "name": "Santos",
                        "logo": "https://apinex.iotait.tech/images/teams/100048.png"
                    },
                    "competition": {
                        "id": 100050,
                        "name": "Serie A",
                        "season": 2025,
                        "country": "Brazil",
                        "logo": "https://apinex.iotait.tech/images/competitions/100050.png",
                        "flag": "https://apinex.iotait.tech/images/flags/br.svg"
                    },
                    "games": {
                        "appearances": 20,
                        "lineups": 17,
                        "minutes": 1535,
                        "number": 10,
                        "position": "Attacker",
                        "rating": "7.37",
                        "captain": false
                    },
                    "substitutes": {
                        "in": 3,
                        "out": 6,
                        "bench": 3
                    },
                    "shots": {
                        "total": 45,
                        "on": 25
                    },
                    "goals": {
                        "total": 8,
                        "conceded": 0,
                        "assists": 1,
                        "saves": null
                    },
                    "passes": {
                        "total": 748,
                        "key": 50,
                        "accuracy": null
                    },
                    "tackles": {
                        "total": 7,
                        "blocks": null,
                        "interceptions": 3
                    },
                    "duels": {
                        "total": 228,
                        "won": 114
                    },
                    "dribbles": {
                        "attempts": 69,
                        "success": 32,
                        "past": null
                    },
                    "fouls": {
                        "drawn": 69,
                        "committed": 22
                    },
                    "cards": {
                        "yellow": 6,
                        "yellowred": 1,
                        "red": 0
                    },
                    "penalty": {
                        "won": null,
                        "commited": 1,
                        "scored": 2,
                        "missed": 0,
                        "saved": null
                    }
                },
                {
                    "team": {
                        "id": 100048,
                        "name": "Santos",
                        "logo": "https://apinex.iotait.tech/images/teams/100048.png"
                    },
                    "competition": {
                        "id": 100051,
                        "name": "Copa Do Brasil",
                        "season": 2025,
                        "country": "Brazil",
                        "logo": "https://apinex.iotait.tech/images/competitions/100051.png",
                        "flag": "https://apinex.iotait.tech/images/flags/br.svg"
                    },
                    "games": {
                        "appearances": 1,
                        "lineups": 0,
                        "minutes": 24,
                        "number": 10,
                        "position": "Attacker",
                        "rating": "7.6",
                        "captain": false
                    },
                    "substitutes": {
                        "in": 1,
                        "out": 0,
                        "bench": 1
                    },
                    "shots": {
                        "total": 2,
                        "on": 1
                    },
                    "goals": {
                        "total": 0,
                        "conceded": 0,
                        "assists": 0,
                        "saves": null
                    },
                    "passes": {
                        "total": 17,
                        "key": 4,
                        "accuracy": null
                    },
                    "tackles": {
                        "total": null,
                        "blocks": null,
                        "interceptions": null
                    },
                    "duels": {
                        "total": 5,
                        "won": 2
                    },
                    "dribbles": {
                        "attempts": 3,
                        "success": null,
                        "past": null
                    },
                    "fouls": {
                        "drawn": 1,
                        "committed": null
                    },
                    "cards": {
                        "yellow": 0,
                        "yellowred": 0,
                        "red": 0
                    },
                    "penalty": {
                        "won": null,
                        "commited": null,
                        "scored": 0,
                        "missed": 0,
                        "saved": null
                    }
                }
            ]
        }
    ],
    "meta": {
        "results": 1,
        "page": 1,
        "total_pages": 1
    }
}