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
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
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.