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

接口文档

共开放 134 个 REST 接口，覆盖比分、赔率、阵容、球员与球队统计、转会、赛程等数据维度。所有接口均返回标准 JSON，使用 X-API-Key 请求头鉴权。

Contract 2cb261fd829404b2 · 文档生成于 2026/11/09 22:29(北京时间)

通用说明：鉴权、返回格式、分页、频率限制、错误码 →实时推送:WebSocket / SSE / MQTT 接入与试连 →SDK:JS / Python / Dart / Swift / Kotlin →动画直播组件:2.5D / 3D 嵌入接入 →
显示 134 / 134 个接口

世界杯专题数据包

47
GET
/api/v1/categories
获取分类列表
可调用activebeta12 个字段→
GET
/api/v1/coach/honors/detail
获取教练荣誉数据
可调用(数据有范围)activebeta15 个字段→
GET
/api/v1/coaches/careers/detail
获取教练执教履历数据
可调用(数据有范围)activebeta21 个字段→
GET
/api/v1/coaches/detail
获取教练详情
可调用(数据有范围)activebeta24 个字段→
GET
/api/v1/competitions/records/detail
获取赛事记录列表
可调用(数据有范围)activebeta16 个字段→
GET
/api/v1/countries
获取国家/地区列表
可调用(数据有范围)activebeta14 个字段→
GET
/api/v1/data/delete/records
获取删除数据
可调用activebeta11 个字段→
GET
/api/v1/honors/detail
获取荣誉详情
可调用(数据有范围)activebeta9 个字段→
GET
/api/v1/intelligences/detail
获取比赛情报数据
可调用activebeta18 个字段→
GET
/api/v1/leagues/detail
获取赛事详情
可调用(数据有范围)activebeta47 个字段→
GET
/api/v1/matches/compensation/detail
获取比赛历史同赔数据
可调用(数据有范围)activebeta42 个字段→
GET
/api/v1/matches/detail/live
获取实时统计数据
可调用(数据有范围)activebeta5 个字段→
GET
/api/v1/matches/half/statistics
获取比赛球队统计(半全场)列表
可调用(数据有范围)activebeta3 个字段→
GET
/api/v1/matches/half/statistics/detail
获取历史比赛球队统计(半全场)数据
可调用(数据有范围)activebeta3 个字段→
GET
/api/v1/matches/lineup/players
获取比赛阵容详情
可调用(数据有范围)activebeta40 个字段→
GET
/api/v1/matches/lineups
获取比赛阵容详情
可调用(数据有范围)activebeta40 个字段→
GET
/api/v1/matches/lineups/detail
获取球队阵容数据
可调用(数据有范围)activebeta18 个字段→
GET
/api/v1/matches/live/history
获取历史比赛统计数据
可调用(数据有范围)activebeta5 个字段→
GET
/api/v1/matches/schedule/detail
获取赛程赛果详情
可调用(数据有范围)activebeta86 个字段→
GET
/api/v1/matches/season/best/lineups/detail
获取赛季最佳阵容数据
可调用(数据有范围)activebeta17 个字段→
GET
/api/v1/matches/stat/live
获取比赛球队球员统计数据
可调用(数据有范围)activebeta2 个字段→
GET
/api/v1/matches/trend/detail
获取单场比赛趋势详情
可调用(数据有范围)activebeta12 个字段→
GET
/api/v1/player/honors/detail
获取球员荣誉数据
可调用(数据有范围)activebeta16 个字段→
GET
/api/v1/player/market/detail
获取球员身价数据
可调用(数据有范围)activebeta24 个字段→
GET
/api/v1/players/abilities/detail
获取球员能力值数据
可调用activebeta4 个字段→
GET
/api/v1/players/detail
获取球员详情
可调用(数据有范围)activebeta36 个字段→
GET
/api/v1/players/match/statistics/detail
获取历史比赛球员统计数据
可调用(数据有范围)activebeta2 个字段→
GET
/api/v1/players/missing/detail
获取球队伤停数据
可调用(数据有范围)activebeta18 个字段→
GET
/api/v1/players/salaries/detail
获取球员薪资数据
可调用(数据有范围)activebeta23 个字段→
GET
/api/v1/players/season/statistics
获取赛季统计详情
可调用(数据有范围)activebeta66 个字段→
GET
/api/v1/players/season/statistics/old
获取赛季统计详情
可调用(数据有范围)activebeta66 个字段→
GET
/api/v1/players/transfers/detail
获取球员转会数据
可调用activebeta20 个字段→
GET
/api/v1/rank/fifa/live
获取FIFA实时排名
可调用(数据有范围)activebeta15 个字段→
GET
/api/v1/rank/fifa/men
获取国家队FIFA男子排名
可调用(数据有范围)activebeta19 个字段→
GET
/api/v1/rank/fifa/women
获取国家队FIFA女子排名
可调用(数据有范围)activebeta19 个字段→
GET
/api/v1/referees/detail
获取裁判详情
可调用(数据有范围)activebeta18 个字段→
GET
/api/v1/season/brackets
获取淘汰阶段对阵图数据
可调用activebeta0 个字段→
GET
/api/v1/seasons/table
获取赛季积分榜数据
可调用(数据有范围)activebeta65 个字段→
GET
/api/v1/team/honors/detail
获取球队荣誉数据
可调用(数据有范围)activebeta12 个字段→
GET
/api/v1/team/persons/detail
获取球队教练组数据
可调用(数据有范围)activebeta20 个字段→
GET
/api/v1/teams/abilities/detail
获取球队能力值数据
可调用activebeta0 个字段→
GET
/api/v1/teams/detail
获取球队详情
可调用(数据有范围)activebeta34 个字段→
GET
/api/v1/teams/match/statistics/detail
获取历史比赛球队统计数据
可调用(数据有范围)activebeta2 个字段→
GET
/api/v1/teams/records/detail
获取球队记录列表
可调用(数据有范围)activebeta16 个字段→
GET
/api/v1/teams/squads/history
获取球队历史阵容
可调用activebeta10 个字段→
GET
/api/v1/teams/transfers/detail
获取球队转会数据
可调用activebeta20 个字段→
GET
/api/v1/venues/detail
获取场馆详情
可调用activebeta18 个字段→

