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
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/stats-get-icc-rankings 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'
Query Result
Use Cases
- Build an ICC rankings page with category tabs, a format selector and a men's or women's toggle that map directly to category, formatType and isWomen.
- Show a top-batters widget on a team or tournament hub that lists rank, name, country and rating, and links each name to the player profile by id.
- Track ranking movement between daily snapshots by storing rating and lastUpdatedOn, and use the trend and difference fields to highlight risers and fallers.
- Prepare a women's-cricket ranking explainer that switches isWomen on and hides the ODI option, following the documented limit.
- Group the ranking rows by countryId to compare how many top-ranked players each national side has in a chosen format, converting the string ratings first.
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.