Team Data API

Team Short Info

get

Get Team Information

This endpoint retrieves detailed information about a specific cricket team based on the provided teamId.

Request

  • Method: GET

  • URL: https://apiv3.sportsapi360.com/cricket/api/v2/team/info/:teamId

  • Path Parameters:

    • teamId (string): The unique identifier of the cricket team whose information is being requested.

Response

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 response.

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

  • response (object): Contains detailed information about the team:

    • teamID (string): The unique identifier for the team.

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

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

    • description (string): A brief description of the team.

    • image (string): A URL link to an image representing the team.

This endpoint is useful for applications that need to display cricket team information, allowing users to access details about their favorite teams.

Authorizations
HTTPRequired
Path parameters
teamIdstringRequired
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
chevron-right
200

OK

application/json
Responseobject
get
/cricket/api/v2/team/info/{teamId}
200

OK

Team Info Full

get

Get Team Information

This endpoint retrieves detailed information about a specific cricket team identified by the teamId parameter.

Request Type

  • HTTP Method: GET

API Version

  • Version: v2

Endpoint

  • URL: https://apiv3.sportsapi360.com/cricket/api/v2/team/:teamId

Request Parameters

  • teamId (path parameter):

    • Type: String

    • Description: The unique identifier for the cricket team whose information is being requested.

    • Example: 12345

Expected Responses

  • 200 OK: Returns the detailed information of the requested cricket team.

    • Response Body: Contains team details such as:

      • name: The name of the cricket team.

      • players: A list of players in the team.

      • statistics: Various statistics related to the team.

    • {"name": "Team A","players": [ {"name": "Player 1", "role": "Batsman"}, {"name": "Player 2", "role": "Bowler"}],"statistics": { "matchesPlayed": 100, "wins": 70, "losses": 30}}

  • 404 Not Found: The specified teamId does not correspond to any existing cricket team.

    • Response Body: An error message indicating that the team was not found.

    • {"error": "Team not found"}

  • 401 Unauthorized: Authentication credentials are missing or invalid.

    • Response Body: An error message indicating authentication failure.

    • {"error": "Authentication failed"}

Authentication

Ensure that you include the appropriate authentication headers in your request to access this endpoint.

Headers

  • Include necessary headers as required by your authentication method (e.g., API Key, Bearer Token).

Authorizations
HTTPRequired
Path parameters
teamIdstringRequired
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
chevron-right
200

OK

application/json
Responseobject
get
/cricket/api/v2/team/{teamId}
200

OK

Team Recent

get

Endpoint Description

This endpoint retrieves the recent match details for a specified cricket team. It provides comprehensive information about the team's performance across different formats of the game, including One Day Internationals (ODI), Twenty20 (T20), and Test matches. This data can be useful for fans, analysts, and teams to assess recent performances and trends.

Request

  • Method: GET

  • URL: https://apiv3.sportsapi360.com/cricket/api/v2/team/:teamId/recent

  • Path Parameters:

    • teamId (string): The unique identifier of the cricket team whose information is being requested.

Expected Response

The response will return a JSON object structured as follows:

  • odi: An object containing the recent ODI match details.

    • winLost: An array indicating the win/loss status for the matches.

    • scoreCard: An array of scorecard objects for each ODI match, which includes:

      • win: Indicates if the team won the match.

      • matchName: The name of the match.

      • matchNumber: The match number in the series.

      • startDate: The date when the match started.

      • matchStatus: The current status of the match (e.g., ongoing, completed).

      • winningTeamID: The ID of the team that won the match.

      • isLiveCriclyticsAvailable: A boolean indicating if live Criclytics data is available for the match.

      • matchType: The type of match (e.g., ODI).

      • venue: The venue where the match was held.

      • matchResult: The final result of the match.

      • matchID: The unique identifier for the match.

      • matchScore: An array containing details about the teams and their scores, including:

        • teamShortName: The short name of the team.

        • teamID: The unique identifier for the team.

        • teamFullName: The full name of the team.

        • teamScore: An array of objects providing score details for each inning, which includes:

          • inning: The inning number.

          • inningNumber: The specific number of the inning.

          • battingTeam: The name of the batting team.

          • runsScored: The total runs scored in that inning.

          • wickets: The number of wickets lost.

          • overs: The total overs faced.

          • runRate: The run rate achieved.

          • battingSide: The side that was batting.

          • battingTeamShortName: The short name of the batting team.

          • declared: A boolean indicating if the inning was declared.

          • folowOn: A boolean indicating if the follow-on rule was applied.

  • t20: Similar structure as the ODI section, but for T20 matches.

  • test: Similar structure as the ODI section, but for Test matches.

Notes

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

  • The response includes detailed score information for each match, which can be useful for analyzing team performance over recent games.

  • This endpoint is particularly useful for sports analysts and fans looking to track the performance of their favorite teams over time.

