Skip to main content

Players​

This endpoint allows you to retrieve the players.

Multi-language: This feature allows the user to manually change the language of the API response by adding value to the lang attribute. Example: lang=en.

Pagination: The endpoint uses an offset and limit system. Specify the offset and limit parameters to fetch the desired range of results. The maximum and default number of results per request is 50.

Update Period: The endpoint is updated every 15 minutes.
Recommended Calls: Limit calls to 1 every 15 minutes.

You can get the image of the player by calling the following url: https://images.sportdevs.com/{hash_image}.png

Use Cases​

Get players
https://football.sportdevs.com/players

Get players based on the name
https://football.sportdevs.com/players?name=like.*Cristiano*

Get players based on the id
https://football.sportdevs.com/players?id=eq.{id}

Get players from a specific team_id
https://football.sportdevs.com/players?team_id=eq.{team_id}

Query Parameters
  • id integer

    Default value: eq.203610

    The id of the player

  • team_id integer

    Default value: eq.3947

    The id of the team

  • offset string

    Default value: 0

    Limiting and Pagination

  • limit string

    Default value: 50

    Limiting and Pagination

  • lang string

    Default value: en

    Multi-language

Responses

OK

Schema array
  • id integer

    The id of the player

    Note: This is a Primary Key.

  • full_name text

    The name of the player

  • first_name text

    The first name of the player

  • last_name text

    The last name of the player

  • nickname text

    The short name of the player

  • player_position text

    The position of the player

  • player_jersey_number text

    The jersey number of the player

  • player_height integer

    The height of the player

  • preferred_foot text

    The preferred foot of the player

  • country_id integer

    The id of the country

    Note: This is a Foreign Key to countries.id.

  • country_name text

    The name of the country

  • country_hash_image text

    The name image of the country

  • shirt_number integer

    The shirt number of the player

  • date_of_birth timestamp with time zone

    The date of the player's birth

  • market_value integer

    The proposed market value of the player EUR

  • market_currency text

    The proposed market currency

  • hash_image character varying

    Possible values: <= 64 characters

    The name of the image

  • team_id integer

    The id of the team

    Note: This is a Foreign Key to teams.id.

  • team_name text

    The name of the team

  • team_hash_image character varying

    Possible values: <= 64 characters

    The name image of the team

  • retired_status boolean

    Retired

  • cricket_info_id integer

    The info id of the player

Loading...