足球 API赛季统计

足球球员赛季统计

调试凭证使用你的 API key

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

GET

/v1/soccer/season-player-stats

鉴权

APIKeyHeader

headerX-API-Key<token>

合作方 API key

查询参数

season_id*Season Id

赛季对外 ID

team_id?|

只看某支球队的球员（球队对外 ID）

position?|

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

position_group?|

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

venue?Venue

total 全部 / home 主场 / away 客场

默认值"total"

可选值"total""home""away"

sort?|

按某项指标排序，取值为响应 stats 里的字段名（如 goals、assists）；不传按球队、球员名排序

可选值"aerial_duels_won""appearances""assists""best_player_awards""clearances""clearances_successful""crosses""crosses_accurate""defensive_actions""dispossessed""dribbles_successful""fouls""goal_conversion_pct""goals""goals_prevented""headed_clearances""interceptions""key_passes""long_balls""long_balls_accurate""minutes_per_assist""minutes_per_goal""minutes_played""non_penalty_goals""offsides""offsides_provoked""own_goals""pass_accuracy_pct""passes""passes_accurate""passes_into_final_third""penalties_won""penalty_goals""rated_appearances""rating_total""recoveries""red_cards""shots""shots_blocked""shots_on_post""shots_on_target""substitute_appearances""sweeper_actions""tackles""through_balls""through_balls_accurate""touches""touches_in_opposition_box""turnovers""was_fouled""xa""xg""xg_non_penalty""xg_on_target""xg_on_target_faced""yellow_cards"

order?Order

排序方向：asc 升序 / desc 降序；不传 sort 时按球队、球员名，此参数同样生效

默认值"desc"

可选值"asc""desc"

limit?Limit

每页条数，最大 200

范围1 <= value <= 200

默认值50

offset?Offset

起始偏移

范围0 <= value

默认值0

响应体

Successful Response

application/json

response

data*array<>

本页数据

pagination*

分页信息

请求示例 CODE

curl -X GET "https://example.com/v1/soccer/season-player-stats?season_id=string" \  -H "X-API-Key: YOUR_API_KEY"

响应示例 JSON

{  "data": [    {      "player": {        "id": "string",        "name": "string",        "name_cn": "string",        "position": "GK",        "position_group": "GK",        "photo_url": "string"      },      "team": {        "id": "string",        "name": "string",        "name_cn": "string",        "logo_url": "string"      },      "venue": "string",      "stats": {        "appearances": 0,        "substitute_appearances": 0,        "rated_appearances": 0,        "minutes_played": 0,        "rating_total": 0,        "best_player_awards": 0,        "goals": 0,        "assists": 0,        "penalty_goals": 0,        "non_penalty_goals": 0,        "own_goals": 0,        "goal_conversion_pct": 0,        "minutes_per_goal": 0,        "minutes_per_assist": 0,        "xg": 0,        "xg_non_penalty": 0,        "xg_on_target": 0,        "xa": 0,        "shots": 0,        "shots_on_target": 0,        "shots_blocked": 0,        "shots_on_post": 0,        "touches": 0,        "touches_in_opposition_box": 0,        "passes": 0,        "passes_accurate": 0,        "pass_accuracy_pct": 0,        "key_passes": 0,        "passes_into_final_third": 0,        "crosses": 0,        "crosses_accurate": 0,        "long_balls": 0,        "long_balls_accurate": 0,        "through_balls": 0,        "through_balls_accurate": 0,        "dribbles_successful": 0,        "dispossessed": 0,        "turnovers": 0,        "was_fouled": 0,        "fouls": 0,        "offsides": 0,        "offsides_provoked": 0,        "penalties_won": 0,        "tackles": 0,        "interceptions": 0,        "clearances": 0,        "clearances_successful": 0,        "headed_clearances": 0,        "aerial_duels_won": 0,        "recoveries": 0,        "defensive_actions": 0,        "xg_on_target_faced": 0,        "goals_prevented": 0,        "sweeper_actions": 0,        "yellow_cards": 0,        "red_cards": 0      }    }  ],  "pagination": {    "total": 0,    "limit": 0,    "offset": 0  }}

足球球队赛季统计

足球转会记录

足球球员赛季统计

鉴权复制标题链接

查询参数复制标题链接

响应体复制标题链接

鉴权

查询参数

响应体