search
Visit WebsiteLoginCricket Postman

Player Details

hashtag
Player Details

get

hashtag
Get Player Details

This endpoint retrieves detailed information about a specific football player based on their unique identifier (id).

hashtag
Request

  • Method: GET

  • Endpoint: https://apiv3.sportsapi360.com/football/api/v1/player/:id

  • Path Parameter:

    • id (required): The unique identifier of the player whose details are being requested.

hashtag
Response

The response will return a JSON object containing the following fields:

  • status: Indicates the success of the request (boolean).

  • statusCode: A code representing the status of the request (integer).

  • message: A message providing additional information (string).

  • response: An object containing detailed information about the player:

    • id: The unique identifier of the player (integer).

    • name: The full name of the player (string).

    • shortName: The abbreviated name of the player (string).

    • gender: The gender of the player (string).

    • shirtNumber: The player's shirt number (integer).

    • dateOfBirthTimestamp: The timestamp of the player's date of birth (integer).

    • height: The height of the player in centimeters (integer).

    • jerseyNumber: The jersey number worn by the player (string).

    • position: The playing position of the player (string).

    • preferredFoot: The player's preferred foot (string).

    • country: An object containing details about the player's country:

      • alpha2: The two-letter country code (string).

      • alpha3: The three-letter country code (string).

      • name: The name of the country (string).

    • contractUntilTimestamp: The timestamp indicating until when the player is under contract (integer).

    • proposedMarketValue: The proposed market value of the player (integer).

    • team: An object containing details about the player's current team:

      • name: The name of the team (string).

      • shortName: The abbreviated name of the team (string).

      • gender: The gender of the team (string).

      • tournament: An object containing details about the tournament the team is participating in.

      • isLive: Indicates if the team is currently active (boolean).

      • id: The unique identifier of the team (integer).

    • primaryUniqueTournament: An object containing details about the primary tournament associated with the player.

    • about: Additional information about the player (string).

    • nationalTeam: An array of objects representing the player's national team appearances, including:

      • team: An object with details about the national team.

      • appearances: The number of appearances for the national team (integer).

      • goals: The number of goals scored for the national team (integer).

      • debutTimestamp: The timestamp of the player's debut for the national team (integer).

    • transferHistory: An array of objects detailing the player's transfer history, including:

      • player: An object with details about the player.

      • transferFrom: An object with details about the team the player transferred from.

      • transferTo: An object with details about the team the player transferred to.

      • fromTeamName: The name of the team the player transferred from (string).

      • toTeamName: The name of the team the player transferred to (string).

      • type: The type of transfer (integer).

      • transferFee: The fee associated with the transfer (integer).

      • transferFeeDescription: A description of the transfer fee (string).

      • transferDateTimestamp: The timestamp of the transfer date (integer).

      • transferFeeRaw: An object containing the raw transfer fee details.

hashtag
Notes

  • Ensure the id parameter is valid to retrieve the correct player details.

  • The response will provide comprehensive information about the player, including their current team, national team contributions, and transfer history.

Authorizations
HTTPRequired
Path parameters
idintegerRequiredExample: 831005
Header parameters
x-api-keystringOptional
Responses
chevron-right
200

OK

text/plain
Responsestring
get
/football/api/v1/player/{id}
200

OK

hashtag
Player National Team Statistics

get

hashtag
Get Player National Team Statistics

This endpoint retrieves the national team statistics for a specific player identified by their unique ID.

hashtag
Request Method

GET

hashtag
Endpoint

https://apiv3.sportsapi360.com/football/api/v1/player/national-team-statistics/:id

hashtag
Path Parameters

  • id (required): The unique identifier of the player whose national team statistics are being requested.

hashtag
Expected Response Format

The response will be a JSON object containing the following fields:

  • status (boolean): Indicates the success of the request.

  • statusCode (integer): A code representing the status of the response.

  • message (string): A message providing additional context about the response.

  • response (object): An object containing the player's national team statistics, which includes:

    • team (object): Information about the national team, containing:

      • name (string): The full name of the team.

      • shortName (string): The abbreviated name of the team.

      • gender (string): The gender category of the team.

      • nameCode (string): The code representing the name of the team.

      • ranking (integer): The current ranking of the national team.

      • national (boolean): Indicates if the team is a national team.

      • type (integer): The type of the team.

      • id (integer): The unique identifier of the team.

    • appearances (integer): The number of appearances the player has made for the national team.

    • goals (integer): The total number of goals scored by the player for the national team.

    • debutTimestamp (integer): The timestamp of the player's debut for the national team.

