List cricket teams by type: international, league, domestic or women
View all Cricket Live Scores, Scorecards & Stats API endpoints →Returns the team directory for one team category. The single required path input is type, which the endpoint documents as one of international, league, domestic or women; the default is international. A live probe with type=international returned HTTP 200 and a JSON object with a list array (40 rows) and an appIndex object holding seoTitle and webURL strings. In that probe, list mixes two row shapes: team rows carrying teamId (number), teamName, teamSName and imageId, with countryName present on some of them, and section heading rows that contain only teamName, such as Test Teams and Associate Teams. Only the international type was probed; the shape for league, domestic and women is not verified and may differ in grouping or in which optional fields appear. Use the teamId values with other team endpoints for players, results, schedules, news and stats.
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/teams-list API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/teams-list?key=<API_KEY>&type=international'
Query Result
Use Cases
- Build a team selector for a cricket app that offers international, league, domestic and women tabs, each backed by one call with a different type value.
- Populate a country and team lookup table keyed by teamId so scorecards, fixtures and news items can be labelled with a name and a short code.
- Render a grouped teams directory page by treating rows that contain only teamName as section headings and the rows after them as that group's teams.
- Prefetch teamId values to drive scheduled jobs that pull results, schedules and player lists for every team in a chosen category.
- Reconcile the team identifiers stored in your own database against the current directory to find new, renamed or missing teams.
Frequently asked questions
What does the teams-list endpoint return?
It returns a JSON object with a list array and an appIndex object. In the probed international response, list held 40 rows: team rows with teamId, teamName, teamSName and imageId (and countryName on some rows), plus heading rows that contain only teamName. appIndex carried seoTitle and webURL strings.
Which values can I use for the type parameter?
The endpoint documents international, league, domestic and women, with international as the default. Only international was exercised by the recorded probe, so check the response for the other three before you depend on their grouping.
How do I tell a team from a section heading in the list?
In the probed response, heading rows such as Test Teams and Associate Teams contain only teamName, while team rows also include teamId, teamSName and imageId. Treat a row without teamId as a heading and do not assume every list element is a team.
Is countryName always present?
No. In the probed response only some team rows included countryName, for example India, Pakistan and Australia, while others such as Ireland or England did not. Handle it as an optional field and fall back to teamName.
How do I use the teamId values I get back?
Pass a teamId to the other team endpoints in this API, such as team players, results, schedules, news and stats, to move from the directory to a specific team. Keep the identifiers as numbers.
Does the list include every team in a category?
Coverage depends on the data available for each category, so do not treat the list as a complete or permanent registry. Count and ordering can change over time, and the probe reflects one moment for the international type only.