⚽OpenData足球数据开放平台
中EN登录控制台免费试用 14 天

← 返回接口文档

GET/api/v1/matches/schedule/diary

获取赛程赛果列表-日期查询
实时数据包activebetacore可调用(数据有范围)

接口说明

该接口返回所请求日期的全量赛程赛果数据（请求限制：前后30天）
注：实时数据的获取通过实时统计数据接口

当天赛程 建议请求频次：10min/次（全量更新）
未来赛程 建议请求频次：30min/次（全量更新）

调用信息

请求
GET https://api.sports.csap.ai/api/v1/matches/schedule/diary
鉴权
请求头 X-API-Key: <你的 key>(也支持 Authorization: Bearer <key>;?key= 仍可用但不建议,key 会留在地址和日志里)
外部 key
可调用(数据有范围)外部 key 可以调用，但只返回开放范围内的数据，见「通用说明 · 外部 key 的数据范围」。
频率限制
每分钟 3000 次 · 每天 200000 次 · 按 key 配置(以 /api/v1/account 返回的 rate_per_min、quota_daily 为准;上面是试用 key 的值),超出回 429。另外整表快照、不带比赛 id 的统计列表等重型请求全站同时只处理 2 个,排不上回 429 + Retry-After。响应里暂时没有 X-RateLimit-* 头。 详见通用说明

请求参数 1

参数类型必填示例说明
datestring必填2026-11-08查询日期，格式为yyyymmdd（20200101）

请求示例

curl "https://api.sports.csap.ai/api/v1/matches/schedule/diary?date=2026-11-08" \
  -H "X-API-Key: YOUR_API_KEY"

在线调试

示例返回

下面是 2026/11/09 22:28(北京时间) 用外部 key 实际请求的返回:HTTP 200,1000 行,773 ms(数据只留前 2 行)

