斗球体育数据平台 API

为开发者提供实时比分、直播流、球队Logo等体育数据接口

认证与接入

Base URL

https://douqiu.yy.la/v1

认证方式 (二选一)

1. Header: X-API-Key: dq_public_2026

2. 查询参数: ?api_key=dq_public_2026

测试 Key

dq_public_2026 100次/分钟

通用响应结构

{
  "code": 200,
  "data": { ... },
  "meta": { "total": 50, "page": 1, "per_page": 50 },
  "timestamp": 1778845000000
}

错误码

Code	说明
`200`	成功
`401`	缺少 API Key
`403`	API Key 无效或禁用
`404`	资源不存在
`429`	请求过于频繁 (超出限频)
`500`	服务器内部错误

比赛数据

GET /v1/matches 获取比赛列表

参数	类型	说明
`date`	string	日期 YYYY-MM-DD
`sport_type`	int	1足球 2篮球 5网球
`status`	int	1未开始 2进行中 3已结束
`league_id`	int	联赛ID
`page`	int	页码(默认1)
`per_page`	int	每页数量(默认50,最大200)

GET /v1/matches/today 今日比赛(按状态分组)

参数	类型	说明
`sport_type`	int	运动类型(默认1)
`date`	string	日期(默认今天)

GET /v1/matches/live 获取进行中比赛

参数	类型	说明
`sport_type`	int	运动类型(默认1)

GET /v1/matches/:id 比赛详情

返回比赛完整详情，包含双方球队、比分、赔率、实时事件等。

GET /v1/matches/:id/events 比赛事件(进球/红黄牌/换人)

返回指定比赛的所有实时事件列表。

GET /v1/matches/:id/odds 比赛赔率

参数	类型	说明
`type`	int	0全部 1亚盘 2欧赔 3大小球

POST /v1/matches/search 搜索比赛

Body (JSON):

{
  "keyword": "曼联",
  "date_from": "2026-05-01",
  "date_to": "2026-05-16",
  "league_id": 9,
  "sport_type": 1
}

联赛

GET /v1/leagues 联赛列表

参数	类型	说明
`sport_type`	int	运动类型(默认1)

GET /v1/leagues/:id/standings 联赛积分榜

返回联赛当前赛季积分榜排名。

直播 - PlazaFM

GET /v1/live/rooms 直播间列表

参数	类型	说明
`page`	int	页码(默认1)
`per_page`	int	每页数量(默认50,最大100)
`live_type`	int	1娱乐 2游戏 3体育 4电竞

GET /v1/live/rooms/:roomId 单个直播间详情

返回指定直播间的详细信息，包括主播、人气值、封面等。

GET /v1/live/streams/:roomId 获取直播流地址

参数	类型	必填	说明
`anchorId`	string	是	主播ID(从rooms列表获取)

返回 sd/ud 两种清晰度，每种含 m3u8/flv/rtmp 三种格式。推荐使用 ud.m3u8。

CDN: live.dtdgc.com (阿里云直播，无防盗链)

直播 - YYZB

GET /v1/yyzb/rooms YYZB 直播间列表

参数	类型	说明
`page`	int	页码(默认1)
`per_page`	int	每页数量(默认50,最大100)
`live_type_parent`	int	1娱乐 2体育 3游戏
`nocache`	int	1=强制刷新缓存

GET /v1/yyzb/rooms/:roomNum 房间详情+流地址

返回房间详情和直播流地址。

GET /v1/yyzb/streams/:roomNum YYZB 流地址(简化版)

CDN: pullsgp.yyzb456.top (华为云CDN，需代理播放)

如需浏览器播放，通过 /yyzb/stream/m3u8?url= 代理请求。

现场原声 (178直播)

对接 jk.jkjqtv.com 加密接口，AES-128-ECB 解密后提取现场原声分类房间。

GET /jk/live/list 现场原声直播列表

后端自动解密并提取 data[] 中 title="现场原声" 的分类。

返回字段	类型	说明
`code`	int	200=成功
`total`	int	房间总数
`list`	array	房间列表

房间对象字段

字段	类型	说明
`room_id`	int	房间ID
`room_title`	string	房间标题(比赛名称)
`nickName`	string	主播名称(如"足球直播")
`portrait`	string	主播头像URL
`room_cover`	string	房间封面URL
`live_url`	string	HLS直播流地址(M3U8)
`live_status`	int	1=直播中
`heat`	int	热度值
`match_type_name`	string	比赛类型(足球/篮球/CS:GO)
`live_type`	int	2=现场原声
`match_id`	int	比赛ID
`short_name_zh`	string	联赛名称

GET /jk/stream/m3u8?url= M3U8 流代理

代理播放 M3U8 直播流，绕过防盗链。TS 分片自动替换为本地代理路径。

参数	类型	必填	说明
`url`	string	是	原始M3U8地址(需URL编码)

PandaScore 直播源解析

通过逆向 www.pandascore.live Nuxt.js 前端，提取其内部 Java API 接口，可直接获取实时直播流地址。

基础信息

