DOCS
足球 API转会

足球转会记录

调试凭证使用你的 API key

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

GET
/v1/soccer/transfers

鉴权

APIKeyHeader
headerX-API-Key<token>

合作方 API key

查询参数

player_id?|

按球员筛选(球员对外 ID)

team_id?|

按球队筛选(球队对外 ID),转入或转出

season?|

按转会窗口赛季筛选,如 2025-2026;取值同响应的 season 字段,覆盖绝大多数记录

season_id?|

按某赛事的赛季筛选(赛季对外 ID)。只有 FotMob 侧记了赛事赛季归属的记录能命中(约 4%),想按赛季筛通常该用 season

date_from?|

转会日期下限(含)

date_to?|

转会日期上限(含)。不传时默认今天(北京时间):库里有预定在未来的记录(租借到期等),默认不返回,要取就显式传一个更晚的日期。带 updated_since 时不加这个默认值

type?|

按类型筛选

min_fee?|

最低转会费(欧元),无费用的记录不返回

updated_since?|

只返回此时间之后入库或变更的记录(含),ISO 8601,可带任意时区偏移;不带偏移按 +08:00。注意这是记录入库时间,不是转会发生时间(后者是 date 字段),补采历史转会时两者会相差很远。增量同步要拿到全部变更,所以带这个参数时 date_to 没有默认值,未来日期的记录也返回

sort?Sort

date 按日期 / fee 按转会费 / market_value 按身价

默认值"date"
可选值"date""fee""market_value"
order?Order

排序方向:asc 升序 / desc 降序

默认值"desc"
可选值"asc""desc"
limit?Limit

每页条数,最大 200

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

起始偏移

范围0 <= value
默认值0

响应体

Successful Response

application/json
  1. response
data*array<>

本页数据

pagination*

分页信息