Commentery

Match Commentary

get

Get Match Commentary

This endpoint retrieves the commentary for a specific cricket match based on the match ID provided. It delivers detailed information about each ball played in the innings, including commentary, runs scored, and wicket details.

Request Method

  • GET

Request Endpoint

  • https://apiv3.sportsapi360.com/cricket/api/v2/match/:matchId/commentary?id=202200

Request Parameters

  • matchId (path parameter): The unique identifier of the match for which commentary is being requested.

  • id (query parameter): A specific identifier to retrieve next commentary details.

Response Structure

The response is returned in JSON format and contains an array of commentary objects, each including the following fields:

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

  • over (string): The over number in which the ball was bowled.

  • ballType (string): The type of ball bowled.

  • type (string): The type of commentary.

  • isBall (boolean): Indicates if the entry is related to a ball.

  • runs (string): The runs scored on that ball.

  • zad (string): Additional data related to the ball.

  • bowlerName (string): The name of the bowler.

  • batsmanName (string): The name of the batsman.

  • battingStyle (string): The batting style of the batsman.

  • commentary (string): The commentary related to the ball.

  • wicket (boolean): Indicates if a wicket fell on that ball.

  • isLastBall (boolean): Indicates if this is the last ball of the over.

  • batsmanID (string): The ID of the batsman.

  • bowlerID (string): The ID of the bowler.

  • innings (string): The innings identifier.

This endpoint is crucial for accessing live commentary during a cricket match, enhancing the experience for fans and analysts alike.

Authorizations
HTTPRequired
Path parameters
matchIdstringRequired
Query parameters
idintegerOptionalExample: 0
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
200

OK

application/json
Responseobject
get
/cricket/api/v2/match/{matchId}/commentary
200

OK

Match Commentary BallByBall

get

Get Ball-by-Ball Commentary for a Match

This endpoint retrieves detailed ball-by-ball commentary for a specific cricket match during a given innings. It provides insights into each ball bowled, including commentary, runs scored, and any wickets that may have fallen.

Request Method

  • GET

Request Endpoint

  • https://apiv3.sportsapi360.com/cricket/api/v2/match/:matchId/commentary/ballByBall?innings=2

Request Parameters

  • matchId (path parameter):

    • The unique identifier of the match for which commentary is being requested.

  • innings (query parameter):

    • Indicates the innings number (e.g., 1 for the first innings, 2 for the second innings).

Response Structure

The response is returned in JSON format and contains 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, if any.

  • response (array):

    • An array containing commentary details for each ball, structured as follows:

      • Each element is an array that may include various details related to the ball.

Notes

  • The endpoint is essential for accessing real-time commentary and enhances the viewing experience for cricket fans by providing detailed insights into each ball bowled.

  • Ensure that the matchId and innings parameters are correctly specified to retrieve the desired commentary.

Authorizations
HTTPRequired
Path parameters
matchIdstringRequired
Query parameters
inningsintegerOptional

1 to 10

Example: 2
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
200

OK

application/json
Responseobject
get
/cricket/api/v2/match/{matchId}/commentary/ballByBall
200

OK

Match Highlights

get

Get Match Highlights

This endpoint retrieves the highlights of a specific cricket match for a given innings. It provides detailed information about each ball played in the innings, including commentary, runs scored, and wicket details.

Request Parameters

  • matchId (path parameter): The unique identifier of the match for which highlights are being requested.

  • innings (query parameter): Indicates the innings number (e.g., 1 for the first innings).

Response Structure

The response is returned in JSON format and contains 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, if any.

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

    • matchID (string): The ID of the match.

    • ballID (string): The ID of the specific ball.

    • ballNumber (string): The number of the ball in the innings.

    • innings (string): The innings identifier.

    • over (string): The over number in which the ball was bowled.

    • overNumber (string): The sequential number of the over.

    • commentary (string): Commentary related to the ball.

    • teamID (string): The ID of the team involved.

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

    • runs (string): The runs scored on that ball.

    • xCoordinate (integer): The x-coordinate related to the ball's delivery.

    • yCoordinate (integer): The y-coordinate related to the ball's delivery.

    • zad (string): Additional data related to the ball.

    • wicket (boolean): Indicates if a wicket fell on that ball.

This endpoint is essential for accessing detailed match highlights and can be used to enhance the viewing experience for cricket fans.

Authorizations
HTTPRequired
Path parameters
matchIdstringRequired
Query parameters
inningsintegerOptional

1 to 10

Example: 1
Header parameters
x-api-keystringOptionalExample: {API_KEY}
Responses
200

OK

application/json
Responseobject
get
/cricket/api/v2/match/{matchId}/highlights
200

OK

Last updated