Authorizations
HTTPRequired
Path parameters
idintegerRequiredExample: 831005
Header parameters
x-api-keystringOptional
Responses
chevron-right
200

OK

text/plain
Responsestring
get
/football/api/v1/player/national-team-statistics/{id}
200

OK

hashtag
Player Attribute Details

get

hashtag
Endpoint Description

This endpoint retrieves player attribute information for a specific player identified by their unique id. It provides insights into various attributes that define a player's performance, including attacking, technical, tactical, defending, and creativity skills.

hashtag
Request

  • Method: GET

  • URL: https://apiv3.sportsapi360.com/football/api/v1/player/attribute/:id

  • Path Parameter:

    • id (required): The unique identifier of the player whose attributes are being requested.

hashtag
Response

The response is a JSON object containing the following structure:

  • status: A boolean indicating the success of the request.

  • statusCode: A numeric code representing the status of the response.

  • message: A string that may contain additional information about the request.

  • response: An object containing two arrays:

    • playerAttributeOverviews: An array of objects, each representing the attributes of the player. Each object contains:

      • attacking: Numeric value representing the player's attacking skill.

      • technical: Numeric value representing the player's technical skill.

      • tactical: Numeric value representing the player's tactical skill.

      • defending: Numeric value representing the player's defending skill.

      • creativity: Numeric value representing the player's creativity skill.

      • position: A string indicating the player's position on the field.

      • yearShift: A numeric value indicating the year shift for the attributes.

      • id: The unique identifier for the attribute overview.

    • averageAttributeOverviews: An array similar to playerAttributeOverviews, but represents the average attributes across players.

This structure allows clients to easily interpret the player's attributes and compare them with average values.

Authorizations
HTTPRequired
Path parameters
idintegerRequiredExample: 831005
Header parameters
x-api-keystringOptional
Responses
chevron-right
200

OK

text/plain
Responsestring
get
/football/api/v1/player/attribute/{id}
200

OK

hashtag
Player Recent Matches

get

hashtag
Endpoint Description

This endpoint retrieves recent match details for a specific player identified by their unique ID.

hashtag
Request

  • Method: GET

  • URL: https://apiv3.sportsapi360.com/football/api/v1/player/recent/matches/:id

  • Path Parameter:

    • id (required): The unique identifier for the player whose recent matches are being queried.

hashtag
Response

The response will return a JSON object containing the following fields:

  • status (boolean): Indicates the success of the request.

  • statusCode (integer): A code representing the status of the response.

  • message (string): A message providing additional information about the response.

  • response (array): An array of match objects, each containing:

    • tournamentId (integer): The ID of the tournament.

    • id (integer): The unique ID of the match.

    • startTimestamp (integer): The start time of the match in timestamp format.

    • detailId (integer): The detail ID of the match.

    • season (object): Contains information about the season (name, year, ID).

    • roundInfo (object): Provides information about the round of the match.

    • status (object): Contains status information (code, description, type).

    • homeTeam (object): Contains details about the home team (name, short name, gender, etc.).

    • homeScore (object): Contains the score details for the home team.

    • awayTeam (object): Contains details about the away team (name, short name, gender, etc.).

    • awayScore (object): Contains the score details for the away team.

    • time (object): Contains information about the match timing, including injury time.

    • tournament (object): Contains details about the tournament (ID, name, category, etc.).

hashtag
Notes

  • Ensure that the player ID provided in the request is valid to receive accurate match details.

  • The response may include multiple match objects if the player has participated in several recent matches.

Authorizations
HTTPRequired
Path parameters
idintegerRequiredExample: 831005
Header parameters
x-api-keystringOptional
Responses
chevron-right
200

OK

text/plain
Responsestring
get
/football/api/v1/player/recent/matches/{id}
200

OK

hashtag
Player Recent Summary

get

hashtag
Endpoint Description

This endpoint retrieves a summary of recent player performance based on the provided player ID. It is useful for obtaining quick insights into a player's recent activities and performance metrics in various tournaments.

hashtag
Request Format

  • Method: GET

  • URL: https://apiv3.sportsapi360.com/football/api/v1/player/recent/summary/:id

  • Path Parameter:

    • id (required): The unique identifier for the player whose summary is being requested.

hashtag
Response Structure