Authorizations
HTTPRequired
Path parameters
teamIdstringRequired
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
chevron-right
200

OK

application/json
Responseobject
get
/cricket/api/v2/team/{teamId}/recent
200

OK

Team Schedule Matches

get

Get Recent Matches for a Cricket Team

This endpoint retrieves the recent match details for a specific cricket team identified by the teamId parameter.

Request

  • Method: GET

  • URL: https://apiv3.sportsapi360.com/cricket/api/v2/team/:teamId/schedule

Path Parameters

  • teamId (string): The unique identifier for the cricket team whose recent matches you want to fetch.

Response

The response will be a JSON array containing objects with the following fields:

  • matchID (string): The unique identifier for the match.

  • matchDateTimeIST (string): The date and time of the match in IST.

  • matchStatus (string): The current status of the match (e.g., scheduled, completed).

  • compType (string): The type of competition (e.g., league, tournament).

  • awayTeamID (string): The unique identifier for the away team.

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

  • homeTeamID (string): The unique identifier for the home team.

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

Notes

  • Ensure that the teamId provided is valid to receive accurate match details.

  • The response may contain multiple match objects, depending on the number of recent matches played by the team.

Authorizations
HTTPRequired
Path parameters
teamIdstringRequired
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
chevron-right
200

OK

application/json
Responseobject
get
/cricket/api/v2/team/{teamId}/schedule
200

OK

Team Stats

get

API Endpoint: Get Team Statistics

Request Method

GET

Endpoint

https://apiv3.sportsapi360.com/cricket/api/v2/team/:teamId/stats

Parameters

  • teamId (path parameter): The unique identifier for the cricket team whose statistics are being requested.

Expected Response Format

The response will return a JSON object containing various statistics for the specified cricket team, structured as follows:

  • image: A string representing the team's image URL (if available).

  • teamID: A string representing the unique identifier for the team.

  • teamName: A string representing the full name of the team.

  • teamShortName: A string representing the abbreviated name of the team.

  • odi: An object containing One Day International statistics:

    • matchesWon: Number of matches won.

    • matchesLost: Number of matches lost.

    • matchesPlayed: Total matches played.

    • matchesTied: Number of matches tied.

    • winPercentage: Win percentage.

    • mostRuns: An object detailing the player with the most runs, including:

      • playerName: Name of the player.

      • playerID: Unique identifier for the player.

      • matchesPlayed: Matches played by the player.

      • runs: Total runs scored by the player.

      • average: Batting average of the player.

    • mostWickets: An object detailing the player with the most wickets, including:

      • playerName: Name of the player.

      • playerID: Unique identifier for the player.

      • matchesPlayed: Matches played by the player.

      • wicket: Total wickets taken by the player.

      • economy: Economy rate of the player.

    • bestScore: An object detailing the player's best score, including:

      • playerName: Name of the player.

      • playerID: Unique identifier for the player.

      • matchesPlayed: Matches played by the player.

      • runs: Runs scored in the best innings.

      • average: Batting average of the player.

    • bestFigures: An object detailing the player's best bowling figures, including:

      • playerName: Name of the player.

      • playerID: Unique identifier for the player.

      • matchesPlayed: Matches played by the player.

      • runs: Runs conceded in the best bowling performance.

      • average: Bowling average of the player.

  • test: An object containing Test match statistics with the same structure as odi.

  • t20: An object containing T20 match statistics with the same structure as odi.

This endpoint provides a comprehensive overview of a cricket team's performance across different formats of the game.

Authorizations
HTTPRequired
Path parameters
teamIdstringRequired
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
chevron-right
200

OK

application/json
Responseobject
get
/cricket/api/v2/team/{teamId}/stats
200

OK

Team Squads

get

Get Team Squads

This endpoint retrieves the squad details for a specific cricket team identified by the teamId. It provides information on the players in three formats: One Day Internationals (ODI), Test matches, and Twenty20 (T20) formats.

Request

Method: GET Endpoint: https://apiv3.sportsapi360.com/cricket/api/v2/team/:teamId/squads

Path Parameters

  • teamId (string): The unique identifier for the cricket team whose squad details are being requested.

Response Fields

  • odiSquad: An array of players representing the ODI squad, where each player has:

    • playerID: Unique identifier for the player.

    • playerName: Name of the player.

    • playerImage: URL to the player's image.

  • testSquad: An array of players representing the Test squad, with the same structure as odiSquad.

  • t20Squad: An array of players representing the T20 squad, also with the same structure as odiSquad.

This endpoint is useful for obtaining the current squad composition for a team across different formats of the game.

Authorizations
HTTPRequired
Path parameters
teamIdstringRequired
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
chevron-right
200

OK

application/json
Responseobject
get
/cricket/api/v2/team/{teamId}/squads
200

OK

Last updated