获取比赛评论的API

您必须在本周将比赛评论和实时上下文发送到您的体育应用程序。通过本指南的结束，您将能够解析团队和比赛，列举支持的体育项目，并使用 FlashScore - Live API 在 Zyla API Hub 上确定国家/类别，以便您可以可靠地定位您将附加评论的确切比赛实体。

此API为您提供的内容（以及它如何帮助评论）

在 FlashScore - Live API 上的 Zyla API Hub 提供可搜索的体育实体和结构化的体育和国家/类别列表。具体来说，您可以：

按名称搜索实体，如团队、球员和锦标赛（以获取稳定的ID和元数据）。
列举所有支持的体育项目。
列出某项运动的国家/类别（例如，网球的ATP/WTA分组）。

要构建评论功能，第一步是可靠地解析正确的比赛上下文：体育 → 竞争/类别 → 团队 → 比赛。下面的端点涵盖发现和范围，以便您可以将评论锚定到正确的实体ID和元数据（体育、性别、图像和国家/类别名称）。

在Zyla API Hub上入门

打开 Zyla API Hub 上的API列表，点击订阅或开始免费试用（如有），并获取您的API密钥。Zyla使用单个帐户、一个API密钥，以及超过10,000个公共API的订阅 + 配额模型——没有按调用计费。对于此API，您可以从7天的试用或50个请求开始；没有免费计划。请查看列表以获取当前访问选项和定价。

所有请求都使用头部 Authorization: Bearer YOUR_API_KEY，基础主机由市场提供。请勿添加未记录的额外参数。

您将用于锚定比赛评论的端点

这些是列表中可用的发现和范围端点。使用它们在您的系统中找到正确的团队、体育和国家/类别，然后再关联评论。

1) 搜索

按查询字符串搜索FlashScore实体（团队、球员、锦标赛）。

方法：GET
URL：https://zylalabs.com/api/12518/flashscore-live-api/23852/search
必需的查询参数：q

示例（搜索“皇家马德里”）：

curl -s -X GET "https://zylalabs.com/api/12518/flashscore-live-api/23852/search?q=real+madrid" \
-H "Authorization: Bearer YOUR_API_KEY"

官方示例响应：

[{"id":"W8mj7MDD","type":"team","name":"Real Madrid","url":"real-madrid","sport":{"id":1,"name":"Soccer"},"gender":"Men","country_name":"Spain","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/E99TZ05n-ttfpEDUq.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"SlAdQJK4","type":"team","name":"Real Madrid U19","url":"real-madrid","sport":{"id":1,"name":"Soccer"},"gender":"Men","country_name":"Spain","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/IgG3LUAK-xGwa4c2B.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"MP6gLUO7","type":"team","name":"Real Madrid","url":"real-madrid","sport":{"id":3,"name":"Basketball"},"gender":"Men","country_name":"Spain","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/pn8TQOkQ-bXlcmj9T.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"2anA8FkF","type":"team","name":"Real Madrid U21","url":"real-madrid","sport":{"id":1,"name":"Soccer"},"gender":"Men","country_name":"Spain","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/p048BCQt-SKpsUss3.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"4xlfVfnP","type":"team","name":"Real Madrid W","url":"real-madrid","sport":{"id":1,"name":"Soccer"},"gender":"Women","country_name":"Spain","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/4CKmt8Rt-WpmKUEXD.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"fyNss8GQ","type":"team","name":"Real Madrid B","url":"real-madrid","sport":{"id":1,"name":"Soccer"},"gender":"Men","country_name":"Spain","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/f5FO93Tc-ltKPQjEk.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"46uFRv4a","type":"team","name":"Real Madrid C","url":"real-madrid","sport":{"id":1,"name":"Soccer"},"gender":"Men","country_name":"Spain","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/bupmbK6n-QkBtimSf.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"UiUgFWdq","type":"team","name":"皇家马德里U20","url":"real-madrid","sport":{"id":1,"name":"Soccer"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flash…

这对评论管道的重要性：

使用id唯一标识团队或实体。
使用sport.id和sport.name区分足球与篮球评论上下文。
使用性别和country_name消歧义队伍和联赛设置。
使用image_path为评论勾选旁边的UI元素。

2) 获取体育

返回所有可用的支持体育项目的列表。

方法：GET
URL：https://zylalabs.com/api/12518/flashscore-live-api/23853/get-sports
参数：未记录

示例：

使用此功能构建体育选择器或验证您的评论功能是否与支持的体育项目相关（例如，足球、网球、篮球）。响应包括sport_id、sport_url和名称。

3) 获取国家

