Search players by player metrics in upcoming fixtures

get

https://api.sstrader.com/v1/football/players/search

Finds players by the player metrics we publish for them (ratings, card risk, expected metrics; see include=player_metrics on /football/fixtures). The fixtures are selected as on /football/fixtures/search, with the same parameters and defaults. One result is one player in one fixture, so a player with two matches in the time selection has two results unless distinct=player is given. Every unknown parameter, include, position or metric name is a 400.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

window

string

Defaults to 24

live, or a number of hours from 1 to 168: matches kicking off in the next N hours plus the matches in play now. Cannot be combined with for_date or from / to.

for_date

date

Kick-off on this UTC day (YYYY-MM-DD), past or future.

from

string

Start of a kick-off range (date or ISO 8601 date-time). Needs to. At most 14 days long, starting no more than 30 days ago.

string

End of the kick-off range; a date means the end of that day.

status

array of strings

Replaces the default statuses: in play + NOT_STARTED for an hour window, in play for window=live, everything except DELETED for for_date / from / to.

status

league_id

string

Comma-separated league ids (max 100).

country_id

string

Comma-separated country ids of the league (max 100).

team_id

string

Comma-separated team ids: players OF these teams (not their opponents).

fixture_id

string

Search only these fixtures (still inside the time selection).

player_id

string

Comma-separated player ids (max 100).

position

array of strings

The player's position in that team's squad for the season.

position

Allowed:

league_level

string

Comma-separated league levels, or all. Default 1,2,3, except when league_id, team_id, fixture_id or player_id is given (then every level).

has_odds

string

Only matches with active (not suspended) odds from one of these bookmaker ids.

where[DEVELOPER_NAME]

string

^(-?\d+(\.\d+)?)?:(-?\d+(\.\d+)?)?$

Value range on a player metric (developer_name, e.g. PLAYER_EXPECTED_SHOTS), or on P_START / P_PLAY (the chance of starting / of playing at all): min:max, inclusive, decimals allowed, one bound may be empty. Values in the units of include=player_metrics. No sides. A player without the value does not match. Up to 10; all must match.

order[DEVELOPER_NAME]

string

enum

Sort by a player metric, P_START / P_PLAY, or order[date_time]. Up to 3 keys, in the order given. Players without the value come last; ties end with kick-off time, fixture id and player id. Default: kick-off ascending.

Allowed:

basis

string

enum

Defaults to value

Which number of the expected metrics where[], order[] and search_values use: the published value (weighted by the chance of starting), or its meta.if_starts / meta.if_benched conditional. Ratings and card risk have no conditional and always use their value.

Allowed:

distinct

string

enum

One result per player: his earliest fixture among those passing where[]. total and has_more then count players.

Allowed:

include

array of strings

player_metrics: every player metric row of that player in that fixture.

include

Allowed:

language

string

Defaults to en

Two-letter code for team, league and country names.

page

integer

≥ 1

Defaults to 1

The current page number.

per_page

integer

1 to 50

Defaults to 25

Results per page. Maximum is 50.

Responses

403

Unauthorized — missing or insufficient permissions.

200Matching players, one entry per player and fixture (per player with distinct=player). has_more is exact.

400Invalid or unknown parameter, include, status, position or metric name.