按 venueId 查询某个板球场的历史统计:比赛场次、先击球与先投球获胜数、平均得分以及最高和最低总分,以键值对形式返回

查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →

返回某一个板球场的历史统计摘要。venueId 通过 URL 路径传入(必填数字,默认值 24 是文档中的示例值),该 ID 来自本产品「系列赛场馆」接口返回的 id 字段。根据源 200 示例,响应是一个对象,其中 venueStats 数组由键和值均为字符串的对象组成,共八项:Total Matches(48)、Matches won batting first(7)、Matches won bowling first(19)、Avg. scores recorded(多行字符串,1st inns-310、2nd inns-337、3rd inns-261、4th inns-159,以换行符分隔)、Highest total recorded(765/6(248.5) by PAK vs SL)、Lowest total recorded(80/10(53.1) by AUS vs PAK)、Highest score chased(315/9(106.1) by PAK vs AUS)和 Lowest score defended(149/10(47.1) by SL vs PAK)。所有取值都是文本,包括场次和比分;示例中的总场次与各结果场次不保证相加一致,因此在没有核实之前不要据此推算百分比。现有依据没有说明示例对应哪个球场、统计了哪些赛制,也没有说明其他球场的条目列表会如何变化。本接口没有记录过实时探测,这里描述的所有响应字段均来自源示例,未经独立验证。这些都是历史数据,不是球场报告、天气信息或预测。

API 功能

一次请求对应一座球场 路径中的 venueId 把响应限定在单个场馆,每座球场的历史数据独立返回,不会与其他球场的数据混在一起。
键值对形式的统计列表 venueStats 数组由包含 key 与 value 字符串的对象组成,客户端无需固定的表格列结构,就能把统计渲染成带标签的列表。
先击球与先投球获胜数 示例中的 Matches won batting first 与 Matches won bowling first 两项给出原始场次,可用来对该球场的历史选边决策做对比。
各局平均得分 Avg. scores recorded 是一个多行字符串,依次列出第 1 至第 4 局的平均得分,可以按换行符拆分后使用。
极端总分附带对阵球队 Highest total recorded 与 Lowest total recorded 以 765/6(248.5) by PAK vs SL 这样的文本返回,比分、回合数和双方球队都在同一个字符串里。
追分与守分基准 Highest score chased 与 Lowest score defended 提供两个对照参考点,反映该球场在第四局或追分情境下的难度。
ID 可从系列赛场馆列表获得 venueId 就是系列赛场馆接口返回的 id,因此可以从某项赛事的场馆列表直接跳转到每座球场的统计数据。

在线 API 演示

GET /api/project/cricbuzz-cricket/venues-get-stats

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/venues-get-stats?key=<API_KEY>&venueId=24'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

场馆统计接口会返回什么内容?

根据源 200 示例,返回一个带 venueStats 数组的对象,每个条目都是包含 key 和 value 字符串的对象,例如 Total Matches、Matches won batting first 或 Highest total recorded。本接口没有记录过实时探测,这些字段尚未经过独立验证。

这个接口有哪些参数?

只有 venueId。它为必填,通过 URL 路径以数字传入,默认值为 24,即文档中的示例值。文档中没有查询参数或请求体参数。

venueId 从哪里获取?

使用本产品「系列赛场馆」接口返回的 id 字段,该接口会列出某个系列赛的所有球场。请把这个 ID 原样放入路径中。

平均得分这一项是什么格式?

在源示例中,它是一个包含四行的字符串:1st inns-310、2nd inns-337、3rd inns-261 和 4th inns-159,以换行符分隔。先按换行符拆分,再按连字符拆分,就能得到每一局的数值。

返回的值是数字还是文本?

是文本。像 48 这样的场次以及 765/6(248.5) by PAK vs SL 这样的总分都是字符串。请在自己的代码中解析数字,如果只用于展示,则保留原始文本。

可以用这些场次数据计算胜率百分比吗?

请谨慎。在示例中,先击球获胜与先投球获胜的场次相加并不等于 Total Matches,而且现有依据没有解释这个差异。除非你已经核实了剩余场次的含义,否则请按返回值原样展示场次。

这是球场报告或天气预报吗?

不是。这些条目都是球场的历史数据。接口不会返回场地状况、天气,也不会预测未来比赛的得分情况;如需针对具体比赛的球场备注,请使用本产品的场馆与球场研究类接口。

统计涵盖哪些赛制和年份?

现有依据没有说明。它只记录了一个有数据的 200 示例,没有场馆名称、赛制或日期范围,所以在发布数据之前,请针对你自己的场馆核实这些数字的统计口径。

相关接口

相关指南

查看订阅方案 →