按类型获取板球系列赛列表:国际赛、联赛、国内赛或女子赛事

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

返回按月份分组的板球系列赛,类型由必填的路径参数 type 选择。文档中的取值有 international、league、domestic 和 women,默认值是 international。一次 type=international 的探测调用返回了 HTTP 200 和一个 JSON 对象,其中包含 seriesMapProto 数组(该样本中有 11 个月份分组)、appIndex 对象(seoTitle 和 webURL),以及 contentFilters 数组,数组里只有一个条目,filterId 为 liveStream,filterName 为 Live Streaming。seriesMapProto 的每个分组都有一个日期标签(如 OCTOBER 2026)和一个 series 数组。每个系列赛条目包含 id(数字)、name、startDt 和 endDt,两个日期都以毫秒级纪元时间戳字符串的形式序列化。这个 id 就是本产品其他系列赛接口所使用的 seriesId。league、domestic 和 women 三个取值来自参数说明,没有经过探测调用验证。

API 功能

四种赛事类别 通过路径参数 type 选择 international、league、domestic 或 women 列表,一个接口就覆盖了浏览赛事的几种主要方式。
按月份分组的系列赛块 seriesMapProto 包含若干分组,每组有 OCTOBER 2026 这类日期标签和一个 series 数组,可直接渲染成日历式的赛事列表。
后续调用所需的系列赛 ID 每个条目的 id 就是本产品比赛、阵容、场馆和新闻等接口所需的 seriesId,因此这通常是系列赛相关流程的第一步调用。
起止时间戳 startDt 与 endDt 是以字符串形式序列化的毫秒级纪元时间戳。在探测样本中,一项跨越多年的联赛位于靠前的月份分组,endDt 则远在未来。
经探测确认的响应结构 一次记录在案的 type=international 调用返回了 HTTP 200,包含 seriesMapProto 和 appIndex,声明的嵌套类型与实际一致,可以作为解析代码的可靠基础。
可选的 contentFilters 元数据 探测结果里还返回了带 liveStream 条目的 contentFilters 数组。请把它当作可选的页面元数据,而不是直播信号源或版权声明。

在线 API 演示

GET /api/project/cricbuzz-cricket/series-list

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

type 参数接受哪些取值?

参数说明列出了 international、league、domestic 和 women。只有 international 有探测调用记录,所以在基于其余三个取值开发之前,请对照自己预期的数据覆盖范围做检查。

系列赛条目的 id 要怎么用?

把它作为 seriesId 传给本产品的其他系列赛接口,例如比赛、阵容、场馆和新闻。历史系列赛列表接口针对过往赛事返回的也是同一种 id。

startDt 和 endDt 是什么格式?

它们是以字符串形式序列化的毫秒级纪元时间戳,探测样本中就是这样。请先在客户端把它们解析为数字,再转换成日期,并按你自己的时区处理。

为什么长期进行的赛事会出现在靠前的月份下?

条目是按日期标签分组的。在探测样本中,一项跨越多年的联赛被放在最早的月份分组里,而它的 endDt 远在未来,所以不要假定分组所在的月份就是结束月份或当前月份。

appIndex 和 contentFilters 是什么?

appIndex 携带页面元数据(seoTitle 和 webURL),而 contentFilters 是一个额外的元数据数组,在探测中观察到的是 liveStream 条目。它们都不是系列赛数据行,请与 seriesMapProto 分开读取。

这个接口会列出往年已结束的系列赛吗?

该接口面向当前和即将进行的系列赛。查看往届赛事请使用本产品的历史系列赛列表接口,它支持按年份筛选;返回空列表属于正常的数据覆盖结果。

相关接口

相关指南

查看订阅方案 →