Get match-specific batter-versus-bowler matchup stat cards for a cricket match.
View all Cricket Live Scores, Scorecards & Stats API endpoints →Retrieve match-specific batter-versus-bowler matchup cards for one cricket match. The only input is the required numeric path parameter matchId, taken from the matchId field returned by the match list, schedule, series match, team schedule, team result or venue match endpoints. The supplied default is 151543. No response was observed for this operation in the supplied probe evidence, so the fields below come from a truncated, unverified source example and are documented illustrations, not a verified contract. The example returns a cards array. Each card has cardHeading (for example a venue, opposition or player-versus-player title), cardLabel (a format label such as ODIs), cardType (playerStatsCard), playerOneImageId, playerTwoImageId and a subCard array. Each subCard entry has a subCardHeading naming a player and a stats array of label and value pairs, with every value returned as a string. Illustrated stat labels include Matches, Innings, Runs, Highest, Average, 100s, 50s, 0s, Wickets, Best figures, Economy, Strike-rate and 4-fers on the venue and opposition cards, and Runs scored, Balls faced and Dismissals on the player-versus-player card. The example is cut off inside that last card, so any further fields are not documented. The cards are match-scoped research context, not a complete all-time head-to-head record, a prediction or a fantasy points total, and availability depends on coverage for the chosen match.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/cricbuzz-cricket/fantasy-get-matchups API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/fantasy-get-matchups?key=<API_KEY>&matchId=151543'
Query Result
Use Cases
- Build a match-specific batter-versus-bowler comparison worksheet for analysts, with one table per card heading and one column per player.
- Add a matchup panel next to player profiles, keeping this match scope distinct from a claim of complete all-time head-to-head history.
- Render a pre-match key-battles carousel in a fantasy research app by looping over cards and showing each subCardHeading with its stats list.
- Draft preview-article notes by pulling the venue and opposition stat cards for the players named in an upcoming fixture.
- Flatten the label and value pairs into rows keyed by matchId, card heading and player to compare batters by Average and bowlers by Economy in a notebook.
Frequently asked questions
Which matchId do I pass?
Use the matchId field returned by the match list, match schedule, series match, team schedule, team result or venue match endpoints. It is a required numeric path value, and 151543 is the supplied default.
What does the response contain?
The source example shows a cards array. Each card has a heading, a format label, a card type, two player image IDs and a subCard list of players, each with a stats array of label and value pairs. The example is truncated, so treat any field beyond those as undocumented.
Were these fields observed in a probe?
No response was observed for this operation in the supplied probe evidence, so the fields are documented illustrations from a truncated source example rather than a verified contract. Validate the live shape with your own request before relying on it.
Is this a complete all-time head-to-head record?
No. The endpoint is described as batter-versus-bowler matchups for a match. The example cards are scoped to a venue, an opposition and a player pairing, so use them as match research context and do not present them as a full career comparison.
Are the stat values numbers?
In the example every value is a string, and some carry a suffix such as an asterisk on a Highest score. Parse values defensively and keep the original text for display.
Does it return fantasy points, odds or predictions?
No such fields appear in the example. The cards hold historical-style stat labels only, so do not describe the output as points projections, betting odds or a guaranteed result.
What if a match has no matchup data?
The documentation does not state how a match without coverage is represented. Build the client to handle an empty cards array or an empty response and show a neutral no-data message.