The response will return a JSON object containing the following fields:

  • status (boolean): Indicates whether the request was successful.

  • statusCode (integer): A code representing the status of the request.

  • message (string): A message providing additional information about the request status.

  • response (object): Contains the following nested properties:

    • summary (array): An array of objects, each representing a summary entry with:

      • type (string): The type of summary entry.

      • timestamp (integer): The time at which the summary entry was recorded.

      • value (string): The value associated with the summary entry.

      • uniqueTournamentId (integer): The unique identifier for the tournament related to the summary entry.

    • uniqueTournamentsMap (object): A mapping of unique tournament IDs to their respective details, including:

      • name (string): The name of the tournament.

      • category (object): Contains details about the tournament category, including:

        • name (string): The name of the category.

        • id (integer): The unique identifier for the category.

        • flag (string): The flag associated with the category.

        • alpha2 (string, optional): The two-letter country code for the category (if applicable).

      • id (integer): The unique identifier for the tournament.

      • displayInverseHomeAwayTeams (boolean): Indicates whether to display home and away teams inversely.

Authorizations
HTTPRequired
Path parameters
idintegerRequiredExample: 831005
Header parameters
x-api-keystringOptional
Responses
chevron-right
200

OK

text/plain
Responsestring
get
/football/api/v1/player/recent/summary/{id}
200

OK

hashtag
Player Season Statistics

get

hashtag
Get Player Season Statistics

This endpoint retrieves the season statistics for a specific player identified by their unique ID. It provides detailed information about the tournaments the player participated in during the specified season.

Request Format

  • Method: GET

  • Endpoint: https://apiv3.sportsapi360.com/football/api/v1/player/season/statistics/:id

  • Path Parameter:

    • id (required): The unique identifier for the player whose statistics are being requested.

Response Structure

The response is a JSON object containing the following fields:

  • status (boolean): Indicates whether the request was successful.

  • statusCode (integer): The status code of the response.

  • message (string): A message providing additional information about the request.

  • response (array): An array containing the player's tournament statistics, with each element including:

    • uniqueTournament: An object with tournament details:

      • name (string): The name of the tournament.

      • category: An object containing:

        • name (string): The name of the category.

        • id (integer): The unique identifier for the category.

        • flag (string): The flag associated with the category.

      • id (integer): The unique identifier for the tournament.

      • displayInverseHomeAwayTeams (boolean): Indicates whether to display home and away teams inversely.

    • seasons (array): An array of objects representing the seasons, each containing:

      • name (string): The name of the season.

      • year (string): The year of the season.

      • id (integer): The unique identifier for the season.

Authorizations
HTTPRequired
Path parameters
idintegerRequiredExample: 831005
Header parameters
x-api-keystringOptional
Responses
chevron-right
200

OK

text/plain
Responsestring
get
/football/api/v1/player/season/statistics/{id}
200

OK

hashtag
Player Statistics

get

hashtag
Get Player Statistics

This endpoint retrieves detailed statistics for a specific football player identified by their unique id.

Request Method

  • GET

Endpoint

  • https://apiv3.sportsapi360.com/football/api/v1/player/statistics/:id

URL Parameters

  • id (required): The unique identifier for the player whose statistics are being requested.

Expected Response Format

The response will return a JSON object containing the following structure:

  • status (boolean): Indicates the success of the request.

  • statusCode (integer): A code representing the status of the response.

  • message (string): A message providing additional information about the response.

  • response (array): An array of player statistics objects, each containing:

    • statistics (object): Detailed statistics for the player, including:

      • accurateCrosses, accurateCrossesPercentage, accurateLongBalls, accurateLongBallsPercentage, accuratePasses, accuratePassesPercentage, aerialDuelsWon, assists, bigChancesCreated, bigChancesMissed, blockedShots, cleanSheet, dribbledPast, errorLeadToGoal, goals, goalsAssistsSum, goalsConceded, interceptions, keyPasses, minutesPlayed, passToAssist, rating, redCards, saves, shotsOnTarget, successfulDribbles, tackles, totalShots, yellowCards, totalRating, countRating, totalLongBalls, totalCross, totalPasses, shotsFromInsideTheBox, appearances, type, id.

    • year (string): The year of the statistics.

    • startYear (integer): The starting year of the statistics.

    • endYear (integer): The ending year of the statistics.

    • team (object): Information about the team, including:

      • name, shortName, gender, nameCode, ranking, national, type, id.

    • uniqueTournament (object): Details about the tournament, including:

      • name, category (object with name, id, flag), id, displayInverseHomeAwayTeams, competitionType.

    • season (object): Information about the season, including:

      • name, year, id.

