Cricket APIs: Match Ball-by-Ball API

Match Ball-by-Ball API

What is the Match Ball-by-Ball API?

How Does It Work?

What you get?

• Over-by-Over Updates: Access ball-by-ball commentary on an over-by-over basis, allowing your users to stay updated with every moment of the game.

• Easy Access: Make HTTP REST calls to the API with straightforward URL structures and parameters. Integration is a breeze, allowing you to focus on providing valuable content to your users.

• Real-Time Updates: Keep your users engaged with real-time cricket updates. Whether it's live scores, wicket details, or player performance, the Match Ball-by-Ball API enriches your app with exciting content.

Making Your First API Call

• URL Syntax: The API's base URL is https://api.sports.roanuz.com. To access ball-by-ball data, you'll use the following endpoints:
  • /v5/cricket/proj_key/match/key/ball-by-ball/ for retrieving ball-by-ball updates for a specific match.
  • /v5/cricket/proj_key/match/key/ball-by-ball/over_key/ for fetching ball-by-ball data for a specific over.
  • /v5/cricket/proj_key/match/key/ball-by-ball/FIRST-OVER/ to access data for the first over.
• URL Parameters:
  • proj_key (String, Required): Your Production or Sandbox Project Key.
  • key (String, Required): The match key for which you need ball-by-ball information.
  • over_key (Optional): The key of the over for specific over details.
  • first_over (Optional): Include this parameter to fetch ball-by-ball information for the first over of the match.
• Header Parameters:
  • rs-token (String, Required): This token is needed to access the API. You can generate a new token using the Auth API.

pythonCopy code
import requests

project_key = 'YOUR_PROJ_KEY'
token = 'YOUR_ACCESS_TOKEN'
key = 'rsaeng_2020_t20_03'
url = "https://api.sports.roanuz.com/v5/cricket/<span class="highlight highlight-object">/match/{}</span>/ball-by-ball/".format(project_key, key)

headers = {
    'rs-token': token
}
response = requests.get(url, headers=headers)

print(response.json())

Simplified Data Schema

What more can you do with Match Ball-by-Ball API?

Ball-by-Ball Commentary

Access the Latest Over Information

Access the First Over

Crawling Through Overs

Handling API Responses

• 400 - Invalid input to process
• 400 - Invalid Page Key provided
• 401 - Invalid access token to process
• 402 - Project is inactive
• 403 - Access is limited to specific user groups
• 404 - Resource not found
• 404 - Not supported for the requested Metric Group
• 500 - Unknown error

Caching for Improved Performance

• cache.key: The key or ID recommended for caching a response.
• cache.expires: The recommended duration for caching the data.

Use Cases for Your Cricket App

• Live Scoreboards: Provide real-time match updates to engage your users.
• In-Depth Analysis: Offer insights into player performance, wickets, and key moments.
• Match Highlights: Create highlights with detailed commentary to relive the action.
• Custom Widgets: Build widgets for websites or mobile apps, keeping users informed.

Wrapping Up