YorkerAPI

Use for ball-by-ball rows: every delivery of a match (or one innings), or a batter's or bowler's balls across matches (filter by competition, season, overs, wickets only or boundaries only). Each ball has runs, extras, the wicket and fielders, the score after it and our win probability for the batting side (limited-overs matches). Costs 10 credits.

Use for the leaders in a stat (runs, batting_average, strike_rate, sixes, wickets, economy, bowling_average) in a competition, season or format. Rate stats need min_balls faced or bowled (default 120). Costs 5 credits.

Use for how one match's market moved: every pregame snapshot by sportsbook (decimal and American), the median margin-free probability per snapshot, and with include_in_play the prices taken during the match. Costs 10 credits. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

Use to see a limited-overs match's in-play market beside our model, on the exact ball: at each in-play price snapshot, the median margin-free price on team 1, our win probability after the last ball bowled before it, the score at that moment and the gap. Costs 10 credits.

Use for one match in full: result, toss, venue, player of the match, every innings with its batting card (runs, balls, fours, sixes, strike rate, how out, fall of wicket) and bowling card (overs, maidens, runs, wickets, economy), our team ratings before and after, and each sportsbook's opening and closing match-winner price. Costs 5 credits. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

Use for results: matches newest first with both scores, toss, result and margin. Filter by competition, season, team, opponent, venue, date or a date range. Costs 2 credits.

Use for a batter against a bowler: balls, runs, strike rate, dots, fours, sixes and every dismissal, overall and by format. Costs 5 credits.

Use for match-winner prices by sportsbook (mid-2020 on, upcoming matches included): each book's opening and latest pregame decimal price, the American price and how many snapshots we hold. For one match, or a competition, season or date. Costs 5 credits. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

Use for a player's career: teams played for, and batting (runs, balls, average, strike rate, fours, sixes, hundreds, fifties, highest score) and bowling (overs, wickets, average, economy, strike rate, five-wicket hauls, best) by format, all counted from the ball-by-ball record, which starts in December 2001, so an earlier career shows only the part since. Costs 5 credits.

Use for a player's matches, newest first: team, opponent, result, and the player's batting (runs, balls, fours, sixes, out) and bowling (balls, runs, wickets) in each innings. Filter by format, competition or season. Costs 5 credits.

Use for a player's batting and bowling split by season, competition, phase of the innings (powerplay, middle, death) or format, optionally inside one format, competition or season. Costs 5 credits.

Use for our team ratings (Elo) in one format, best first: international sides and franchises, men's or women's, active in the last two years by default. Costs 2 credits.

Use for upcoming and live matches in every competition, soonest first: start time, teams, venue, status, each side's current rating where we rate it, and the favourite at the median sportsbook price where one is posted. A fixture keeps its match id once played, so get_match takes it then. Costs 2 credits. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

Use for how a ground plays, by format: average first- and second-innings totals, how often the side batting first wins, how often the toss winner wins and what captains choose, and draws. Match by part of the ground or city name. Costs 5 credits.

Use for a limited-overs match's win-probability worm: our chance the batting side wins at the end of every over (and from team 1's side), with the ten balls that moved it most. Costs 10 credits.

Use to see every competition we hold and its key: format, men's or women's, international or club, match count, first and last match, seasons. Costs 1 credit.

Use for team ids: international sides and franchises, most matches first. Women's sides end in -women (india-women). A renamed side lists its current id in now_plays_as, and filtering on either finds both. Filter by competition, season, gender or part of a name. Costs 1 credit.

Use to find a player's id by name (the scorecard short form, "V Kohli", or the full name), most matches first and their last team. Or list a team's players with team_id. Costs 1 credit.