高阶数据包

25
GET
/api/v1/coach/honors
获取教练荣誉列表
可调用(数据有范围)activebeta23 个字段→
GET
/api/v1/coaches/careers
获取教练执教履历列表
可调用(数据有范围)activebeta29 个字段→
GET
/api/v1/competitions/records
获取赛事记录列表
可调用(数据有范围)activebeta23 个字段→
GET
/api/v1/intelligences
获取情报列表
可调用activebeta23 个字段→
GET
/api/v1/matches/injuries/by-match
本场伤停
可调用(数据有范围)activebeta8 个字段→
GET
/api/v1/matches/intel/by-match
本场情报(有利 / 不利 / 伤停 / 中立)
可调用(数据有范围)activebeta5 个字段→
GET
/api/v1/matches/intelligences
获取比赛情报列表 New
可调用(数据有范围)betabeta25 个字段→
GET
/api/v1/matches/season/best/lineups
获取赛季轮次最佳阵容列表
可调用(数据有范围)activebeta26 个字段→
GET
/api/v1/player/honors
获取球员荣誉列表
可调用(数据有范围)activebeta24 个字段→
GET
/api/v1/player/market
获取球员身价列表
可调用(数据有范围)activebeta32 个字段→
GET
/api/v1/players/abilities
获取球员能力值列表
可调用activebeta4 个字段→
GET
/api/v1/players/attributes
获取球员能力值列表
可调用activebeta4 个字段→
GET
/api/v1/players/missing
获取球队伤停列表
可调用(数据有范围)activebeta25 个字段→
GET
/api/v1/players/salaries
获取球员薪资列表
可调用(数据有范围)activebeta31 个字段→
GET
/api/v1/players/transfers
获取球员转会列表
可调用activebeta27 个字段→
GET
/api/v1/rank/club
获取俱乐部排名
可调用(数据有范围)activebeta15 个字段→
GET
/api/v1/rank/fifa/live
获取FIFA实时排名
可调用(数据有范围)activebeta15 个字段→
GET
/api/v1/rank/fifa/men
获取国家队FIFA男子排名
可调用(数据有范围)activebeta19 个字段→
GET
/api/v1/rank/fifa/women
获取国家队FIFA女子排名
可调用(数据有范围)activebeta19 个字段→
GET
/api/v1/team/honors
获取球队荣誉列表
可调用(数据有范围)activebeta20 个字段→
GET
/api/v1/team/persons
获取球队教练组列表
可调用(数据有范围)activebeta27 个字段→
GET
/api/v1/teams/abilities
获取球队能力值列表
可调用activebeta0 个字段→
GET
/api/v1/teams/players
获取球队阵容列表
可调用(数据有范围)activebeta31 个字段→
GET
/api/v1/teams/records
获取球队记录列表
可调用(数据有范围)activebeta23 个字段→
GET
/api/v1/teams/squads/history
获取球队历史阵容
可调用activebeta10 个字段→

