Cricket V2 API Overview

​

Base URL

https://api.sportsapipro.com/v2/cricket

​

Authentication

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/cricket/live

​

Cricket-Specific Notes

• Multiple formats — Test (5 days, up to 4 innings), ODI (50 overs/side), T20 (20 overs/side)
• Score format — 185/6 (20) = 185 runs for 6 wickets in 20 overs
• Innings scoring — period1 through period4 (Tests use up to 4, limited-overs use 2)
• Playing XI — 11 players per side, lineups available via match endpoint
• Categories — Cricket-playing nations (Pakistan=1352, New Zealand=1354, Sri Lanka=1356, etc.)
• All out — 10 wickets = innings ends (11 players, 1 stays not out)
• Target — Second team needs first team’s score + 1 to win
• DLS method — Adjusted target in rain-affected matches
• Run rate — Runs scored per over (e.g., 9.25 r/o in T20)

​

Key Cricket Statistics

​

Cricket Formats

​

Endpoint Categories

​

Example Requests

curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/cricket/live

const response = await fetch(
  'https://api.sportsapipro.com/v2/cricket/live',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
);
const data = await response.json();

import requests

response = requests.get(
    'https://api.sportsapipro.com/v2/cricket/live',
    headers={'x-api-key': 'YOUR_API_KEY'}
)
data = response.json()

​

UI Design Ideas

• Scorecard display: Show runs/wickets format: “India 185/6 (20 ov)” — not just a number
• Innings tabs: For Tests, show tabs for each innings (1st Innings, 2nd Innings per team)
• Run rate graph: Use /match/{id}/graph — show required rate vs actual rate for chases
• Playing XI: Use /match/{id}/lineups — show batting order, bowlers, keeper, captain
• Batting & bowling cards: Individual batting (runs, balls, 4s, 6s, SR) and bowling (overs, maidens, runs, wickets, economy)
• Man of the Match: Use /match/{id}/award — always awarded in cricket
• Format indicator: Always show T20/ODI/Test prominently — changes how to interpret scores
• H2H records: Important in rivalries (India vs Pakistan, Ashes) — use /match/{id}/h2h

​

Sport Comparison — Cricket vs Football vs Basketball

​

Real-time updates (WebSocket)

wss://api.sportsapipro.com/v2/cricket/ws?x-api-key=YOUR_API_KEY

{ "action": "subscribe", "channel": "live-scores" }
{ "action": "subscribe", "channel": "match:17013286" }

{
  "channel": "live-scores:cricket",
  "type": "update",
  "data": {
    "eventId": 17013286,
    "homeScore.current": 28,
    "homeScore.innings": {
      "inning1": { "score": 28, "wickets": 0, "overs": 3, "runRate": 9.33 }
    },
    "changes.changeTimestamp": 1789214187
  },
  "source": "nats"
}