快速开始 - AnySport

5 分钟内接入 AnySport 足球数据 API。

第一步：获取 API Key

前往 dashboard.anysport.io 注册账号。
验证邮箱后，系统会自动跳转到控制台。
控制台首页显示你的 API Key，复制它。

第二步：认证方式

将 API Key 放入请求头 X-API-Key（推荐），或作为查询参数 api_key 附加在 URL 上。

curl -H "apikey: YOUR_API_KEY" \
  "https://data.anysport.io/v1/soccer/matches?date=2026-07-20"

第三步：发起第一个请求（查询当天赛程）

curl -H "apikey: YOUR_API_KEY" \
  "https://data.anysport.io/v1/soccer/matches?date=2026-07-20&lang=zh-CN"

const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://data.anysport.io/v1/soccer';

const res = await fetch(`${BASE_URL}/matches?date=2026-07-20&lang=zh-CN`, {
  headers: { 'X-API-Key': API_KEY }
});
const { data } = await res.json();
console.log(data);

import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://data.anysport.io/v1/soccer'

r = requests.get(
    f'{BASE_URL}/matches',
    params={'date': '2026-07-20', 'lang': 'zh-CN'},
    headers={'X-API-Key': API_KEY}
)
r.raise_for_status()
matches = r.json()['data']

示例响应（统一响应信封 success / data / meta / traceId，完整字段说明见赛程列表）：

{
  "success": true,
  "data": [
    {
      "match_id": "as_37f0da0520bb4e9a9588f80994cefc5b",
      "date": "2026-07-20",
      "time": "19:00",
      "status": "FT",
      "league": "World Cup",
      "league_id": "asl_62db9cfc3ebf4b87a44570b16668b23e",
      "season": "2026",
      "home": {
        "name": "England",
        "team_id": "ast_13e4e7eccd7640de91c13cffcf0c3ff2"
      },
      "away": {
        "name": "Argentina",
        "team_id": "ast_9137ee449e3b40a68149ca319373adaf"
      },
      "ht_score": "1-0",
      "ft_score": "2-1",
      "venue": ""
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 50,
    "total_pages": 1,
    "timestamp": "2026-07-20T10:00:00.000Z"
  },
  "traceId": "f11f21f6-0b68-438d-94b7-c8622470176f"
}

第四步：发现进行中的比赛并获取实时比分

/livescore 按单场 match_id 查询，因此先要”发现”一场比赛，再拿它的比分，这是两步流程： 1）用相对日期查今天的赛程，按 status 形态判断哪些在进行中（详见近期赛程）：

curl -H "apikey: YOUR_API_KEY" \
  "https://data.anysport.io/v1/soccer/matches/window?from_days=0&to_days=0"

status 为纯数字分钟或 HT 即为进行中；记下该场的 match_id。 2）用拿到的 match_id 查实时比分（详见实时比分）：

curl -H "apikey: YOUR_API_KEY" \
  "https://data.anysport.io/v1/soccer/livescore?match_id=as_3b37c382f39a4235aa93705f053b2da4"

async function getLiveScore(matchId) {
  const res = await fetch(
    `${BASE_URL}/livescore?match_id=${matchId}`,
    { headers: { 'apikey': API_KEY } }
  );
  const { data } = await res.json();
  return data[0];
}

下一步

查看接口文档索引：按「基础数据 → 赛程与对阵 → 实时 Feed → 系统/元数据」分类列出全部 19 个接口，并给出推荐的接入顺序。
需要多语言展示？先调用支持的语言拿到当前开放的 lang 取值，再把 lang 参数带到各接口。
想接入赔率盘口？赛前用赛前赔率，滚球实时盘口用滚球赔率。