实时数据包

17
GET
/api/v1/data/delete/records
获取删除数据
可调用activebeta11 个字段→
GET
/api/v1/live
进行中比分板
可调用(数据有范围)activebeta33 个字段→
GET
/api/v1/matches/basic/statistics
获取实时统计数据
可调用(数据有范围)activebeta5 个字段→
GET
/api/v1/matches/half/statistics
获取比赛球队统计(半全场)列表
可调用(数据有范围)activebeta3 个字段→
GET
/api/v1/matches/lineup/players
获取比赛阵容详情
可调用(数据有范围)activebeta40 个字段→
GET
/api/v1/matches/lineups
获取比赛阵容详情
可调用(数据有范围)activebeta40 个字段→
GET
/api/v1/matches/realtime/events
获取实时统计数据
可调用(数据有范围)activebeta37 个字段→
GET
/api/v1/matches/realtime/live
获取实时统计数据
可调用(数据有范围)activebeta65 个字段→
GET
/api/v1/matches/realtime/trends
获取实时比赛趋势
可调用(数据有范围)activebeta14 个字段→
GET
/api/v1/matches/recent
获取变动比赛列表
可调用(数据有范围)activebeta87 个字段→
GET
/api/v1/matches/schedule/diary
获取赛程赛果列表-日期查询
可调用(数据有范围)activebeta88 个字段→
GET
/api/v1/matches/schedule/param
获取赛程赛果列表-维度查询
可调用(数据有范围)activebeta86 个字段→
GET
/api/v1/matches/standing
获取实时积分榜数据
可调用(数据有范围)activebeta65 个字段→
GET
/api/v1/matches/trend/detail
获取单场比赛趋势详情
可调用(数据有范围)activebeta12 个字段→
GET
/api/v1/matches/trends/by-match
本场进攻趋势(每分钟一条)
可调用(数据有范围)activebeta5 个字段→
GET
/api/v1/players/match/statistics
获取比赛球员统计列表
可调用(数据有范围)activebeta2 个字段→
GET
/api/v1/teams/match/statistics
获取比赛球队统计列表
可调用(数据有范围)activebeta2 个字段→

统计数据包

