Football API / players

Get player by ID

GET https://soccer.highlightly.net/players/{id} Football API
GET https://sports.highlightly.net/football/players/{id} All Sports API

Retrieve a detailed player summary.

Refresh interval
Once a day

The player id comes from players.

This is the profile view, useful for scouting, analysis or profile display.

What the summary covers

Alongside the player's id, name, fullName and logo, the summary carries transfers, marketValue, rumours, relatedNews and injuries, and may also carry a profile.

Field Covers
profile

Current club, contract timeline, physical attributes such as height and preferred foot, biographical detail including birth date, birthplace and citizenship, and the player's position. That is a main position plus a secondary string, which can name more than one position.

transfers

The complete transfer history. Each entry names the origin and destination clubs, the type of move, the season and the transfer date, and where recorded the market value at the time and the fee. The type is transfer, loan, end of loan or retired.

marketValue

A chronological record of valuation, each point carrying the date, the value, the club at the time, the player's age and the currency. Read as a series it shows the trajectory across a career.

rumours

Transfer speculation, separated into current and historical. Entries carry the club, the date the rumour emerged and an estimated transfer probability.

relatedNews

Articles about the player, each with a title, publication date and a link. Coverage spans transfers, international appearances, squad analysis and club strategy.

injuries

Injury history. Each entry carries the reason, the season, the start date, the games missed and, where recorded, the end date and the number of days absent.

A player summary rendered in a client application

Parameters

Parameter Type Description
idrequired numberpath Requested player id.

Request

curl --request GET \
  --url 'https://soccer.highlightly.net/players/{id}' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const response = await fetch('https://soccer.highlightly.net/players/{id}', {
  headers: {
    'x-rapidapi-key': process.env.HIGHLIGHTLY_API_KEY
  }
})

if (!response.ok) {
  throw new Error(`Highlightly responded ${response.status}`)
}

const data = await response.json()
import os
import requests

response = requests.get(
    'https://soccer.highlightly.net/players/{id}',
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

response.raise_for_status()
data = response.json()

Response

idnumberrequired
namestringrequired
fullNamestring
logostring
profileDetailedPlayerSummaryProfile15 fields
fullNamestring
birthDatestring
deathDatestring
birthPlacestring
citizenshipstring
footstring
heightstring
positionDetailedPlayerSummaryPositionrequired2 fields
mainstring
secondarystring
clubDetailedPlayerSummaryClubrequired4 fields
currentstring
joinedAtstring
contractExpirystring
latestContractExtensionstring
rumoursDetailedPlayerSummaryRumoursrequired8 fields
currentDetailedPlayerSummaryRumour[]required3 fields
clubstringrequired
rumourDatestringrequired
transferProbabilitystringrequired
historicalDetailedPlayerSummaryRumour[]required3 fields
clubstringrequired
rumourDatestringrequired
transferProbabilitystringrequired
relatedNewsDetailedPlayerSummaryRelatedNews[]required3 fields
urlstringrequired
datestringrequired
titlestringrequired
transfersDetailedPlayerSummaryTransfers[]required7 fields
tostringrequired
feestring
fromstringrequired
typestringrequiredtransferloanend of loanretired
seasonstringrequired
marketValuestring
transferDatestringrequired
marketValueDetailedPlayerMarketValues[]required5 fields
recordedDatestringrequired
clubstringrequired
valuenumberrequired
agenumberrequired
currencystringrequired
injuriesDetailedPlayerInjuries[]required6 fields
reasonstringrequired
seasonstringrequired
fromDatestringrequired
toDatestring
missedGamesnumberrequired
absentDurationInDaysnumber

Example response

200 application/json 
[
  {
    "id": 33481,
    "name": "Ivan Perišić",
    "fullName": "Ivan Perišić",
    "logo": "",
    "profile": {
      "fullName": "Ivan Perišić",
      "birthDate": "Feb 2, 1989",
      "deathDate": "",
      "birthPlace": "Split",
      "citizenship": "Croatia",
      "foot": "both",
      "height": "1,86 m",
      "position": {
        "main": "Right Winger",
        "secondary": "Left Midfield, Left Winger"
      },
      "club": {
        "current": "PSV Eindhoven",
        "joinedAt": "Sep 18, 2024",
        "contractExpiry": "Jun 30, 2027",
        "latestContractExtension": "Jun 27, 2025"
      }
    },
    "rumours": {
      "current": [
        {
          "club": "FC Barcelona",
          "rumourDate": "Jun 11, 2025",
          "transferProbability": "84.96%"
        }
      ],
      "historical": [
        {
          "club": "FC Barcelona",
          "rumourDate": "Jun 11, 2025",
          "transferProbability": "84.96%"
        }
      ]
    },
    "relatedNews": [
      {
        "url": "https://www.transfermarkt.com/third-youngest-squad-in-the-pl-postecoglou-aiming-for-top-four-with-new-look-spurs-side/view/news/441066",
        "date": "Jul 23, 2024",
        "title": "Third youngest squad in the PL - Postecoglou aiming for top four with new-look Spurs side"
      }
    ],
    "transfers": [
      {
        "to": "Bayern Munich",
        "fee": "€5.0M",
        "from": "Inter",
        "type": "loan",
        "season": "19/20",
        "marketValue": "€30.0M",
        "transferDate": "Aug 13, 2019"
      }
    ],
    "marketValue": [
      {
        "recordedDate": "Dec 22, 2023",
        "club": "FC Barcelona",
        "value": 60000000,
        "age": 16,
        "currency": "€"
      }
    ],
    "injuries": [
      {
        "reason": "Muscle injury",
        "season": "2022",
        "fromDate": "27.04.2022",
        "toDate": "20.05.2022",
        "missedGames": 3,
        "absentDurationInDays": 24
      }
    ]
  }
]

Values are the examples declared in the OpenAPI spec, not a captured live response.

Errors

Status Description
400 Bad request descriptive error.
500 Internal server error.