Skip to main content

Players Heatmaps​

This endpoint allows you to retrieve the heatmaps from players. With the help of x, y and value fields you can see the players movement in the field.

For the type argument you can search by: regularSeason, playoffs, overall and top16, but overall is most common type for this endpoint.

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 minute.
Recommended Calls: Limit calls to 1 per minute.

Use Cases​

Get heatmaps coordinates from a specific player_id, league_id, season_id and type
https://football.sportdevs.com/players-heatmaps?player_id=eq.{player_id}&league_id=eq.{league_id}&season_id=eq.{season_id}&type=eq.{type}

Query Parameters
  • player_id integer

    Default value: eq.68421

    The id of the player

  • league_id integer

    Default value: eq.473

    The id of the league

  • season_id integer

    Default value: eq.4389

    The id of the season

  • type text

    Default value: eq.overall

    The type of the heatmaps

  • 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's heatmaps

    Note: This is a Primary Key.

  • player_id integer

    The id of the player

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

  • league_id integer

    The id of the league

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

  • league_name text

    The name of the league

  • league_hash_image character varying

    Possible values: <= 64 characters

    The name image of the league

  • season_id integer

    The id of the season

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

  • season_name text

    The name of the season

  • type text

    The type of the heatmaps

  • matches integer

    The number of the matches

  • points jsonb

    The points of the heatmaps

Loading...