This endpoint is useful for obtaining comprehensive performance metrics for players in various football competitions.

Authorizations
HTTPRequired
Path parameters
idintegerRequiredExample: 831005
Header parameters
x-api-keystringOptional
Responses
chevron-right
200

OK

text/plain
Responsestring
get
/football/api/v1/player/statistics/{id}
200

OK

hashtag
Player Transfer History

get

hashtag
Endpoint Description

This endpoint retrieves information about a specific player transfer in football by providing the player's unique identifier.

hashtag
Request

  • Method: GET

  • URL: https://apiv3.sportsapi360.com/football/api/v1/player/transfer/:id

  • Path Parameter:

    • id (integer): The unique identifier of the player whose transfer details are being requested.

hashtag
Response

The response will return a JSON object containing the following structure:

  • status (boolean): Indicates the success of the request.

  • statusCode (integer): A code representing the status of the response.

  • message (string): Any additional message regarding the request.

  • response (array): An array containing transfer details for the player. Each object in the array includes:

    • player (object): Information about the player involved in the transfer.

      • name (string): The full name of the player.

      • shortName (string): The abbreviated name of the player.

      • position (string): The playing position of the player.

      • jerseyNumber (integer): The jersey number of the player.

      • sofascoreId (string): The unique identifier for the player in the SofaScore database.

      • id (integer): The unique identifier of the player.

    • transferFrom (object): Details about the team the player is transferring from.

      • name (string): Name of the team.

      • shortName (string): Abbreviated name of the team.

      • gender (string): Gender of the team (if applicable).

      • nameCode (string): Code representing the team name.

      • disabled (boolean): Indicates if the team is disabled.

      • national (boolean): Indicates if the team is a national team.

      • type (integer): Type of the team.

      • id (integer): Unique identifier of the team.

    • transferTo (object): Details about the team the player is transferring to.

      • Same structure as transferFrom.

    • fromTeamName (string): The name of the team the player is leaving.

    • toTeamName (string): The name of the team the player is joining.

    • type (integer): The type of transfer.

    • transferFee (float): The fee associated with the transfer.

    • transferFeeDescription (string): Description of the transfer fee.

    • id (integer): Unique identifier for the transfer record.

    • transferDateTimestamp (integer): The timestamp of the transfer date.

    • transferFeeRaw (object): Raw details of the transfer fee.

      • value (float): The numerical value of the transfer fee.

      • currency (string): The currency in which the transfer fee is denominated.

This endpoint is useful for obtaining detailed information about a player's transfer history, including the teams involved and financial details.

Authorizations
HTTPRequired
Path parameters
idintegerRequiredExample: 831005
Header parameters
x-api-keystringOptional
Responses
chevron-right
200

OK

text/plain
Responsestring
get
/football/api/v1/player/transfer/{id}
200

OK

hashtag
Player Tournament Season Statistics

get

hashtag
Get Player Tournament Season Statistics

This endpoint retrieves the statistical data for a specific player in a given tournament and season. It provides detailed performance metrics that can be used for analysis or reporting purposes.

hashtag
Request Method

GET

hashtag
Endpoint URL

https://apiv3.sportsapi360.com/football/api/v1/player/:id/tournament/:tid/season/:sid/statistics

hashtag
Request Parameters

  • id (path parameter): The unique identifier of the player whose statistics are being requested.

  • tid (path parameter): The unique identifier of the tournament for which the statistics are being fetched.

  • sid (path parameter): The unique identifier of the season during which the statistics are recorded.

hashtag
Additional Notes

  • The status field indicates whether the request was successful.

  • The statusCode provides further information about the request's outcome.

  • The response object contains two main sections: statistics, which includes detailed performance metrics, and team, which provides information about the player's team.

Authorizations
HTTPRequired
Path parameters
idintegerRequiredExample: 831005
tidintegerRequiredExample: 7
sidintegerRequiredExample: 61644
Header parameters
x-api-keystringOptional
Responses
chevron-right
200

OK

text/plain
Responsestring
get
/football/api/v1/player/{id}/tournament/{tid}/season/{sid}/statistics
200

OK

PreviousCompetition DetailsNextTeam Details

Last updated