get_venue

5 creditsStats + aggregationPOST /v1/get_venue

How a ground plays: par totals, batting first against chasing, toss effect

Use it when you want how a ground plays: average totals, how often the side batting first wins, and the toss.

Parameters

venuestringrequired: Part of the ground or city, e.g. "wankhede" or "adelaide".
formatenum: test | odi | t20 | first_class | list_aoptional
competitionstringoptional: Competition key from list_competitions (ipl, bbl, test, odi, t20i, ...).
sincestringoptional: Only matches from this date (YYYY-MM-DD).
leagueenum: cricket | test | odi | t20i | ipl | bbl | psl | cpl | blast | hundred | sa20 | ilt20 | county | wbbl | wpl | hundred_womenoptional: League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.

Notes

Over MCP, ask for it in plain English and the client calls get_venue itself. Point any MCP client at https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY.
Each call costs 5 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.yorkerapi.com/v1/get_venue \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "venue": "wankhede",
  "format": "t20"
}'

Response

json

{
  "venues": [
    {
      "id": "wankhede-stadium-mumbai",
      "name": "Wankhede Stadium, Mumbai",
      "city": "Mumbai"
    }
  ],
  "by_format": [
    {
      "format": "t20",
      "matches": 183,
      "avg_first_innings": 172,
      "avg_second_innings": 159,
      "won_batting_first": 79,
      "won_bowling_first": 103,
      "toss_winner_won": 95,
      "chose_to_field": 144,
      "draws": 0,
      "first_match": "2008-04-20",
      "last_match": "2026-05-24",
      "bat_first_win_pct": 0.434,
      "toss_winner_win_pct": 0.522
    }
  ],
  "count": 1,
  "note": "Matches with a rain rule are left out of the averages."
}