{
  "code": 0,
  "data": [
    {
      "agg_score": null,
      "asian_handicap": null,
      "assistant1": null,
      "assistant2": null,
      "assistant_var": null,
      "away_corner": 0,
      "away_ot": null,
      "away_pen": null,
      "away_position": null,
      "away_red": 0,
      "away_score": 0,
      "away_scores": 0,
      "away_team": "埃瓦尔C队",
      "away_team_id": null,
      "away_yellow": 0,
      "away_zh": "埃瓦尔C队",
      "comp_ref": null,
      "competition": null,
      "competition_id": null,
      "coverage": null,
      "created_at": "2026-11-07T17:36:29.844958Z",
      "cur_period_start": null,
      "ended": null,
      "environment": null,
      "fourth": null,
      "from_schedule": false,
      "group_num": null,
      "half_away": 0,
      "half_home": 0,
      "has_ot": null,
      "home_corner": 0,
      "home_ot": null,
      "home_pen": null,
      "home_position": null,
      "home_red": 0,
      "home_score": 2,
      "home_scores": 0,
      "home_team": "杜兰高",
      "home_team_id": null,
      "home_yellow": 0,
      "home_zh": "杜兰高",
      "humidity": null,
      "id": 4261965,
      "inferred_reason": null,
      "intelligence": null,
      "last_change_ts": null,
      "league": "西班牙皇家足协丙级联赛",
      "lineup": null,
      "logo": null,
      "loss": null,
      "match": null,
      "match_time": "2026-11-07T16:00:00Z",
      "minute": null,
      "mlive": null,
      "name": null,
      "neutral": null,
      "note": null,
      "ou_line": null,
      "period_initial": null,
      "pressure": null,
      "query": null,
      "referee_id": null,
      "referee_name": null,
      "referees": null,
      "related_id": null,
      "round": null,
      "round_num": null,
      "season_id": null,
      "source": "S7",
      "source_id": "4633483",
      "stage_id": null,
      "start_ts": "2026-11-07T16:00:00Z",
      "status_code": 8,
      "status_id": 8,
      "status_inferred": false,
      "status_type": "finished",
      "tbd": null,
      "team": null,
      "team_reverse": null,
      "temperature": null,
      "type": null,
      "updated_at": 1794076270312,
      "var": null,
      "venue_id": null,
      "venue_name": null,
      "version": 3,
      "weather": null,
      "wind": null
    },
    {
      "agg_score": null,
      "asian_handicap": null,
      "assistant1": null,
      "assistant2": null,
      "assistant_var": null,
      "away_corner": null,
      "away_ot": null,
      "away_pen": null,
      "away_position": null,
      "away_red": null,
      "away_score": 1,
      "away_scores": 1,
      "away_team": "Grazer AK",
      "away_team_id": "10012",
      "away_yellow": null,
      "away_zh": null,
      "comp_ref": null,
      "competition": null,
      "competition_id": null,
      "coverage": null,
      "created_at": "2026-11-07T08:20:34.138943Z",
      "cur_period_start": null,
      "ended": null,
      "environment": null,
      "fourth": null,
      "from_schedule": false,
      "group_num": null,
      "half_away": null,
      "half_home": null,
      "has_ot": null,
      "home_corner": null,
      "home_ot": null,
      "home_pen": null,
      "home_position": null,
      "home_red": null,
      "home_score": 2,
      "home_scores": 2,
      "home_team": "Austria Lustenau",
      "home_team_id": "9982",
      "home_yellow": null,
      "home_zh": null,
      "humidity": null,
      "id": 2367750,
      "inferred_reason": null,
      "intelligence": null,
      "last_change_ts": null,
      "league": "Bundesliga",
      "lineup": null,
      "logo": null,
      "loss": null,
      "match": null,
      "match_time": "2026-11-07T16:00:00Z",
      "minute": null,
      "mlive": null,
      "name": null,
      "neutral": null,
      "note": null,
      "ou_line": null,
      "period_initial": null,
      "pressure": null,
      "query": null,
      "referee_id": null,
      "referee_name": null,
      "referees": null,
      "related_id": null,
      "round": null,
      "round_num": null,
      "season_id": null,
      "source": "S4",
      "source_id": "5846017",
      "stage_id": null,
      "start_ts": "2026-11-07T16:00:00Z",
      "status_code": 3,
      "status_id": 8,
      "status_inferred": false,
      "status_type": "finished",
      "tbd": null,
      "team": null,
      "team_reverse": null,
      "temperature": null,
      "type": null,
      "updated_at": 1794074224497,
      "var": null,
      "venue_id": null,
      "venue_name": null,
      "version": 20,
      "weather": null,
      "wind": null
    }
  ],
  "message": "success",
  "success": true
}

返回字段 88