项目	说明
Base URL	`https://www.pandascore.live`
请求头	`lan: en` `sysType: PC` `Accept: application/json`
CDN	`pull.pandascore.vip` (火山引擎)，URL 带 `txSecret`/`txTime` 腾讯云 LVB 签名
防盗链	需 `Referer: https://www.pandascore.live/`
DNS	Cloudflare CDN，建议用 `1.1.1.1` 解析

1. 获取分类标签

GET /java/v2/match/liveMemus 获取直播分类标签

返回所有直播分类 tab，每个 tab 有 id 和 tabContent（包含的游戏类型 ID 列表）。

响应: { errorCode:null, result:[{ tabName, id, tabContent:[gameId,...], customTags }] }

常用 tab

tabName	id	覆盖游戏
推荐 (Hot)	`668cfbb063abf516827a2dc4`	全部(体育+电竞)
足球	`65ae42b7186eed6d03f21c12`	202
篮球	`65ae42c8186eed6d03f21c13`	201
电竞	`65ae42e0186eed6d03f21c14`	1,2,3,4,7,14

2. 获取直播列表（核心接口）

GET /java/v3/search/gameMatchLive 获取直播比赛列表

参数	必填	说明
`id`	是	tab ID (从 liveMemus 获取)
`keyword`	否	搜索关键词
`typeScreen`	否	筛选类型

用 "推荐" tab ID 可一次性获取所有体育+电竞直播。

请求示例

GET /java/v3/search/gameMatchLive?id=668cfbb063abf516827a2dc4&keyword=&typeScreen=
Host: www.pandascore.live
lan: en
sysType: PC

响应字段

字段	类型	说明
`matchId`	int	比赛/流 ID
`gameId`	int	游戏类型 ID
`homeName`	string	主队/主播名
`awayName`	string	客队名
`leagueName`	string	联赛名
`liveUrl`	string	HLS (M3U8) 直播流地址
`liveUrlFlv`	string	FLV 直播流地址
`liveImage`	string	封面图 URL
`hotValue`	int	热度值
`startTime`	int	开始时间戳
`roomId`	int	房间 ID
`anchorName`	string	主播名

3. 流地址解析

STREAM pull.pandascore.vip 直播流 CDN 格式

直播流地址格式：

# 体育流
https://pull.pandascore.vip/sport/{gameId}_{matchId}_1.m3u8?txSecret=xxx&txTime=6A2XXXXX
https://pull.pandascore.vip/sport/{gameId}_{matchId}_1.flv?txSecret=xxx&txTime=6A2XXXXX

# 电竞流
https://pull.pandascore.vip/esport/{gameId}_{matchId}_1.m3u8?txSecret=xxx&txTime=6A2XXXXX
https://pull.pandascore.vip/esport/{gameId}_{matchId}_1.flv?txSecret=xxx&txTime=6A2XXXXX

txSecret/txTime 为腾讯云 LVB 防盗链签名，有时效性，需实时从 API 获取。

4. 游戏类型 ID 对照

gameId	游戏	分类
202	足球	体育
201	篮球	体育
213	棒球	体育
211	网球	体育
214	乒乓球	体育
215	羽毛球	体育
216	排球	体育
204	斯诺克	体育
210	板球	体育
217	美式足球	体育
1	英雄联盟	电竞
2	CS2	电竞
3	王者荣耀	电竞
4	Dota2	电竞
7	LOL手游	电竞
14	无畏契约	电竞

5. 辅助接口

GET /java/game/list 游戏类型列表

返回所有可用的 gameId 列表: [202,201,1,2,4,3,7,217,215,213,210,204,216,14,214,211]

GET /java/v2/match/hot?pageIndex=0&pageSize=N&id=X 热门比赛列表（含赛前数据）

返回指定 tab 下的比赛列表，含赛程信息、比分等。适合获取未来或历史比赛数据。

注意: 该接口不返回直播流地址（liveUrl），仅用于赛程/比分。

GET /v1/logos/teams 球队列表

参数	类型	说明
`sport`	int	1足球 2篮球
`league_id`	int	联赛ID过滤(如9=英超)
`keyword`	string	球队名模糊搜索
`ids`	string	批量ID,逗号分隔(35,1211,1221)
`page`	int	页码(默认1)
`per_page`	int	每页数量(默认50,最大200)

GET /v1/logos/leagues 联赛列表

参数	类型	说明
`sport`	int	1足球 2篮球
`keyword`	string	联赛名模糊搜索
`ids`	string	批量ID,逗号分隔

GET /v1/logos/search 综合搜索(球队+联赛)

参数	类型	必填	说明
`keyword`	string	是	搜索关键词
`limit`	int	否	每类最大返回数(默认20)

限频说明

Header	说明
`X-RateLimit-Limit`	每分钟限制次数
`X-RateLimit-Remaining`	本窗口剩余次数

联赛 ID 参考

2=欧冠 9=英超 3=西甲 21=德甲 15=意甲 20=法甲 227=中超 580=NBA 673=CBA

JSON 文档: /docs/api.json

如需更高限频或商务合作，请联系管理员。