DOCS
足球 API球员

足球球员列表

调试凭证使用你的 API key

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

GET
/v1/soccer/players

鉴权

APIKeyHeader
headerX-API-Key<token>

合作方 API key

查询参数

team_id?|

按当前球队筛选(球队对外 ID)

search?|

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

position?|

按具体位置筛选;取值同响应的 position 字段

position_group?|

按位置大类筛选;取值同响应的 position_group 字段,含只标了大类的球员

country?|

按国籍模糊筛选(英文名、代码或中文名)

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*

分页信息