按 playerId 获取板球球员的击球统计(赛制 × 指标表格),可用 seriesId 限定为某一系列赛

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

以表格形式返回单个板球球员的击球统计。playerId 为必填的数字,放在 URL 路径中:请使用本产品的热门球员或球员搜索接口返回的 id 值。默认值 8733 只是示例。seriesId 为可选的数字,放在查询字符串中:传入系列赛列表或系列赛归档接口返回的系列赛 id,可把统计限定在该系列赛内;留空则使用默认视图。源 200 示例是一个对象,包含 appIndex 对象(seoTitle 与 webURL 字符串)、headers 数组(示例中为 ROWHEADER、Test、ODI、T20 和 IPL)、由 seriesName 对象组成的 seriesSpinner 数组(示例中只有一个 Career 条目),以及 values 数组。values 的每个元素都是一个带有自己 values 字符串数组的对象:第一个字符串是指标名称,后面的字符串与 headers 中的赛制列一一对应。示例中的指标有 Matches、Innings、Runs、Balls、Highest、Average、SR、Not Out、Fours、Sixes、Ducks、50s、100s、200s、300s 和 400s,所有数字都是字符串。该接口没有记录过实际探测调用,因此所有字段都来自源示例。列、系列赛选项以及传入 seriesId 后的默认行为均未经验证,也不保证覆盖完整的生涯数据。

API 功能

按赛制分列的单张表格 headers 数组在 ROWHEADER 之后列出各个赛制列(源示例为 Test、ODI、T20 和 IPL),一次请求就能让击球统计页签按赛制各占一列。
逐行排列的指标布局 values 的每个元素以指标名称开头,后面依次是每列一个值,只需一个简单循环就能转成“指标 × 赛制”的键值对象。
可选的系列赛范围 seriesId 可把统计限定在某一系列赛内,例如源文档给出的 IPL 2024 标识,赛事页面因此可以在默认视图旁展示球员在该赛事中的数据。
系列赛选择器元数据 seriesSpinner 数组返回 seriesName 条目(源示例中只有 Career),能反映响应所对应的系列赛选项,检查实际响应后可以用来驱动选择器。
完整的击球指标集 示例涵盖 Matches、Innings、Runs、Balls、Highest、Average、SR、Not Out、Fours、Sixes 和 Ducks,一次调用即可同时支持数量与得分速率的对比。
里程碑计数行 50s、100s、200s、300s 和 400s 这几行按赛制统计各档得分的局数,做“百分和半百”组件时不必自己累加各局数据。
字符串类型的数值 表中所有数字(包括带小数的平均分)都以字符串形式返回,保留了数据源的格式,由你决定在何处解析。

在线 API 演示

GET /api/project/cricbuzz-cricket/players-get-batting

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

击球统计接口会返回什么?

返回一个表格式对象:appIndex 对象、赛制列的 headers 数组、seriesSpinner 数组以及 values 行数组。每一行自己的 values 数组以指标名称开头,后面是每列一个字符串。该接口没有记录过实际探测调用,所以这些字段来自源示例。

playerId 从哪里获取?

使用本产品的热门球员或球员搜索接口返回的 id 值。它们以数字字符串形式返回,而本接口把 playerId 声明为 URL 路径中的必填数字。默认值 8733 对应源示例中的球员,只是示例值。

seriesId 有什么作用,在哪里找到它?

seriesId 为可选参数,用于把统计限定在某一系列赛内。可以从本产品的系列赛列表或系列赛归档接口获取它的 id,源文档给出 7607 对应 IPL 2024。指定系列赛后的响应是什么样子没有探测记录,所以请对每个请求的系列赛检查 headers 和 values。

为什么所有数字都是字符串?

在源示例中,包括 Runs、Average 和 SR 在内的所有值都是字符串。请在客户端自行解析;如果需要保留数据源的四舍五入方式,可以保留原始文本。

列是否总是 Test、ODI、T20 和 IPL?

示例在 ROWHEADER 之后展示了这四列,但其他球员或系列赛的列并没有文档说明。请在每次响应中读取 headers,并按位置把每个指标行与列对应起来,不要写死赛制名称。

seriesSpinner 字段是什么?

它是由 seriesName 对象组成的数组,源示例中只有一个 Career 条目。它在按系列赛查询时的含义尚未验证,在用它构建选择器之前,请先检查自己的响应。

这能覆盖球员的完整生涯吗?

不一定。覆盖范围取决于数据源,现有证据也不保证完整的生涯记录或特定赛事。在把表格当作完整生涯总结展示之前,请先检查返回的 Matches 和 Innings 行。

appIndex 字段有什么用?

appIndex 含有 seoTitle 和 webURL 字符串,用来描述该球员在数据源中的页面。它们是响应的元数据而不是统计数据,所以不要混入击球统计表。

相关接口

相关指南

查看订阅方案 →