返回特定体育项目的国家列表。

方法：GET
URL：https://zylalabs.com/api/12518/flashscore-live-api/23854/get-countries
必需的查询参数：sport_id

示例（网球 = 2）：

响应返回诸如ATP/WTA分组的项目，包含country_id、country_url和名称。使用此列表根据竞争家庭限制您的评论来源（例如，ATP - 单打与WTA - 双打），这在将实时评论映射到正确的赛区或巡回赛时至关重要。

端到端：在附加评论之前解析实体

获取体育：使用get-sports端点填充您的体育选择器。积极缓存此列表；它不会频繁更改。
选择一项运动并列出国家/类别：对于所选运动，调用get-countries并使用sport_id检索相关类别或国家分组。按运动缓存这些，每日刷新。
搜索团队/球员/锦标赛：使用搜索端点解析确切的实体（例如，“皇家马德里” → 多个团队，包括女子和青年队）。在您的UI中呈现消歧义。
在您的系统中附加实时评论：一旦您选择了正确的实体id，请在您的内部数据模型中使用它，将评论事件与正确的团队/类别关联。上述端点为您提供了避免不匹配所需的标识符和元数据。

注意：这里只涵盖了上述记录的端点。如果您需要额外的比赛级数据，请查看Zyla API Hub上的API页面以获取当前的完整接口。

复制粘贴代码：从Python搜索

此示例调用搜索端点，按type=team过滤，并打印团队id、名称、体育和图像。

import requests

API_KEY = "YOUR_API_KEY"
url = "https://zylalabs.com/api/12518/flashscore-live-api/23852/search"
params = {"q": "real madrid"}
headers = {"Authorization": f"Bearer {API_KEY}"}

resp = requests.get(url, params=params, headers=headers, timeout=15)
resp.raise_for_status()
items = resp.json()

# 使用id将您的评论绑定到正确的团队
for it in items:
if it.get("type") == "team":
team_id = it.get("id")
name = it.get("name")
sport = (it.get("sport") or {}).get("name")
gender = it.get("gender")
country = it.get("country_name")
logo = it.get("image_path")
print(f"{team_id} | {name} | {sport} | {gender} | {country} | {logo}")

您可以将id和url字段存储在数据库中作为评论归属的外键，并使用image_path在您的实时信息UI中渲染徽章。

节省时间的现场笔记

身份验证：始终发送Authorization: Bearer YOUR_API_KEY。请勿添加其他身份验证字段。
缓存：缓存get-sports和get-countries数小时到数天。将搜索结果保存在短期缓存中（几分钟到几小时），以减少在编辑或摄取工作流期间的重复查找。
分页：此处显示的端点未记录分页参数。如果您的查询返回多个实体，请在客户端进行过滤。
图像：在实体结果中提供image_path和country_image_path URL，适用于评论条目旁边的UI元素。
配额和定价：Zyla使用订阅 + 配额（而不是按调用计费）。对于此API，您可以从7天的试用或50个请求开始。请查看API页面以获取当前的配额和层级。
错误处理：401通常表示缺少/无效的Authorization头。将搜索中的空数组视为“没有匹配项”，并提示用户细化他们的术语。

实际用例

比赛查找自动完成：当用户输入团队名称时，调用搜索并将评论绑定到所选id。
竞争范围的供稿：使用get-countries为特定运动限制评论供稿到ATP/WTA或国家联赛。
实时信息UI：解析团队并使用搜索，显示image_path作为徽标，并在旁边流式传输您的评论。
编辑工具：按运动和国家/类别预填充实体选择器，以防止评论标记错误。

通过MCP从AI代理调用API

如果您自动化评论操作（例如，标记团队或获取支持的体育的内部助手），您可以将MCP兼容的客户端连接到Zyla的MCP端点。