15
GET
/api/v1/brackets
当季淘汰赛对阵图
可调用activebeta0 个字段→
GET
/api/v1/competitions/table
获取赛事积分榜数据
可调用(数据有范围)activebeta65 个字段→
GET
/api/v1/matches/analysis
获取比赛分析数据
可调用(数据有范围)activebeta39 个字段→
GET
/api/v1/matches/analysis/by-match
本场赛前分析
可调用(数据有范围)activebeta12 个字段→
GET
/api/v1/matches/compensation/list
获取比赛历史同赔统计列表
可调用(数据有范围)activebeta50 个字段→
GET
/api/v1/matches/half/statistics/detail
获取历史比赛球队统计(半全场)数据
可调用(数据有范围)activebeta3 个字段→
GET
/api/v1/matches/live/history
获取历史比赛统计数据
可调用(数据有范围)activebeta5 个字段→
GET
/api/v1/players/match/statistics/detail
获取历史比赛球员统计数据
可调用(数据有范围)activebeta2 个字段→
GET
/api/v1/scorers
某赛事射手榜
可调用activebeta0 个字段→
GET
/api/v1/scorers/leagues
有射手榜的赛事清单
可调用(数据有范围)activebeta5 个字段→
GET
/api/v1/season/brackets
获取淘汰阶段对阵图数据
可调用activebeta0 个字段→
GET
/api/v1/standing
积分榜(带我方球队 id)
可调用(数据有范围)activebeta35 个字段→
GET
/api/v1/teams/match/statistics/detail
获取历史比赛球队统计数据
可调用(数据有范围)activebeta2 个字段→
GET
/api/v1/teams/season/statistics
获取赛事统计详情
可调用activebeta0 个字段→
GET
/api/v1/teams/season/statistics/old
获取赛事统计详情
可调用activebeta0 个字段→

基础数据包

13
GET
/api/v1/categories
获取分类列表
可调用activebeta12 个字段→
GET
/api/v1/coaches
获取教练列表
可调用(数据有范围)activebeta31 个字段→
GET
/api/v1/competition/rules
获取赛事赛制列表
可调用(数据有范围)activebeta28 个字段→
GET
/api/v1/continents
获取大洲/地区分类列表
可调用activebeta0 个字段→
GET
/api/v1/countries
获取国家/地区列表
可调用(数据有范围)activebeta14 个字段→
GET
/api/v1/honors
获取荣誉列表
可调用(数据有范围)activebeta9 个字段→
GET
/api/v1/leagues
获取赛事列表
可调用(数据有范围)activebeta38 个字段→
GET
/api/v1/players
获取球员列表
可调用(数据有范围)activebeta44 个字段→
GET
/api/v1/referees
获取裁判列表
可调用(数据有范围)activebeta26 个字段→
GET
/api/v1/seasons
获取赛季列表
可调用(数据有范围)activebeta22 个字段→
GET
/api/v1/stages
获取阶段列表
可调用(数据有范围)activebeta24 个字段→
GET
/api/v1/teams
获取球队列表
可调用(数据有范围)activebeta42 个字段→
GET
/api/v1/venues
获取场馆列表
可调用activebeta26 个字段→

我方扩展

5
GET
/api/v1/logos
获取图标资产列表(球队/赛事/球员/分类 logo)
可调用activebeta8 个字段→
GET
/api/v1/player/appearances
球员近期出场
可调用activebeta0 个字段→
GET
/api/v1/player/summary
球员生涯小结(出场、进球、能力值、荣誉)
可调用activebeta2 个字段→
GET
/api/v1/search
全局搜索(球队 / 球员 / 赛事)
可调用activebeta3 个字段→
GET
/api/v1/team/summary
球队资料(荣誉、历史阵容、能力值)
可调用activebeta5 个字段→

资料库数据包

5
GET
/api/v1/matches/basics
获取比赛列表
可调用(数据有范围)activebeta87 个字段→
GET
/api/v1/matches/schedule/season
获取赛程赛果列表-赛季查询
可调用(数据有范围)activebeta0 个字段→
GET
/api/v1/players/season/statistics
获取赛季统计详情
可调用(数据有范围)activebeta66 个字段→
GET
/api/v1/players/season/statistics/old
获取赛季统计详情
可调用(数据有范围)activebeta66 个字段→
GET
/api/v1/seasons/table
获取赛季积分榜数据
可调用(数据有范围)activebeta65 个字段→

