足球实时比分API使用教程

在体育类应用中，数据往往决定了用户体验的上限。无论是做一个简单的比分小程序，还是一个完整的赛事分析平台，如何获取及时、准确、结构化的比赛数据，都是最核心的问题之一。

这正是比分 API 的价值所在。

通过接入足球比分 API，开发者无需自己采集或维护数据源，就可以快速获得：

• 联赛、球队、队员信息
• 实时比分
• 历史交锋记录

这些数据可用于基础展示（如比分页、赛程页），还能进一步用于数据分析，尤其是实时比分往往比电视转播的速度要快，用来搭配最近大火的Polymarket，能大大提升预测胜率。

下面将基于AnySport的实时比分接口，详细介绍如何使用这类API获取数据。

1. 赛事接口：GET /v1/matches

返回足球赛程和比赛结果。支持按日期范围、联赛、球队或指定比赛 ID 过滤。

1.1 查询参数

参数	类型	必填	默认值	说明
date	string	否	今天	单日日期，格式 YYYY-MM-DD。等同于 from=date&to=date。
from	string	否	—	开始日期，格式 YYYY-MM-DD。与 to 配合使用查询日期范围。
to	string	否	—	结束日期，格式 YYYY-MM-DD。与 from 配合使用查询日期范围。
league_id	string	否	—	按联赛 ID 过滤。ID 可从 /v1/leagues 获取。
team_id	string	否	—	按球队 ID 过滤，返回该球队参与的比赛。ID 可从 /v1/teams 获取。
match_id	string	否	—	按比赛唯一 ID 查询单场比赛。
lang	string	否	en	响应语言，影响球队/联赛/国家名称。支持：en、zh。
page	integer	否	1	分页页码。
limit	integer	否	50	每页结果数量，最大 200。

1.2 赛事接口请求示例

import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://api.anysport.io/v1'
# 申请API Key: www.anysport.io

def get_matches(date=None, from_date=None, to_date=None,
                league_id=None, team_id=None, match_id=None,
                lang='zh', page=1, limit=50):
    params = {'lang': lang, 'page': page, 'limit': limit}
    if date:      params['date'] = date
    if from_date: params['from'] = from_date
    if to_date:   params['to'] = to_date
    if league_id: params['league_id'] = league_id
    if team_id:   params['team_id'] = team_id
    if match_id:  params['match_id'] = match_id

    r = requests.get(
        f'{BASE_URL}/matches',
        params=params,
        headers={'X-API-Key': API_KEY}
    )
    r.raise_for_status()
    return r.json()

# 获取英超指定日期比赛（中文名称）
result = get_matches(date='2026-03-16', league_id='148', lang='zh')
for match in result['data']:
    print(f"{match['home']} {match['score']} {match['away']}")

2. 实时比分接口 GET /v1/livescore

实时返回所有正在进行中的足球比赛，包括进球、出牌、换人和比赛数据统计。

2.1 查询参数

参数	类型	必填	默认值	说明
league_id	string	否	—	按联赛 ID 过滤。ID 可从 /v1/leagues 获取。
country_id	string	否	—	按国家 ID 过滤。ID 可从 /v1/countries 获取。
match_id	string	否	—	查询指定比赛的实时数据。
lang	string	否	en	响应语言，影响球队/联赛/国家名称。支持：en、zh。
page	integer	否	1	分页页码。
limit	integer	否	50	每页结果数量，最大 200。

2.2 实时比分请求示例

import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://api.anysport.io/v1'
# 申请API Key: www.anysport.io

def get_livescore(league_id=None, country_id=None, match_id=None, lang='zh'):
    params = {'lang': lang}
    if league_id:  params['league_id'] = league_id
    if country_id: params['country_id'] = country_id
    if match_id:   params['match_id'] = match_id

    r = requests.get(
        f'{BASE_URL}/livescore',
        params=params,
        headers={'X-API-Key': API_KEY}
    )
    r.raise_for_status()
    return r.json()

result = get_livescore(league_id='148', lang='zh')
for match in result['data']:
    print(f"{match['home']} {match['score']} {match['away']}（第{match['minute']}分钟）")

2.3 实时比分接口的响应字段

字段	类型	说明
status	string	"live"（上半场/下半场）、"ht"（中场休息）、"extra_time"（加时赛）、"penalties"（点球）
minute	integer	当前比赛分钟（如 67）。中场休息时为 null。
live	boolean	此接口返回的所有比赛均为 true
score	string	当前比分，格式 "主队-客队"（如 "2-1"）
ht_score	string \| null	半场比分。上半场未到中场时为 null。
goals	Goal[]	到目前为止的进球记录（按时间排序）
cards	Card[]	到目前为止的出牌记录
subs	Substitution[]	到目前为止的换人记录
stats	StatEntry[]	当前比赛数据统计

3. 联赛积分榜查询 GET /v1/standings

返回指定联赛的当前积分榜。响应包含三张独立的积分表：总积分榜、主场积分榜和客场积分榜。代码示例如下:

import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://api.anysport.io/v1'
# 申请API Key: www.anysport.io

def get_standings(league_id, lang='zh'):
    r = requests.get(
        f'{BASE_URL}/standings',
        params={'league_id': league_id, 'lang': lang},
        headers={'X-API-Key': API_KEY}
    )
    r.raise_for_status()
    return r.json()

result = get_standings('148', lang='zh')
total_table = result['data']['total']

for row in total_table:
    print(f"{row['position']}. {row['team']} — {row['points']}分 (胜{row['wins']} 平{row['draws']} 负{row['losses']})")

4. 历史交锋 GET /v1/head2head

返回两支球队的历史交锋记录，以及各自的近期赛事数据。需要传入两个队伍ID：

import requests

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

def get_head2head(team1_id, team2_id, lang='zh'):
    r = requests.get(
        f'{BASE_URL}/head2head',
        params={'team1_id': team1_id, 'team2_id': team2_id, 'lang': lang},
        headers={'X-API-Key': API_KEY}
    )
    r.raise_for_status()
    return r.json()

result = get_head2head('85', '42', lang='zh')
history = result['data']['history']

for match in history:
    print(f"{match['date']}: {match['home']} {match['score']} {match['away']}")

AnySport提供的数据远不止这些，这里篇幅有限就不一一展开，有兴趣的同学可以自行查看**官方文档**。