MCP服务器URL：https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
与支持MCP的客户端一起使用，包括流行的开发者IDE代理。

使用您的Zyla API密钥配置您的客户端。然后通过您的MCP客户端发出与上述相同的GET请求，使用记录的端点URL和Authorization头。有关连接详细信息，请参见 MCP 页面。

如何在Zyla API Hub上集成

打开API页面：开始7天试用FlashScore - Live API
点击订阅或开始免费试用（如有）。您将收到一个可在Zyla上使用的单一API密钥。
向记录的端点发送请求，使用Authorization: Bearer YOUR_API_KEY。
存储搜索返回的实体ids，并使用get-sports/get-countries保持您的评论映射到有效范围。

如果您是市场的新手，请在 zylalabs.com 上探索其他体育和游戏API——一个帐户和一个密钥可在所有列表中使用。

常见问题

我如何验证请求？
在每次调用中包含头部Authorization: Bearer YOUR_API_KEY。

哪个端点帮助我找到适合我评论的正确团队？
使用GET https://zylalabs.com/api/12518/flashscore-live-api/23852/search，使用q解析实体，如团队和锦标赛。持久化返回的id。

我如何将评论范围限制到某项运动或竞争家庭？
调用GET https://zylalabs.com/api/12518/flashscore-live-api/23853/get-sports以选择一项运动，然后调用GET https://zylalabs.com/api/12518/flashscore-live-api/23854/get-countries?sport_id=...列出国家/类别分组（例如，网球的ATP/WTA）。

是否有分页或额外参数？
未记录此处涵盖的端点的其他参数。根据需要在客户端过滤响应。

定价模型是什么？
Zyla使用订阅 + 配额（而不是按调用计费）。对于此API，您可以从7天的试用或50个请求开始。请查看API页面以获取当前访问选项和定价。

准备好解析实体并连接您的评论工作流了吗？在列表上订阅并立即开始调用端点： FlashScore - Live API。

官方API响应

[{"id":"W8mj7MDD","type":"team","name":"皇家马德里","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/E99TZ05n-ttfpEDUq.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"SlAdQJK4","type":"team","name":"皇家马德里U19","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/IgG3LUAK-xGwa4c2B.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"MP6gLUO7","type":"team","name":"皇家马德里","url":"real-madrid","sport":{"id":3,"name":"篮球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/pn8TQOkQ-bXlcmj9T.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"2anA8FkF","type":"team","name":"皇家马德里U21","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/p048BCQt-SKpsUss3.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"4xlfVfnP","type":"team","name":"皇家马德里W","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"女","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/4CKmt8Rt-WpmKUEXD.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"fyNss8GQ","type":"team","name":"皇家马德里B","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/f5FO93Tc-ltKPQjEk.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"46uFRv4a","type":"team","name":"皇家马德里C","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/bupmbK6n-QkBtimSf.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"UiUgFWdq","type":"team","name":"皇家马德里U20","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flash…

官方API响应

[{"id":"W8mj7MDD","type":"team","name":"皇家马德里","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/E99TZ05n-ttfpEDUq.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"SlAdQJK4","type":"team","name":"皇家马德里U19","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/IgG3LUAK-xGwa4c2B.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"MP6gLUO7","type":"team","name":"皇家马德里","url":"real-madrid","sport":{"id":3,"name":"篮球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/pn8TQOkQ-bXlcmj9T.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"2anA8FkF","type":"team","name":"皇家马德里U21","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/p048BCQt-SKpsUss3.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"4xlfVfnP","type":"team","name":"皇家马德里W","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"女","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/4CKmt8Rt-WpmKUEXD.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"fyNss8GQ","type":"team","name":"皇家马德里B","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/f5FO93Tc-ltKPQjEk.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"46uFRv4a","type":"team","name":"皇家马德里C","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/bupmbK6n-QkBtimSf.png","country_image_path":"https:\/\/static.flashscore.com\/res\/image\/data\/QFbOpTR6-GtJBBjyH.png"},{"id":"UiUgFWdq","type":"team","name":"皇家马德里U20","url":"real-madrid","sport":{"id":1,"name":"足球"},"gender":"男","country_name":"西班牙","image_path":"https:\/\/static.flash…