Players

List/search players

Returns a paginated list of players (biographical fields only, no stats) with optional name search and filters by team, league, season, position, and nationality. The data payload is the players array itself.

Plan: Available on the free plan.

get/players

Request

  • Base URL: https://footballdata.io/api/v1
  • URL: https://footballdata.io/api/v1/players
  • Auth: HTTP bearer

Query parameters

searchstring

Free-text name search (LIKE) across player_name, first/last/known/short name.

team_idinteger

Filter to players with season stats for this team (forces a player_season_stats join).

league_idinteger

Filter to players with season stats in this league.

season_idinteger

Filter to players with season stats in this season.

positionstring

Filter by exact position_name.

nationalitystring

Filter by exact nationality.

pageinteger

Page number (min 1).

limitinteger

Results per page, clamped between 1 and 100.

Response

Successful response

successboolean
metaMeta

Request metadata: usage counters, plan access, and pagination when applicable.

Example response

{
  "success": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.