Skip to main content

​
Base URL

https://v2.football.sportsapipro.com
Fantasy IDs are NOT player IDs. You must first discover the fantasy ID using /api/players/{playerId}/fantasy/competitions (see Player Endpoints → Fantasy), then use the returned fantasyId with the endpoints below.Discovery flow:
  1. Get the regular player ID via search or lineups
  2. Call GET /api/players/{playerId}/fantasy/competitions
  3. Extract the fantasyId from the response
  4. Use that fantasyId in the endpoints below

​
Fantasy Endpoints

​
Fantasy Player Details

GET /api/fantasy/player/{fantasyId}
Returns fantasy-specific player data: ownership percentage, price, total points, points per game, and form.
​
fantasyId
number
required
Fantasy player ID (NOT the regular player ID). Discover via /api/players/{playerId}/fantasy/competitions.

​
Fantasy Player Fixtures

GET /api/fantasy/player/{fantasyId}/fixtures
Returns upcoming fixtures with difficulty ratings for the fantasy player — useful for transfer planning and captaincy decisions.

​
Player of the Season

​
Highest Ratings

GET /api/player-of-the-season/highest-ratings
Returns players with the highest average ratings across all competitions.

​
Available Years

GET /api/player-of-the-season/available-years
Returns all years with Player of the Season data available.

​
Most Awards (Paginated)

GET /api/player-of-the-season/most-awards?page={page}
Returns players ranked by the number of Player of the Season awards received.
​
page
number
default:"0"
Page number for pagination (0-indexed).

​
Top Competitions

GET /api/player-of-the-season/top-competitions
Returns competitions ranked by prestige/quality of their Player of the Season awards.

​
Example Requests

# Step 1: Discover fantasy ID from player ID
curl -X GET "https://v2.football.sportsapipro.com/api/players/934235/fantasy/competitions" \
  -H "x-api-key: YOUR_API_KEY"

# Step 2: Use the fantasyId from the response
curl -X GET "https://v2.football.sportsapipro.com/api/fantasy/player/12345/fixtures" \
  -H "x-api-key: YOUR_API_KEY"

# Player of the Season — no discovery needed
curl -X GET "https://v2.football.sportsapipro.com/api/player-of-the-season/highest-ratings" \
  -H "x-api-key: YOUR_API_KEY"