StatsHub Docs
APIAPI v2V2 endpoint referenceScreeners

/screeners/player-props

List player prop lines for a bounded fixture set

GET
/screeners/player-props

List player prop lines for a bounded fixture set

Query Parameters

games?string

Fixture IDs to screen; at most 100. Supply this or a bounded startOfDay/endOfDay range

Match^[1-9][0-9]*(,[1-9][0-9]*){0,99}$
Lengthlength <= 4096
startOfDay?number

Inclusive Unix-second fixture range start; requires endOfDay and cannot be combined with games

Range1 <= value <= 4102444800
endOfDay?number

Exclusive Unix-second fixture range end; at most eight days after startOfDay

Range1 <= value <= 4102444800
competitionIds?string

Canonical competition IDs within the date range; at most 100

Match^[1-9][0-9]*(,[1-9][0-9]*){0,99}$
Lengthlength <= 4096
players?string

Player IDs to include; at most 100

Match^[1-9][0-9]*(,[1-9][0-9]*){0,99}$
Lengthlength <= 4096
statTypes?string

Comma-separated statistic keys

Lengthlength <= 4096
type?string

Odds side

Value in

  • "over"
  • "under"
hitRateOption?string

Form window

Value in

  • "L5"
  • "L10"
  • "L15"
hitRateRange.from?number

Minimum hit rate

Range0 <= value <= 100
hitRateRange.to?number

Maximum hit rate

Range0 <= value <= 100
oddsRange.from?number

Minimum decimal odds

Range1 <= value <= 1000
oddsRange.to?number

Maximum decimal odds

Range1 <= value <= 1000
page?integer

One-based result page

Range1 <= value <= 1000000
pageSize?integer

Rows per page

Range1 <= value <= 1000
includeStale?boolean

Include stale source rows

staleDataThresholdHours?integer

Age after which source data is stale

Range1 <= value <= 720
useSupersub?boolean

Use hit-rate windows that include substitute appearances

useAllTournaments?boolean

Use cross-competition hit-rate windows

useMinLastGameWithTeam?boolean

Filter by games since the player's last appearance

includeRecords?boolean

Include page-local player record totals and recent games

minLastGameWithTeam?integer

Maximum team games since the player's last appearance

Range0 <= value <= 100
lineupFilterType?string

Selected fixture lineup status

Value in

  • "all"
  • "predicted"
  • "confirmed"
selectedDates?string

Comma-separated UTC dates

Lengthlength <= 4096
bookmakers?string

Comma-separated bookmaker names

Lengthlength <= 4096
sorting.column?string

Sort field

Value in

  • "L5"
  • "L10"
  • "L15"
  • "line"
  • "oddsValue"
  • "impliedProbability"
  • "opponentRank"
  • "playerName"
  • "teamName"
  • "statType"
  • "eventTimestamp"
sorting.direction?string

Sort direction

Value in

  • "asc"
  • "desc"

Response Body

application/json

application/problem+json

application/problem+json

curl -X GET "https://example.com/screeners/player-props"
{  "data": [    {      "activityInfo": {        "inPredictedLineup": true,        "lastGameWithTeam": 0,        "startedLastGame": true      },      "allBookmakerOdds": [        {          "bookmakerId": 0,          "bookmakerName": "string",          "oddsValue": 0.1        }      ],      "average": 0,      "awayTeamId": 0,      "awayTeamName": "string",      "awayTeamSlug": "string",      "bookmakerId": 0,      "bookmakerName": "string",      "bookmakers": [        {          "bookmakerId": 0,          "bookmakerName": "string",          "oddsValue": 0.1        }      ],      "eventId": 0,      "eventTimestamp": 0,      "hitRateAllL10": 0,      "hitRateAllL10WithSub": 0,      "hitRateAllL15": 0,      "hitRateAllL15WithSub": 0,      "hitRateAllL5": 0,      "hitRateAllL5WithSub": 0,      "hitRateL10": 0,      "hitRateL10WithSub": 0,      "hitRateL15": 0,      "hitRateL15WithSub": 0,      "hitRateL5": 0,      "hitRateL5WithSub": 0,      "hitRates": {        "L10": 0,        "L10WithSub": 0,        "L15": 0,        "L15WithSub": 0,        "L5": 0,        "L5WithSub": 0,        "allL10": 0,        "allL10WithSub": 0,        "allL15": 0,        "allL15WithSub": 0,        "allL5": 0,        "allL5WithSub": 0      },      "homeTeamId": 0,      "homeTeamName": "string",      "homeTeamSlug": "string",      "id": 0,      "leagueAverage": 0,      "line": 0.1,      "marketName": "string",      "oddsType": "over",      "oddsValue": 0,      "opponentAverage": 0,      "opponentRank": 0,      "opponentRanking": {        "rank": 0,        "total": 0      },      "opponentTeamId": 0,      "opponentTeamName": "string",      "opponentTeamSlug": "string",      "playerId": 0,      "playerName": "string",      "recentGames": [        {          "eventId": 0,          "eventTimestamp": 0.1,          "hasSuperSub": true,          "isHit": true,          "isHome": true,          "minutesPlayed": 0,          "opponentId": 0,          "opponentName": "string",          "opponentSlug": "string",          "originalStatValue": 0.1,          "position": "string",          "statValue": 0.1,          "tournamentId": 0,          "uniqueTournamentId": 0        }      ],      "recentlyPlayed": true,      "statType": "goals",      "teamId": 0,      "teamName": "string",      "teamPrimaryColor": "string",      "teamSecondaryColor": "string",      "teamSlug": "string",      "total": 0,      "totalRanks": 0    }  ],  "pagination": {    "currentPage": 0,    "hasNextPage": true,    "hasPreviousPage": true,    "totalCount": 0,    "totalPages": 0  }}