Get a cricket series statistics leaderboard by seriesId and statsType, such as the default mostRuns table, as a headers array plus player rows
View all Cricket Live Scores, Scorecards & Stats API endpoints →Returns the statistics leaderboard for one cricket series. Send seriesId in the URL path (required number; the default 3718 is the documented example value) and statsType as a required query string (the default mostRuns is the documented example value). Both values come from other operations of this product: seriesId is the id field returned by the series list or series archive operations, and statsType is the value field returned by the series stats filter operation. The source 200 example is an object with an appIndex object (seoTitle and webURL strings), a filter object whose matchtype array lists matchTypeDesc and matchTypeId strings (a single Test entry in the example) and a testStatsList object with a headers array (Batter, M, I, R, SR) and a values array. Each element of values is an object that holds its own values array of strings: in the example the first string looks like a numeric player id, the second is the player name, and the strings after that line up with the columns that follow the Batter header, so a row carries one more string than headers has entries. The example lists fifteen rows for the Plunket Shield 2021-22 series. No live probe was recorded for this endpoint, so every response field described here comes from the source example and is not independently verified. The supplied evidence does not show how the list object, its headers or the matchtype filter change for other statsType values, and coverage depends on the series.
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/series-get-stats API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/series-get-stats?key=<API_KEY>&seriesId=3718&statsType=mostRuns'
Query Result
Use Cases
- Build a top run-scorers leaderboard for a domestic tournament page from the headers array and the player rows of the default mostRuns table.
- Populate a statistic selector by calling the series stats filter operation first, then requesting each statsType value with the same seriesId.
- Link every leaderboard row to a player profile by taking the leading id string of the row, after checking it against the player search or series players results.
- Keep exports edition-safe by storing seriesId next to each saved row, so Plunket Shield 2021-22 figures are not merged with another season's table.
- Write a mid-tournament editorial note that quotes the top three batters by runs and strike rate, converting the string figures to numbers in your own code first.
Frequently asked questions
What does the series stats operation return?
It returns an appIndex object, a filter object with a matchtype array, and a statistics list (testStatsList in the example) made of a headers array and a values array of player rows, according to the source 200 example. No live probe was recorded, so these fields come from the source example and are not independently verified.
Which parameters does it take?
seriesId is required, goes in the URL path as a number and defaults to 3718. statsType is required, goes in the query string as a string and defaults to mostRuns. No other parameters are documented.
Where do I get a seriesId and a statsType?
Take seriesId from the id field of the series list or series archive operations. Take statsType from the value field returned by the series stats filter operation, and pass it back unchanged.
How do I read the headers and values arrays?
In the example, headers is Batter, M, I, R, SR and each entry of values holds a values array of six strings. The first string looks like a player id, the second is the player name, and the remaining four follow the M, I, R and SR columns in order, so a row has one more string than headers has entries.
Are the figures numbers or strings?
Strings. Every item in a row, including runs and strike rate, is delivered as text. Convert them explicitly before sorting or averaging, and decide how your client treats a missing or placeholder value.
What changes when statsType is not mostRuns?
The supplied evidence only shows the default mostRuns response, so the name of the list object, its headers and the filter contents for other statsType values are not documented here. Call the series stats filter operation to see the valid values, then compare the responses for your own series.
Is this a global player ranking?
No. The table is limited to the one series named by seriesId, and the same statsType can return different leaders for a different series. Use the ranking operations of this product for format-wide player rankings.
Can a series return no statistics?
Coverage depends on the series, and the supplied evidence documents only a populated 200 example. Handle an empty or missing list in your client rather than assuming every seriesId returns fifteen rows.