Skip to content

YorkerAPI Review 2026

A developer-focused review of YorkerAPI, a cricket data API with every delivery of more than 23,000 matches, its own win probability and opening and closing match-winner prices. It has 500 free credits a month, no card, and paid plans from $19.

YorkerAPI at a Glance

YorkerAPI Cricket Data API
YorkerAPI
๐Ÿ’ฒ to ๐Ÿ’ฒ๐Ÿ’ฒ
Free Tier
Live Scores Play-by-Play Box Scores Stats Schedules Standings Rosters Historical Websocket MCP Discord

Green = available ยท amber = unverified or varies by plan ยท crossed out = not available. Pricing: ๐Ÿ’ฒ โ‰ˆ $20/mo up to ๐Ÿ’ฒ๐Ÿ’ฒ๐Ÿ’ฒ๐Ÿ’ฒ๐Ÿ’ฒ = $1,000+/mo. From our directory research.

What YorkerAPI Is

YorkerAPI is a cricket data API built ball by ball. It holds every delivery of more than 23,000 matches, about 11.7 million balls from 2001, in every format and for men's and women's cricket. On top of the balls it adds its own Elo ratings, a win probability after each delivery and sportsbook match-winner prices from mid-2020 (checked November 2026).

You call it two ways. Each of the 18 tools is one REST endpoint, POST /v1/{tool} on mcp.yorkerapi.com, and the same tools run as an MCP server for Claude, Cursor and ChatGPT. The ball-by-ball rows come from Cricsheet's open data, and the site says that it is independent of every league and team.

Coverage and Data Types

The coverage list is long for one sport. Tests start in 2001, ODIs in 2002 and T20Is in 2005. The franchise leagues include the IPL since 2008, the BBL, CPL, PSL, T20 Blast, The Hundred, SA20 and ILT20, plus the County Championship, the WBBL and the WPL. The data comes in four groups:

  • Matches: schedules, results with scores and margins, and full batting and bowling cards.
  • Deliveries: batter, bowler, runs, extras, wickets and fielders for each ball, queryable by match, batter or bowler.
  • Players and venues: careers by format, splits by phase (powerplay, middle, death), batter against bowler, leaderboards and how a ground plays at the toss.
  • Models: Elo by format and a win-probability worm over by over.

It is not a live feed. A match appears within a few days of its end, because the ball-by-ball source publishes in batches, and nothing is served during play. For live cricket scores, pair it with a live provider from the sports data API list.

Odds and Win Probability

The prices are match-winner only, by sportsbook, from mid-2020 on internationals and the IPL, BBL, PSL, CPL, T20 Blast and The Hundred. get_odds returns each book's opening and closing price, decimal and American. get_line_movement returns every pregame snapshot, and in-play prices are kept apart from the pregame lines. There are no spreads, totals or player props.

The useful part is that the prices sit on the same match ids as the balls. get_market_vs_model lines up each in-play price with the win probability after the last ball bowled, so you can see where the market and the model split. That suits a cricket model that wants a closing line next to the result. For wider odds coverage, see the historical odds guide.

YorkerAPI Pricing and Access

Every account gets 500 free credits each month with no card. The free plan includes all 18 endpoints, REST and MCP. A call costs 1 to 10 credits: 1 for a lookup like search_players, 2 for schedules and results, 5 for a scorecard, odds or player stats, and 10 for ball-by-ball rows and the win-probability tools (checked November 2026).

Paid plans are monthly. Starter is $19 for 10,000 credits, Pro is $49 for 30,000 and Scale is $149 for 125,000. Wallet top-ups start at $5 for 2,000 credits and do not expire while the account is open. The pricing page puts a full season of ball by ball at about 23,000 credits, which fits the Pro plan.

The terms allow storage, model training and commercial apps. Passing the data on as a dataset, a feed or a raw odds export is not allowed.

Getting an API Key

Sign up on yorkerapi.com/signup for the free plan: 500 credits a month, no card (checked November 2026). The terms say that the site verifies your email before it issues a key.

Send the key in the x-api-key header on every request. Authorization: Bearer works too, and the MCP endpoint takes ?key=. The free plan is not a trial: the balance refills to 500 once a month while you have no paid plan.

A First Request in Python

This sample calls search_players, a 1-credit tool, on https://mcp.yorkerapi.com with the key in x-api-key (from the docs, checked November 2026).

import os

import requests

resp = requests.post(
    "https://mcp.yorkerapi.com/v1/search_players",
    headers={"x-api-key": os.environ["YORKERAPI_API_KEY"]},
    json={"name": "kohli"},
    timeout=10,
)
resp.raise_for_status()

body = resp.json()
for player in body.get("data", body)["players"]:
    print(player["player_id"], player["full_name"] or player["name"], player["matches"], player["last_team"])

