get_head_to_head
ChatGPTTwo cricket teams' record against each other in one competition, across every season Statz holds: matches played, wins each, ties, draws and no results, the date of the first meeting and the next scheduled one, the last few meetings with scores and results, and the top five run scorers and wicket takers across all the meetings, with links to the players and matches on Statz. Teams that have never met return a record of zero. Each meeting has a fixture_id for get_match_scorecard.
get_match_scorecard
ChatGPTThe full scorecard of one finished cricket match: every innings' total, batting (runs, balls, fours, sixes, how out) and bowling figures, plus the result, toss and player of the match, with a link to the scorecard on Statz. Takes the match's fixture_id, which get_recent_results returns. A match not finished yet comes back with status not_finished; live scores are not covered.
get_player_form
ChatGPTA cricketer's last few matches, newest first: in each, runs and balls faced, whether not out, overs, wickets and runs conceded, catches, the opponent, ground and team result, and the batting and bowling totals over those matches, with links to each scorecard and the player's page on Statz. One competition, or by default every competition in the format of the player's latest match (a T20 player's leagues and internationals together, never a Test). Takes the player's name or a player_id; when several players match a name, the result has status needs_disambiguation with each candidate's player_id. Whole-season figures are in get_player_season_stats.
get_player_season_stats
ChatGPTOne cricketer's figures for a competition season: matches, runs, average, strike rate, high score, fifties and hundreds, wickets, economy, best bowling, catches, and where they rank in the competition, with a link to the player's page on Statz. Takes the player's name or a player_id. When several players match a name, the result has status needs_disambiguation and lists each candidate with their team, competition and player_id. Rankings across players are in get_stat_leaders; career and all-time totals are not covered.
get_recent_results
ChatGPTThe latest finished cricket matches, newest first, optionally for one competition or team: final scores, the result, venue and round, and a link to each match on Statz. Each result has a fixture_id, which get_match_scorecard takes for the full scorecard. Covers completed matches only; matches in progress (live scores) are not covered, and upcoming matches are in get_upcoming_fixtures.
get_standings
ChatGPTA cricket competition's points table for a season: each team's position, played, won, lost, points, net run rate and playoff zone, one panel per group where a competition has groups (the T20 Blast), and the World Test Championship ranked by percentage of points won. Returns the table as a board with a link to it on Statz. Player rankings are in get_stat_leaders; ICC team rankings are not covered.
get_stat_leaders
ChatGPTRanks the players in one cricket competition season by a batting, bowling or fielding statistic: for example most runs in the IPL, most sixes in the CPL, best economy rate in the T20 Blast, most wickets in the 2025 Big Bash, or most catches for one team. Returns a ranked board with each player's team, value and matches played, and a link to the full leaderboard on Statz. Rate stats (averages, strike rates, economy) rank only players above a minimum qualification, stated in the result. Season figures only: one player's figures are in get_player_season_stats, team tables in get_standings; career and all-time records are not covered.
get_team_game_by_game
ChatGPTEvery player's figures for one stat, game by game, over a cricket team's last N matches (5-15, default 10) in one format: e.g. "New Zealand ODI runs game by game" or "Mumbai Indians wickets in the last 10 matches". Returns a grid: the matches across the top (date, opponent, home, away or neutral, the team's score and result), each player's figure in every match he batted or bowled in (balls faced or overs beside it), his average per match, and the team total. A blank is a match he did not play, or did not bat or bowl in; a 0 with balls faced is a duck. Franchise and national teams: give the format (T20, ODI, Test, Hundred) or a competition to keep to one; a competition sets the format. A team name that fits several teams returns an error listing them. Test figures are per match, both innings together.
get_upcoming_fixtures
ChatGPTScheduled cricket matches in the coming days, soonest first, optionally for one competition or team: teams, start time in UTC, venue, round and a link to each match on Statz, for up to 14 days ahead. When nothing is scheduled in the window, the next scheduled match is included. Finished matches are in get_recent_results; live scores are not covered.
get_venue_stats
ChatGPTHow a cricket ground has played over its last 30 completed matches in one format: wins batting first and chasing, what toss winners chose and how often they won, the average first and second innings totals, the highest and lowest first innings, and the latest results, with a link to the ground's page on Statz. Takes the ground's name (or its city) or a venue_id. When a name fits several grounds the result is an error listing each with its city and venue_id. Without a competition or format, the format the ground has staged most. Innings averages cover limited-overs matches; for Tests the results include draws instead.