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

One leaderboard per series seriesId in the path scopes the table to a single series edition, so statistics from different editions of the same competition are never blended in one response.
Selectable statistic type The required statsType query parameter chooses which leaderboard comes back, with mostRuns as the documented default and the allowed values listed by the series stats filter operation.
Headers plus string rows A headers array names the columns (Batter, M, I, R, SR in the example) and every row is an object with a values array of strings, so a client can build a table without hard-coded column positions.
Leading id in each row In the source example each row begins with a numeric string before the player name, which looks like a player id and gives a hook for linking rows to player operations after you verify it.
Match type filter block The filter.matchtype array carries matchTypeDesc and matchTypeId strings (Test and 1 in the example), which tells a client which format the returned list covers.
Series label in the page metadata The appIndex.seoTitle string in the example starts with the series name and season, giving a ready-made heading for the leaderboard card.
Figures delivered as text Matches, innings, runs and strike rate all arrive as strings, so parse them explicitly before sorting and keep the decimal strike-rate text if you only display it.

Live API Demo

GET /api/project/cricbuzz-cricket/series-get-stats

Request cost is temporarily unavailable. No price is assumed.

View pricing

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'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

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.

Related operations

Guides

View Subscription Plans →