It returns the players that match the name, most matches first, each with a player_id, the scorecard name, the full_name, a match count and the last team. The OpenAPI spec wraps results in a data key, so the sample reads either shape. Pass the player_id to get_player for a career by format.

Rate Limits, Docs and SDKs

The rate limit is the same on every plan: 60 requests a minute, dropping to 10 a minute when your credit balance falls under 100 (checked November 2026). Credits are the real spend limit. A server error refunds the credits, an empty answer is refunded, and the same call repeated within two minutes is charged once. A 402 means that you are out of credits. Each response carries X-Credits-Used and X-Credits-Remaining.

The docs give each of the 18 tools a page with cURL, Python and MCP examples, and a guides section has worked Python and JavaScript samples. A public OpenAPI 3.1 spec and a tool catalogue sit on mcp.yorkerapi.com (/openapi.json, /v1/tools). There is no official Python package yet. A status page and a data changelog show uptime and the last refresh of each dataset. For assistants, see our sports MCP servers list.

Who YorkerAPI Is For

  • Cricket modellers and bettors who want every ball, a win probability and a closing price on one match id.
  • Analysts and researchers who need phase splits and batter-against-bowler records across formats and leagues.
  • Developers and AI builders who want an assistant to answer cricket questions over MCP with no client code.

Teams that need live scores during play can run it beside a live feed. YorkerAPI holds the history and the models, and the live feed holds the match in progress.

Verdict

YorkerAPI is a deep cricket API with plain coverage notes: it states when each league starts, what the prices are and what it does not serve. The free plan is real, the credit prices are fixed and posted, and the ball-level win probability gives you something a scorecard feed does not.

For historical cricket data, T20 models and an AI assistant that talks cricket, it is a good first stop. Start with the free credits through yorkerapi.com, run get_deliveries and get_win_probability on one match, and see whether the data fits your model.

Last updated: ยท How providers get listed

Frequently Asked Questions

Yes. Every account gets 500 free credits each month with no card, and the free plan includes all 18 endpoints plus MCP. A call costs 1 to 10 credits, so 500 credits covers 50 to 500 calls. The balance refills to 500 once a month while you have no paid plan (checked November 2026).
Starter is $19 a month for 10,000 credits, Pro is $49 for 30,000 and Scale is $149 for 125,000 (checked November 2026). You can also top up a wallet from $5 for 2,000 credits, and wallet credits do not expire while your account is open. The free plan costs nothing.
No. A match appears within a few days of its end, because the ball-by-ball source publishes in batches, and nothing is served during play. It does keep in-play prices from the sportsbooks, lined up with its win probability after the match. Pair it with a live cricket feed for scores in progress.
Tests, ODIs and T20Is for men and women, plus the IPL, BBL, PSL, CPL, T20 Blast, The Hundred, SA20, ILT20, the County Championship, the WBBL and the WPL. Tests start in 2001 and the IPL in 2008. Match-winner prices start in mid-2020 for the internationals and the main T20 leagues (checked November 2026).
Sign up at yorkerapi.com for the free plan, which gives 500 credits a month with no card. The site verifies your email, then issues a key. Send it in the x-api-key header (Authorization: Bearer also works). The MCP endpoint takes the key as ?key= (checked November 2026).
60 requests a minute on every plan, dropping to 10 a minute when your credit balance is under 100 (checked November 2026). Credits are the spend limit: a call costs 1 to 10 credits. A 402 means that you are out of credits.

YorkerAPI Alternatives

Similar providers from the directory worth shortlisting alongside YorkerAPI.

Want every ball of the IPL as rows?

Take the 500 free monthly credits, call get_deliveries on one match, and check the win probability against your model.

Are You the Team Behind YorkerAPI?

Show developers you're independently listed on SportsAPIs.dev. Copy this badge onto your site. It links straight back to this profile.

Each of these works best on a reviews or "As cited on SportsAPIs.dev" page that your homepage links to, or in a testimonial strip on the homepage.

Badge

YorkerAPI is listed on SportsAPIs.dev
<a href="https://sportsapis.dev/apis/yorkerapi" title="YorkerAPI on SportsAPIs.dev">
  <img src="https://sportsapis.dev/assets/images/badges/listed-on-sportsapis.svg"
       alt="YorkerAPI is listed on SportsAPIs.dev" width="220" height="48">
</a>

Text link

<a href="https://sportsapis.dev/apis/yorkerapi">Read the YorkerAPI review on SportsAPIs.dev</a>

Review quote

<blockquote>
  Cricket ball-by-ball API with win probability and match-winner prices.
</blockquote>
<p><a href="https://sportsapis.dev/apis/yorkerapi">SportsAPIs.dev review</a></p>

Want a Featured Partner spot or to update your listing? Partner with us โ†’