iSports API – Sports API Documentation & Example Responses for Developers

Player Profile for Search

Thời gian cập nhật: 2026-06-29 15:26

Introduction

• This API endpoint returns detailed player profile information based on a name-based search.

• It supports fuzzy matching and returns multiple records if a player is associated with different teams (e.g., both a club and a national team).

• Use it to retrieve unique recordId or playerId values when the team context is unknown, or to build search suggestions in player-related interfaces.

Related Plans

You can use this api by subscribing plans: Live Data.

Request

Path: /sport/football/player/search
Method: GET
Calls: This interface is limited to 60 seconds/call;
Parameters:

Parameter	Value	Required	Description
name	string	true	Get the data of the specified player name, supporting fuzzy search.

Response

Parameter	Value	Description
recordId	string	Unique identifier for the player-team relationship
playerId	string
name	string	Player name, e.g. Lionel Andres Messi
birthday	string	Birth date, e.g. 1987-06-24
height	int	Player height in cm, e.g. 170
country	string	Primary nationality
feet	string	Preferred foot, e.g. Left, Right, or Both
weight	int	Player weight in kg, e.g. 67
photo	string	Player photo URL. (Note: Recommended to cache and host assets locally).
value	long	Market value in units of 10,000 Euros, e.g. 1500 (represents 15,000,000 Euros).
teamId	string
position	string	Playing position, e.g. Right Winger, Centre Back
number	int	Player jersey number
introduce	string	Player biography or introduction
contractEndDate	string	Contract expiration date, e.g. 2031-06-30
PAC	string	Pace for players or Diving for goalkeepers.
SHO	string	Shooting for players or Handling for goalkeepers.ability
PAS	string	Passing for players or Kicking for goalkeepers.
DRI	string	Dribbling for players or Reflexes for goalkeepers.
DEF	string	Defending for players or Speed for goalkeepers.
PHY	string	Physical for players or Positioning for goalkeepers.
country2	string	Second nationality of the player, if available.
country2Id	int	Unique identifier of the player’s second nationality.

Example Request

Example Response

• This API endpoint returns detailed player profile information based on a name-based search.\n\n • It supports fuzzy matching and returns multiple records if a player is associated with different teams (e.g., both a club and a national team).\n\n • Use it to retrieve unique recordId or playerId values when the team context is unknown, or to build search suggestions in player-related interfaces.

Liên hệ