Live & Schedule Endpoints (7)
All endpoints use base URL https://v2.cricket.sportsapipro.com.
GET /api/live # Curated live matches
GET /api/live/all # Raw live data
GET /api/today # Today's scheduled matches
GET /api/schedule/:date # Schedule by date (YYYY-MM-DD)
GET /api/live-tournaments # Tournaments with live matches
GET /api/scheduled-tournaments/:date # Tournaments with matches on date
GET /api/newly-added-events # Recently added matches
Response Example — /api/live
{
"events": [
{
"id": 12345678,
"homeTeam": { "id": 4021, "name": "India" },
"awayTeam": { "id": 4022, "name": "Australia" },
"homeScore": {
"current": 287,
"display": 287,
"innings": {
"inning1": { "score": 287, "wickets": 6, "overs": 42.3 },
"inning2": { "score": null, "wickets": null, "overs": null }
}
},
"awayScore": {
"current": 0,
"display": 0,
"innings": {
"inning1": { "score": null, "wickets": null, "overs": null }
}
},
"status": { "code": 21, "description": "1st Innings", "type": "inprogress" },
"tournament": { "name": "IPL", "id": 11156 },
"startTimestamp": 1737331200
}
]
}
Score Fields — Cricket-Specific
| Field | Description |
|---|
innings.inning1.score | Runs scored in 1st innings |
innings.inning1.wickets | Wickets fallen |
innings.inning1.overs | Overs bowled (e.g., 42.3 = 42 overs and 3 balls) |
innings.inning2 | 2nd innings (appears when available) |
current | Current total runs |
Status Codes
| Code | Description |
|---|
| 0 | Not started |
| 21 | 1st Innings |
| 22 | 2nd Innings |
| 23 | 3rd Innings (Test only) |
| 24 | 4th Innings (Test only) |
| 31 | Innings Break |
| 100 | Ended |
Cricket has multiple formats: T20 (20 overs/side, ~3 hours), ODI (50 overs/side, ~8 hours), Test (unlimited overs, up to 5 days). The innings object adapts accordingly.
Search & Discovery Endpoints (7)
GET /api/search?q=india # Search teams, players, tournaments
GET /api/countries # Categories (cricket-playing nations)
GET /api/countries/all # Extended categories
GET /api/categories/:categoryId/tournaments # Tournaments in category
GET /api/trending-players # Trending cricket players
GET /api/news?lang=en # Cricket news
GET /api/country/:code/flag # Country flag URL
Example: Find Live Matches
curl -H "x-api-key: YOUR_API_KEY" \
https://v2.cricket.sportsapipro.com/api/live
Example: Browse IPL Tournaments
curl -H "x-api-key: YOUR_API_KEY" \
"https://v2.cricket.sportsapipro.com/api/categories/1352/tournaments"
