DOCS
足球 API球队

足球球队列表

调试凭证使用你的 API key

仅在本页使用,刷新后清除。在线调试会使用你的调用额度。

GET
/v1/soccer/teams

鉴权

APIKeyHeader
headerX-API-Key<token>

合作方 API key

查询参数

id?array<string>|

按球队对外 ID 批量取,可重复传,最多 50 个;给了它就不再限「近期活跃」,与其它筛选是「且」的关系

season_id?|

按赛季筛选(赛季对外 ID)

stage_id?|

按阶段筛选(阶段对外 ID)

group_id?|

按小组筛选(小组对外 ID),比 stage_id 更精确、优先生效

country?|

按国家 / 地区筛选:代码(ENG)、英文名(England)或中文名(英格兰),不区分大小写

search?|

按名称模糊搜索(中英文全名、英文简称、繁体名)。搜索词至少 2 个字时结果按相关度排序:先完全匹配,再开头或姓名段匹配(如「詹姆斯」之于「勒布朗·詹姆斯」),最后是其余包含该词的;同档内近一年比赛多的在前

include_placeholder?Include Placeholder

是否包含占位球队(如 [A1]、XX胜者)

默认值false
updated_since?|

只返回此时间之后更新过的球队(含),ISO 8601,可带任意时区偏移;不带偏移按 +08:00

limit?Limit

每页条数,最大 200

范围1 <= value <= 200
默认值50
offset?Offset

起始偏移

范围0 <= value
默认值0

响应体

Successful Response

application/json
  1. response
data*array<>

本页数据

pagination*

分页信息