GoSportsAPIDocs
Sign InGet API Key
Football / Players

Get Players

Retrieve player profiles with position, nationality, current team and season statistics.

GET/v1/football/players

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
idintegerOptionalFilter by player ID.
team_idintegerOptionalFilter by team ID.
league_idintegerOptionalFilter by league ID.
seasonintegerOptionalSeason start year for the statistics.
searchstringOptionalSearch by player name (3+ characters).
pageintegerOptionalPage number. Default 1, 50 per page.

Response

  • dataarray<Player>
    Players matching your filters.
  • idinteger
    Unique player ID.
  • namestring
    Player name.
  • positionstring
    Goalkeeper, Defender, Midfielder or Attacker.
  • nationalitystring
    Country the player represents.
  • teamobject
    Current team: id and name.
  • statsobject
    appearances, goals and assists for the season.
  • metaobject
    page, per_page and total.

Status codes

  • 200Players returned
  • 400Invalid parameter
  • 401Missing or invalid API key
  • 429Rate limit reached