Get ICC cricket rankings by category (batsmen, bowlers, allrounders or teams), format (Test, ODI or T20) and men's or women's table

View all Cricket Live Scores, Scorecards & Stats API endpoints →

Returns an ICC ranking table. Send category in the URL path (required string: batsmen, bowlers, allrounders or teams; default batsmen) and formatType in the query string (required string: test, odi or t20; default t20). Add isWomen=1 to request the women's table; the parameter notes say that with isWomen set to 1 there is no odi table. The response is an object with a rank array and an appIndex object (seoTitle and webURL strings). A live probe with category batsmen and formatType t20 returned HTTP 200 with that shape, 15 entries in rank, and string values for the ranking fields. The observed and source-example entries carry id, rank, name, country, countryId, faceImageId, rating, points, lastUpdatedOn (a YYYY-MM-DD date) and trend (Flat, Up or Down). An integer difference field, a signed change such as 1 or -2 in the source example, appears only on some entries. Ranks are strings and can tie: the source example gives two players rank 5 and then continues at 7. The example seoTitle mentions a top 100 list, but the example and the probe each show 15 entries, so the list length is not documented as fixed. Only the batsmen and t20 combination was probed; the entry fields for bowlers, allrounders, teams, the other formats and the women's table are not verified, and team entries in particular may not carry the player fields. Coverage and the update date depend on the data source.

API Features

Four ranking categories The category path value selects batsmen, bowlers, allrounders or teams, so one operation serves every ranking table that the data source documents.
Test, ODI and T20 tables The required formatType query value picks test, odi or t20, which lets a rankings page switch format with a single changed parameter.
Women's rankings switch Setting isWomen to 1 returns the women's table, and the parameter notes state that this table has no odi option, so a selector can disable that combination.
Rating, points and trend per entry Each ranking entry carries rating, points and a trend of Flat, Up or Down, with an integer difference on some entries, which is enough to draw movement arrows next to a rank.
Identifiers for linked pages Entries return id, countryId and faceImageId, so a player row can link to the profile and image operations of this product and a country can be grouped without name matching.
Update date on every row The lastUpdatedOn field gives a YYYY-MM-DD date for each entry, which lets a page show how fresh the table is and detect when the ranking changed.
Observed rankings response shape A live probe of batsmen in t20 returned HTTP 200 with a rank array and an appIndex object, so the main structure is observed and not only taken from documentation.

Live API Demo

GET /api/project/cricbuzz-cricket/stats-get-icc-rankings

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/stats-get-icc-rankings?key=<API_KEY>&category=batsmen&formatType=t20'
📢
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 ICC rankings operation return?

It returns an object with a rank array and an appIndex object. A live probe of category batsmen and formatType t20 returned HTTP 200 with 15 entries, each holding id, rank, name, country, countryId, faceImageId, rating, points, lastUpdatedOn and trend, and some also holding an integer difference.

Which parameters are required?

category in the URL path and formatType in the query string are required strings. category takes batsmen, bowlers, allrounders or teams, and formatType takes test, odi or t20. isWomen is optional; send 1 for the women's table.

Is there an ODI table for women?

According to the parameter notes, no. When isWomen is 1, there is no odi table, so offer only test and t20 in a women's selector and handle an empty or error response if odi is sent anyway.

Are the rank, rating and points values numbers?

They are strings in the probe and the source example, for example rank, rating and points. Convert them explicitly before sorting or doing arithmetic, and keep the original string if you only display it.

Can two entries share a rank?

Yes. In the source example two players are both at rank 5 and the next entry is rank 7. Do not use rank as a unique key; use id for the player instead and keep the array order for display.

When does difference appear?

The integer difference field appears only on some entries, usually together with a trend of Up or Down, while unchanged entries in the example have trend Flat and no difference. Treat it as optional and default to no change when it is missing.

Were bowlers, allrounders, teams and the women's table tested?

No. Only batsmen with t20 was probed. The entry fields for the other categories, formats and the women's table are not verified, and team entries may differ from player entries, so check a real response before binding a team table.

How long is the returned list?

The length is not documented as fixed. The probe and the source example each show 15 entries even though the example title mentions a top 100 list, so build the page to render whatever number of rows arrives.

Related operations

Guides

View Subscription Plans →