您需要本周可以交付的实时体育数据:博彩公司提供的团队胜利赔率、新的团队/球员新闻,以及您可以直接插入应用程序的网球比赛日历,而无需抓取。通过本指南的结束,您将能够查询 FlashScore - 实时 API 以获取这些数据集,使用可复制粘贴的请求,解析响应,并将其连接到您的产品或定时作业中。
您可以使用 FlashScore - 实时 API 构建的内容
FlashScore - 实时 API 提供了结构化的体育数据,准备好用于生产:
- 博彩公司提供的团队胜利赔率,带有“最佳”和“活跃”标志,您可以用来突出市场领先价格。
- 特定团队和球员的最新新闻,包括标题、链接、来源、图片和发布时间(作为纪元时间戳)。
- 网球比赛日历(提供示例),包含比赛元数据、场地、时间表、国家和获胜者详细信息。
典型的用例包括体育博彩比较小部件、投注内容页面、具有针对性新闻源的粉丝应用、基于球员/团队提及的 CRM/电子邮件个性化,以及网球时间表模块。所有内容通过 Zyla API Hub 以 HTTPS 运行,因此您可以在数千个 API 中使用单个 API 密钥和订阅。
在 Zyla API Hub 上开始
打开 API 页面,点击订阅或开始 7 天试用,并获取您的 API 密钥。每个请求的身份验证通过 Authorization: Bearer YOUR_API_KEY。计费是订阅 + 配额(不是按调用计费)。没有免费计划;第一个 API 包括 7 天试用或 50 次请求——请查看 API 页面以获取当前访问选项和定价。
- 开始 FlashScore - 实时 API 的 7 天试用
- 在 Zyla API Hub 探索超过 10,000 个公共 API
您今天可以交付的端点
以下是本文中提供的端点,包括确切的请求 URL 和方法。所有请求必须包含 Authorization: Bearer YOUR_API_KEY 头。
1) 获取团队胜利赔率
返回特定团队在每个比赛中获胜的赔率,按博彩公司分类。
- 方法:GET
- URL: https://zylalabs.com/api/12518/flashscore-live-api/40619/get-team-winner-odds
- 查询参数:
- team_id(字符串,必需):例如,Wtn9Stg0
- geo_ip_code(字符串,可选):例如,GB(用于按地区限制博彩公司可用性)
cURL(复制粘贴):
curl -s -X GET "https://zylalabs.com/api/12518/flashscore-live-api/40630/get-tennis-tournament-calendar?type=atp" \
-H "Authorization: Bearer YOUR_API_KEY"
实施者注意事项:
- 使用 is_best 来突出当前的最佳价格。
- 仅在用户体验需要的地方显示活跃市场(is_active)。
- 同一团队可能出现在多个比赛中;遍历所有数组项。
2) 获取球员新闻
返回有关特定球员的最新新闻文章,包括标题、链接、图片、来源和发布时间。
- 方法:GET
- URL: https://zylalabs.com/api/12518/flashscore-live-api/40617/get-player-news
- 查询参数:
- player_id(字符串,必需):例如,dMPo6IPH
cURL(供参考):
示例响应:
[
{
"name": "Brisbane ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/brisbane/",
"start_timestamp": 1767510600,
"end_timestamp": 1768104000,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "O8qG0Nhb",
"name": "Medvedev Daniil",
"player_url": "/player/medvedev-daniil/O8qG0Nhb/",
"country": {
"country_id": 8,
"name": "World"
}
}
},
{
"name": "Hong Kong ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/hong-kong/",
"start_timestamp": 1767591600,
"end_timestamp": 1768111200,
"country": {
"country_id": 222,
"name": "Hong Kong"
},
"winner": {
"player_id": "t0WN9vR6",
"name": "Bublik Alexander",
"player_url": "/player/bublik-alexander/t0WN9vR6/",
"country": {
"country_id": 102,
"name": "Kazakhstan"
}
}
},
{
"name": "Auckland ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/auckland/",
"start_timestamp": 1768171200,
"end_timestamp": 1768618800,
"country": {
"country_id": 140,
"name": "New Zealand"
},
"winner": {
"player_id": "UFj257G8",
"name": "Mensik Jakub",
"player_url": "/player/mensik-jakub/UFj257G8/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Adelaide ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/adelaide/",
"start_timestamp": 1768191300,
"end_timestamp": 1768618800,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "S44E7UYr",
"name": "Machac Tomas",
"player_url": "/player/machac-tomas/S44E7UYr/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Australian Open ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/australian-open/",
"start_timestamp": 1768694400,…
可用字段:
- title、url、image_url:可渲染的内容供您使用。
- source:归属。
- published_at:Unix 时间戳(秒)。在渲染时转换为用户的时区。
3) 获取团队新闻
返回有关特定团队的最新新闻文章,包括标题、链接、图片、来源和发布时间。
- 方法:GET
- URL: https://zylalabs.com/api/12518/flashscore-live-api/40618/get-team-news
- 查询参数:
- team_id(字符串,必需):例如,Wtn9Stg0
cURL(供参考):
示例响应(由源截断):
[
{
"title": "Calvin Bassey responds to Man Utd interest after Fulham star frustrates Man City",
"url": "https://www.flashscore.com/newsfeed/fV482r4K/",
"image_url": "https://livesport-ott-images.ssl.cdn.cra.cz/r300x225q60/4f932562-5d33-4ea7-8801-53a3d021681b.jpeg",
"source": "Metro",
"published_at": 1795273228,
"is_flashscore_news": false
},
{
"title": "Iwobi, Bassey In Action As Fulham Share Spoils With Man City",
"url": "https://www.flashscore.com/newsfeed/xOJnSh9O/",
"image_url": "https://livesport-ott-images.ssl.cdn.cra.cz/r300x225q60/6180f2b3-7829-4ede-8d16-3223253a6997.jpeg",
"source": "Completesports",
"published_at": 1795272889,
"is_flashscore_news": false
},
{
"title": "VAR denies Haaland as Man City struggle to break down resolute Fulham",
"url": "https://www.flashscore.com/newsfeed/b9UIzKdK/",
"image_url": "https://livesport-ott-images.ssl.cdn.cra.cz/r300x225q60/47d8bb5a-7dc3-48c9-86e2-239488bdd4a6.jpeg",
"source": "timeslive.co.za",
"published_at": 1795272787,
"is_flashscore_news": false
},
{…
提示:
- 通过将 published_at(秒)转换为您的区域显示可读时间。
- is_flashscore_news 标志指示文章是否来自 Flashscore 新闻室或外部来源。
官方示例:获取网球比赛日历
以下官方示例显示了网球日历响应的结构。这对于构建时间表页面、逐周预览或按场地过滤非常有用。
cURL:
JSON:
[
{
"name": "Brisbane ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/brisbane/",
"start_timestamp": 1767510600,
"end_timestamp": 1768104000,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "O8qG0Nhb",
"name": "Medvedev Daniil",
"player_url": "/player/medvedev-daniil/O8qG0Nhb/",
"country": {
"country_id": 8,
"name": "World"
}
}
},
{
"name": "Hong Kong ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/hong-kong/",
"start_timestamp": 1767591600,
"end_timestamp": 1768111200,
"country": {
"country_id": 222,
"name": "Hong Kong"
},
"winner": {
"player_id": "t0WN9vR6",
"name": "Bublik Alexander",
"player_url": "/player/bublik-alexander/t0WN9vR6/",
"country": {
"country_id": 102,
"name": "Kazakhstan"
}
}
},
{
"name": "Auckland ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/auckland/",
"start_timestamp": 1768171200,
"end_timestamp": 1768618800,
"country": {
"country_id": 140,
"name": "New Zealand"
},
"winner": {
"player_id": "UFj257G8",
"name": "Mensik Jakub",
"player_url": "/player/mensik-jakub/UFj257G8/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Adelaide ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/adelaide/",
"start_timestamp": 1768191300,
"end_timestamp": 1768618800,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "S44E7UYr",
"name": "Machac Tomas",
"player_url": "/player/machac-tomas/S44E7UYr/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Australian Open ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/australian-open/",
"start_timestamp": 1768694400,…
实施注意事项:
- start_timestamp 和 end_timestamp 是 Unix 秒。使用这些来渲染时间表跨度并按日期范围过滤。
- surface 让您能够实现“按场地过滤”用户界面。
- 当比赛结束时,winner 会出现;对于进行中的事件,防止出现 null/缺失的获胜者数据。
您可以快速放入代码库的最小 Python 客户端
下面的代码片段获取球员新闻,将时间戳转换为 ISO8601,并为您的用户界面层打印一个紧凑的列表。更改端点 URL 以使用相同的模式查询团队新闻或团队胜利赔率。
import requests
from datetime import datetime, timezone
API_KEY = "YOUR_API_KEY"
BASE = "https://zylalabs.com/api/12518/flashscore-live-api"
def iso(ts):
# ts 以 Unix 秒(int)形式出现
return datetime.fromtimestamp(ts, tz=timezone.utc).isoformat()
def get_player_news(player_id="dMPo6IPH"):
url = f"{BASE}/40617/get-player-news"
resp = requests.get(url, params={"player_id": player_id}, headers={"Authorization": f"Bearer {API_KEY}"})
resp.raise_for_status()
articles = resp.json()
results = []
for a in articles:
results.append({
"title": a.get("title"),
"url": a.get("url"),
"image": a.get("image_url"),
"source": a.get("source"),
"published_at_iso": iso(a["published_at"]) if a.get("published_at") else None,
"is_flashscore_news": a.get("is_flashscore_news"),
})
return results
if __name__ == "__main__":
for item in get_player_news():
print(f"[{item["published_at_iso"]}] {item["source"]}: {item["title"} - {item["url"]}")
此代码使用 Authorization: Bearer 头,读取文档响应字段,并转换时间戳。您可以将相同的结构适应于:
- 团队新闻:将路径更改为 /40618/get-team-news 并传递 team_id。
- 团队胜利赔率:将路径更改为 /40619/get-team-winner-odds 并传递 team_id(可选地 geo_ip_code)。
现实世界的用例和集成模式
团队的胜利机会赔率比较条
- 获取团队胜利赔率,使用 team_id。
- 按值排序赔率,并突出显示 is_best = true 的行。
- 在需要遵守当前可用性时,过滤 is_active。
- 如果您的受众是特定位置的,请设置 geo_ip_code(例如,GB)以将博彩公司与该市场对齐。
团队和球员新闻源
- 在页面渲染期间或通过计划作业获取团队新闻或球员新闻。
- 显示标题、来源,并通过将 published_at(秒)转换为当地时间显示相对时间。
- 使用 is_flashscore_news 以不同于外部来源的方式标记官方新闻室内容。
网球时间表模块
- 使用网球比赛日历示例设计您的架构和用户界面。
- 允许通过 start_timestamp 和 end_timestamp 按场地和日期范围过滤。
- 在存在时显示获胜者数据;否则显示进行中/预览状态。
节省时间的生产提示
- 时间戳:所有示例均显示以秒为单位的 Unix 时间戳。在客户端或服务器上转换为您的显示时区。
- 缓存:对于新闻,高流量页面通常可以接受 1-5 分钟的缓存。对于赔率,如果您的用户界面强调最近性,请更保守地缓存;始终尊重 is_active。
- 区域化:赔率上的 geo_ip_code 有助于按地区将博彩公司市场对齐(示例:GB)。如果不确定,请默认不使用 geo_ip_code 以接收一般可用性数据。
- 错误处理:将所有端点视为网络绑定。对 5xx 和幂等 GET 实现重试和退避。
- 配额和访问:访问是订阅 + 配额。第一个 API 通常提供 7 天试用或 50 次请求——请确认 API 页面上的详细信息。
如果您正在接入多个 API,Zyla API Hub 上的单个密钥和合并计费可以减少您在扩展到同一平台上的相关服务时的开销。
通过 MCP 从 AI 代理调用 API
您可以通过 Zyla 的 MCP 端点将 FlashScore - 实时 API 暴露给 Claude Code、Cursor、Windsurf 和任何兼容 MCP 的客户端。将您的代理工具指向下面的 MCP URL,提供您的 Zyla API 密钥,代理就可以调用上述相同的端点:
当您的代理请求团队赔率时,让它调用带有 team_id 的获取团队胜利赔率工具,或使用相应的参数获取球员/团队新闻。身份验证仍然是通过 MCP 按照您在客户端中配置的 Authorization: Bearer YOUR_API_KEY。
快速整合所有内容
一个常见的启动路径:
- 在 API 页面上订阅并获取您的密钥:开始 FlashScore - 实时 API 的 7 天试用。
- 使用获取球员新闻或获取团队新闻发布新闻组件。将 published_at 转换为当地时间,渲染标题、image_url 和来源。
- 使用获取团队胜利赔率添加赔率比较小部件。按值排序,突出显示 is_best,并尊重 is_active。
- 如果您涵盖网球,请集成日历示例结构以列出事件和获胜者。
您现在可以运行的 cURL:获取团队胜利赔率
粘贴到您的终端中(替换 YOUR_API_KEY):
部分示例响应(由源截断):
[
{
"tournament_id": "SY30SsKF",
"name": "Premier League",
"image_path": "https://static.flashscore.com/res/image/data/rN76jpW1-naArgzhi.png",
"odds": [
{
"bookmaker_id": 16,
"bookmaker_name": "bet365",
"bookmaker_image": "https://static.flashscore.com/res/image/data/bookmakers/80-16.png",
"value": 17,
"change": "UP",
"is_best": true,
"is_active": true
},
{
"bookmaker_id": 1281,
"bookmaker_name": "BetMGM.uk",
"bookmaker_image": "https://static.flashscore.com/res/image/data/bookmakers/80-1281.png",
"value": 15,
"change": "UP",
"is_best": false,
"is_active": false
},
{
"bookmaker_id": 21,
"bookmaker_name": "Betfred",
"bookmaker_image": "https://static.flashscore.com/res/image/data/bookmakers/80-21.png",
"value": 11,
"change": "UP",
"is_best": false,
"is_active…
关键字段:
- name:整体市场的比赛名称。
- odds[].value:要显示的赔率值;与 bookmaker_name 和 bookmaker_image 结合使用。
- odds[].is_best:突出显示最佳价格的视觉指示器。
- odds[].is_active:用于过滤不可用市场。
常见问题
-
我如何验证请求?
在每个请求中发送 Authorization: Bearer YOUR_API_KEY 到 zylalabs.com 端点。
-
published_at 和 start_timestamp 使用什么时间格式?
它们是以秒为单位的 Unix 时间戳。在您的应用中将它们转换为所需的时区和格式。
-
赔率端点上的 geo_ip_code 有什么作用?
它按地区限制博彩公司可用性(例如,GB)。如果省略,您将获得一般可用性数据。
-
有免费计划吗?
没有。访问是订阅 + 配额,而不是按调用计费。第一个 API 包括 7 天试用或 50 次请求;请查看 API 页面以获取当前详细信息。
-
我可以从 AI 代理调用此 API 吗?
可以。在兼容工具中使用 Zyla 的 MCP 端点,并通过您配置的 Authorization: Bearer 密钥将调用路由到这些端点。
准备好交付了吗?创建您的密钥并开始与 FlashScore - 实时 API 集成团队赔率、球员/团队新闻和网球时间表。从这里开始:开始 FlashScore - 实时 API 的 7 天试用。随时在 Zyla API Hub 探索更多类别。
官方 API 响应
[
{
"name": "Brisbane ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/brisbane/",
"start_timestamp": 1767510600,
"end_timestamp": 1768104000,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "O8qG0Nhb",
"name": "Medvedev Daniil",
"player_url": "/player/medvedev-daniil/O8qG0Nhb/",
"country": {
"country_id": 8,
"name": "World"
}
}
},
{
"name": "Hong Kong ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/hong-kong/",
"start_timestamp": 1767591600,
"end_timestamp": 1768111200,
"country": {
"country_id": 222,
"name": "Hong Kong"
},
"winner": {
"player_id": "t0WN9vR6",
"name": "Bublik Alexander",
"player_url": "/player/bublik-alexander/t0WN9vR6/",
"country": {
"country_id": 102,
"name": "Kazakhstan"
}
}
},
{
"name": "Auckland ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/auckland/",
"start_timestamp": 1768171200,
"end_timestamp": 1768618800,
"country": {
"country_id": 140,
"name": "New Zealand"
},
"winner": {
"player_id": "UFj257G8",
"name": "Mensik Jakub",
"player_url": "/player/mensik-jakub/UFj257G8/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Adelaide ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/adelaide/",
"start_timestamp": 1768191300,
"end_timestamp": 1768618800,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "S44E7UYr",
"name": "Machac Tomas",
"player_url": "/player/machac-tomas/S44E7UYr/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Australian Open ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/australian-open/",
"start_timestamp": 1768694400,…