指数数据包

5
GET
/api/v1/matches/odds
获取实时指数数据
可调用(数据有范围)activebeta19 个字段→
GET
/api/v1/matches/odds/bookmakers
获取百欧公司列表
可调用(数据有范围)activebeta0 个字段→
GET
/api/v1/matches/odds/by-match
本场各公司指数
可调用(数据有范围)activebeta17 个字段→
GET
/api/v1/matches/odds/histories
获取单场比赛指数数据
可调用(数据有范围)activebeta21 个字段→
GET
/api/v1/matches/odds/live
获取实时指数数据(专题包)
可调用(数据有范围)activebeta22 个字段→

动画直播组件

5
GET
/api/v1/widget/app-keys
动画直播组件:App Key 列表、今日观看和被拒次数
需单独开通activebeta2 个字段→
GET
/api/v1/widget/configs
动画直播组件:本账户保存的配置
需单独开通activebeta15 个字段→
GET
/api/v1/widget/options
动画直播组件:本账户可用的画面、模板、布局和模块
需单独开通activebeta5 个字段→
GET
/api/v1/widget/stats
动画直播组件:当前在线和今日观看
需单独开通activebeta2 个字段→
POST
/api/v1/widget/token
动画直播组件:换嵌入令牌(只在服务端调用)
需单独开通activebeta3 个字段→

实体

3
GET
/api/v1/competitions/global
全局赛事(去重合并,一赛事一行)
可调用(数据有范围)activebeta12 个字段→
GET
/api/v1/players/global
全局球员(去重合并 + 深度资料)
可调用(数据有范围)activebeta20 个字段→
GET
/api/v1/teams/global
全局球队(去重合并,一队一行)
可调用(数据有范围)activebeta14 个字段→

全局

3
GET
/api/v1/competitions/global
全局赛事(去重合并,一赛事一行)
可调用(数据有范围)activebeta12 个字段→
GET
/api/v1/players/global
全局球员(去重合并 + 深度资料)
可调用(数据有范围)activebeta20 个字段→
GET
/api/v1/teams/global
全局球队(去重合并,一队一行)
可调用(数据有范围)activebeta14 个字段→

按比赛

3
GET
/api/v1/matches/events/by-match
按比赛取事件时间线
可调用(数据有范围)activebeta9 个字段→
GET
/api/v1/matches/lineups/by-match
按比赛取一份全局阵容
可调用(数据有范围)activebeta12 个字段→
GET
/api/v1/matches/stats/by-match
按比赛取技术统计
可调用(数据有范围)activebeta11 个字段→

账户

2
GET
/api/v1/account
本 Key 的账户信息:组织、套餐、限额、实时推送到期时间
可调用activebeta6 个字段→
GET
/api/v1/account/usage
本 Key 每天的调用量
可调用activebeta5 个字段→

机制

2
GET
/api/v1/archive
数据归档导出(机制类)
可调用activebeta0 个字段→
GET
/api/v1/data/more/update
增量更新游标(机制类)
可调用(数据有范围)activebeta9 个字段→

字典

1
GET
/api/v1/dict
标准枚举字典(状态/位置/事件/统计/VAR/原因)
可调用activebeta7 个字段→

枚举

1
GET
/api/v1/dict
标准枚举字典(状态/位置/事件/统计/VAR/原因)
可调用activebeta7 个字段→

多语言

1
GET
/api/v1/language_translations
获取实体名称多语言对照(英→中)
可调用activebeta3 个字段→

资产

1
GET
/api/v1/logos
获取图标资产列表(球队/赛事/球员/分类 logo)
可调用activebeta8 个字段→

事件

1
GET
/api/v1/matches/events/by-match
按比赛取事件时间线
可调用(数据有范围)activebeta9 个字段→