agg_scorenull可为空双回合常规时间(包括加时时间)总比分 字段说明 · example：[3, 6]
asian_handicapnull可为空亚盘
assistant1null可为空助理裁判1
assistant2null可为空助理裁判2
assistant_varnull可为空var助理裁判 字段说明 · example：[6261, 6262]
away_cornerinteger可为空客队角球数示例: 0
away_otinteger可为空客队加时比分示例: 0
away_peninteger可为空客队点球大战比分示例: 0
away_positionnull可为空客队排名
away_redinteger可为空客队红牌数示例: 0
away_scoreinteger可为空客队比分(常规时间,含补时)示例: 0
away_scoresinteger可为空比分字段说明 · example：[1, 0, 0, 0, -1, 0, 0]示例: 0
away_teamstring客队名(英文)示例: "埃瓦尔C队"
away_team_idstring可为空客队id示例: "10012"
away_yellowinteger可为空客队黄牌数示例: 0
away_zhstring可为空客队中文名示例: "埃瓦尔C队"
comp_refstring可为空来源内的赛事 id示例: "1679"
competitionnull可为空赛事
competition_idstring可为空赛事 id示例: "1679"
coveragenull可为空动画、情报、阵容 字段
created_atstring创建时间示例: "2026-11-07T17:36:29.844958Z"
cur_period_startinteger可为空当前阶段开始时间(Unix 秒)示例: 1794071791
endednull可为空结束时间（有数据时返回）
environmentnull可为空比赛环境,有数据才有此字段
fourthnull可为空第四官员
from_scheduleboolean是否取自赛程示例: false
group_numnull可为空第几组，1-A、2-B以此类推
half_awayinteger可为空客队半场比分示例: 0
half_homeinteger可为空主队半场比分示例: 0
has_otnull可为空是否有加时 1.是（有数据时返回）
home_cornerinteger可为空主队角球数示例: 0
home_otinteger可为空主队加时比分示例: 0
home_peninteger可为空主队点球大战比分示例: 0
home_positionnull可为空主队排名
home_redinteger可为空主队红牌数示例: 0
home_scoreinteger可为空主队比分(常规时间,含补时)示例: 2
home_scoresinteger可为空比分字段说明 · example：[1, 0, 0, 0, -1, 0, 0]示例: 0
home_teamstring主队名(英文)示例: "杜兰高"
home_team_idstring可为空主队id示例: "9982"
home_yellowinteger可为空主队黄牌数示例: 0
home_zhstring可为空主队中文名示例: "杜兰高"
humiditynull可为空湿度
idinteger记录 id;翻页游标(id 参数取 >= 此值的记录)。比赛类接口里是我方比赛 id(gmid)示例: 4261965
inferred_reasonnull可为空推断原因
intelligencenull可为空是否有情报，1-是、0-否
last_change_tsinteger可为空最后变动时间(Unix 秒)示例: 1794073669
leaguestring赛事名(英文)示例: "西班牙皇家足协丙级联赛"
lineupnull可为空是否有阵容，1-是、0-否
logonull可为空logo(本平台的图片地址;没有时为空)
lossnull可为空是否判负 1.是（有数据时返回）
matchnull可为空比赛列表
match_timestring开赛时间(UTC,ISO 8601)示例: "2026-11-07T16:00:00Z"
minutestring可为空比赛进行分钟示例: "Ended"
mlivenull可为空是否有动画，1-是、0-否
namenull可为空名称
neutralnull可为空是否中立场，1-是、0-否
notenull可为空备注
ou_linenull可为空大小球盘口
period_initialinteger可为空当前阶段起始分钟示例: 0
pressurenull可为空气压
querynull可为空查询信息(翻页游标、总数)
referee_idnull可为空裁判id
referee_namenull可为空裁判名
refereesnull可为空裁判组,有数据才有此字段
related_idnull可为空双回合中另一回合比赛id
roundnull可为空轮次
round_numnull可为空第几轮
season_idnull可为空赛季 id
sourcestring数据来源代号(S1、S2…)示例: "S7"
source_idstring来源内的 id示例: "4633483"
stage_idnull可为空阶段id
start_tsstring开赛时间(UTC,ISO 8601)示例: "2026-11-07T16:00:00Z"
status_codeinteger状态码示例: 8
status_idinteger比赛状态码(见状态与类型码对照表)示例: 8
status_inferredboolean状态是否为推断示例: false
status_typestring比赛状态:notstarted 未开赛 / inprogress 进行中 / finished 已结束 等示例: "finished"
tbdnull可为空比赛时间是否待定 1.是（有数据时返回）
teamnull可为空球队名
team_reversenull可为空是否主客相反 1.是（有数据时返回 eg：相反-官网A vs B、本平台B vs A）
temperaturenull可为空温度
typenull可为空类型
updated_atinteger最后更新时间(UTC,ISO 8601;增量同步用 time 参数按它取)示例: 1794076270312
varnull可为空var裁判
venue_idnull可为空场馆id
venue_namenull可为空场馆名
versioninteger版本号(越大越新)示例: 3
weatherstring可为空天气id · 1:局部有云 · 2:多云 · 3:局部有云/雨 · 4:雪 · 5:晴 · 6:阴有雨/局部有雷暴 · 7:阴 · 8:薄雾 · 9:阴有雨 · 10:多云有雨 · 11:多云有雨/局部有雷暴 · 12:局部有云/雨和雷暴 · 13:雾示例: "-1°C"
windnull可为空风速

错误码

HTTPmessage场景
401missing API key / unauthorized没带 X-API-Key 或 key 无效、已停用
429rate limit exceeded / daily quota exceeded超过 key 的每分钟次数或每日配额
429server busy, retry later服务端并发名额已满(重型请求同时只有 2 个),按 Retry-After 秒后重试
500query error服务端查询失败,可重试