🏊 世界泳联游泳数据开放 API
把世界泳联(World Aquatics)官方游泳世界排名接入你的应用:覆盖男子/女子/混合、自由泳/仰泳/蛙泳/蝶泳/混合泳、长池 50m 与短池 25m,按年份收录各小项前 200 名,含成绩、世界积分、纪录标签、选手、国家与俱乐部;并提供运动员档案与游泳纪录。
36小项
389,696排名记录
29,076运动员
246国家/地区
1915–2026覆盖年份
① 开通 世界泳联游泳数据 API 仅注册用户 · 支付后立即发放 Key
本服务为付费服务,且仅限注册用户开通。请先登录(或注册),登录后在本页在线支付,支付成功立即获得专属 API Key。
登录 / 注册后开通
② 调用方式
在请求头携带 X-API-Key(推荐),或加查询参数 ?key=***。返回统一为 JSON:{"ok":true,"code":200,"data":{...}}
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/swim/overview"
响应头会返回当日配额:X-Quota-Limit / X-Quota-Used。超限返回 429,Key 无效返回 401,未开通/到期返回 403。
③ 接口列表 全部为 GET · 本服务 ¥1299/年
GET/api/ow/swim/overview
数据概览:小项/排名/运动员/国家/纪录数量、覆盖年份、字段说明与全部接口路径。
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/swim/overview"
GET/api/ow/swim/events
小项字典(中文名 / 英文名 / 性别 / 距离 / 泳姿 / 泳池 / 收录年份数)。
| 参数 | 必填 | 说明 |
|---|
| gender | 否 | M 男子 / F 女子 / X 混合 |
| pool | 否 | LCM 长池 50m / SCM 短池 25m |
| stroke | 否 | FREESTYLE / BACKSTROKE / BREASTSTROKE / BUTTERFLY / MEDLEY |
| distance | 否 | 50 / 100 / 200 / 400 / 800 / 1500 |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/swim/events?gender=M&pool=LCM"
GET/api/ow/swim/rankings
核心接口:分年榜单(名次 / 成绩 / 世界积分 / 纪录标签 / 选手 / 国家 / 俱乐部 / 赛事 / 日期)。
| 参数 | 必填 | 说明 |
|---|
| event | 否 | 小项 slug 或中文名,如 mens-50m-freestyle / 男子50米自由泳 |
| year | 否 | 年份(按成绩发生年份),如 2025 |
| gender | 否 | M / F / X(不指定 event 时可按维度筛选) |
| pool | 否 | LCM / SCM |
| stroke | 否 | 泳姿(英文枚举) |
| distance | 否 | 距离(米) |
| country | 否 | 国家/地区三字码,如 CHN |
| q | 否 | 运动员姓名模糊检索 |
| limit / offset | 否 | limit 最大 200(默认 50),offset 分页 |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/swim/rankings?event=mens-50m-freestyle&year=2025&limit=50"
GET/api/ow/swim/athletes
运动员列表(中文名优先 / 拉丁名 / 国家 / 生日 / 头像),每人附带各小项最好名次。
| 参数 | 必填 | 说明 |
|---|
| country | 否 | 三字码,如 CHN |
| q | 否 | 姓名检索(中/英均可) |
| photo | 否 | =1 只返回有头像的运动员 |
| limit / offset | 否 | limit 最大 200(默认 50) |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/swim/athletes?country=CHN&limit=50"
GET/api/ow/swim/athlete
单个运动员档案 + 全部收录成绩(按年份倒序)。
| 参数 | 必填 | 说明 |
|---|
| id | 是 | 运动员唯一 ID(UUID,榜单/列表接口返回的 athlete_id) |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/swim/athlete?id=<UUID>"
GET/api/ow/swim/records
游泳纪录(世界纪录 WR / 奥运纪录 OR 等),含创造者、国家与创造日期。
| 参数 | 必填 | 说明 |
|---|
| pool | 否 | LCM / SCM |
| gender | 否 | M / F |
| code | 否 | 纪录类型前缀,如 WR |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/swim/records?pool=LCM&gender=M"
GET/api/ow/swim/countries
国家/地区字典(三字码 / 中文名 / 英文名 / 大洲 / 国旗图)。
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/swim/countries"
④ 返回示例
{
"ok": true,
"code": 200,
"data": {
"total": 200, "count": 3, "offset": 0, "limit": 50,
"list": [
{ "event_slug": "mens-50m-freestyle", "event": "Men's 50m Freestyle", "year": 2026,
"rank": 1, "time": "20.88", "time_ms": 20880, "fina_points": 1004,
"record_tag": "WR", "athlete_id": "88356002-...", "athlete": "CROOKS Jordan",
"country": "AUS", "club": "", "event_name": "World Aquatics Championships", "event_city": "Budapest",
"result_date": "2024-12-14", "dob": "2002-05-02", "gender": "M", "pool": "LCM" }
]
}
}
字段说明:gender M/F/X · pool LCM 长池 / SCM 短池 · record_tag WR 世界纪录 / OR 奥运纪录 / CR 世锦赛纪录 / NR 国家纪录 · time_ms 便于数值排序比较。
错误码:401 Key 缺失/无效 · 403 Key 未开通/已停用/已到期 · 404 未找到数据 · 429 超出当日配额 · 422 参数错误。
⑤ 使用条款
1. 数据整理自世界泳联(World Aquatics)官方公开渠道,已做中文化与结构化整理,仅供研究与产品展示参考;
2. 每小项每年收录前 200 名(官方接口上限),成绩为历史最佳成绩汇总,并非实时赛果;
3. 请注明数据来源"鸥维数据(www.oweidata.com)";不得转售原始数据或用于违法用途;
4. 服务期一年,到期可续费;如有大规模调用需求可联系我们提额。