阵容情报

1
GET
/api/v1/matches/lineup/intelligences
获取阵容相关情报(伤停/缺阵)
可调用(数据有范围)betabeta10 个字段→

阵容

1
GET
/api/v1/matches/lineups/by-match
按比赛取一份全局阵容
可调用(数据有范围)activebeta12 个字段→

实时

1
GET
/api/v1/matches/realtime/text/live
获取文字直播(从比赛事件派生解说)
可调用(数据有范围)activebeta0 个字段→

文字直播

1
GET
/api/v1/matches/realtime/text/live
获取文字直播(从比赛事件派生解说)
可调用(数据有范围)activebeta0 个字段→

统计

1
GET
/api/v1/matches/stats/by-match
按比赛取技术统计
可调用(数据有范围)activebeta11 个字段→

新闻资讯数据包

1
GET
/api/v1/news
获取资讯列表
可调用activebeta33 个字段→

实时推送

1
POST
/api/v1/realtime/ticket
获取 WS 连接票据(60 秒、单次有效)
可调用activebeta3 个字段→

兼容接口里暂不提供的

15

从其他数据服务迁移时可以对照:下面这些兼容接口路径我们目前不提供,后面写了原因。

GET
/api/v5/football/match/stream/urls_free
获取版权比赛直播地址 · 不提供:没有直播版权
不提供
GET
/api/v5/football/match/stream/video_collection
获取版权比赛集锦录像地址 · 不提供:集锦只对内部开放(/api/v1/matches/video)
不提供
GET
/api/v5/football/match/highlight/detail
获取比赛事件动图 · 不提供:没有事件动图来源
不提供
GET
/api/v5/football/odds/bf/live
获取实时必发数据 · 不提供:必发数据只对内部开放
不提供
GET
/api/v5/football/odds/bf/history
获取单场比赛必发数据 · 不提供:必发数据只对内部开放
不提供
GET
/api/v5/sports/lottery/revise
获取体彩数据修正 · 不提供:体彩数据只对内部开放
不提供
GET
/api/v2/sports/lottery/match/list
获取体彩比赛关联列表 · 不提供:体彩数据只对内部开放
不提供
GET
/api/v2/sports/jc/odds
获取竞彩比赛指数 · 不提供:体彩数据只对内部开放
不提供
GET
/api/v2/sports/jc/result
获取竞彩比赛开奖结果 · 不提供:体彩数据只对内部开放
不提供
GET
/api/v2/sports/bd/odds
获取北单指数 · 不提供:体彩数据只对内部开放
不提供
GET
/api/v2/sports/bd/result
获取北单开奖结果 · 不提供:体彩数据只对内部开放
不提供
GET
/api/v2/sports/bd/sf_odds
获取北单胜负过关指数 · 不提供:体彩数据只对内部开放
不提供
GET
/api/v2/sports/bd/sf_result
获取北单胜负过关开奖结果 · 不提供:体彩数据只对内部开放
不提供
GET
/api/v2/sports/zc/matches
获取传统足彩赛程 · 不提供:体彩数据只对内部开放
不提供
GET
/api/v2/sports/zc/result
获取传统足彩开奖结果 · 不提供:体彩数据只对内部开放
不提供

规划中的接口

12

下面这些接口还在开发，暂时不能调用;上线后会出现在上面的目录里。

GET
/api/v1/betfair/markets
规划中
GET
/api/v1/betfair/volumes
规划中
GET
/api/v1/competitions
规划中
GET
/api/v1/ctzc/issues
规划中
GET
/api/v1/jczq/odds
规划中
GET
/api/v1/matches/detail
规划中
GET
/api/v1/matches/incidents
规划中
GET
/api/v1/matches/stats
规划中
GET
/api/v1/matches/tlive
规划中
GET
/api/v1/players/honors
规划中
GET
/api/v1/teams/honors
规划中
GET
/api/v1/teams/squad
规划中