Skip to main content
Version: 2.0.0

Sports Player Data API Documentation

Description

This endpoint returns all the detailed player stats & data across every sport: first & last name, team, position, age, height, weight & more.

REQUIREMENT

You'll need a license key to use OpticOdds' API. You can get one by contacting us at www.opticodds.com.

API Endpoint

https://api.opticodds.com/api/v2/players/list

Parameters

key (required)

Your OpticOdds API license key.

name

The player name.

id

The player ID.

sport

NOTE

You can pass in multiple of this parameter.

The sport you want to receive players for. We support the following:

  • football
  • basketball
  • baseball
  • mma
  • boxing
  • hockey
  • soccer
  • tennis
  • golf
  • motorsports
  • esports
  • wrestling
  • aussie-rules
  • rugby
  • lacrosse
  • cricket
  • volleyball

league

NOTE

You can pass in multiple of this parameter.

The league you want to receive players for (e.g. NBA)

team

NOTE

You can pass in multiple of this parameter.

The team ID you want to receive players for (e.g. E89B6AABD4C6)

is_active

Flag to filter for players who are currently active or inactive (supports values true, yes, t, 1, false, no, f, 0).

include_logos

Whether you want to include logos with the players.

page

The page number of the request.

include_statsperform_ids

Specify this parameter if you want the StatsPerform IDs to be included as part of the response.

Example Response

{
"data": [
{
"id": "E3DE1974DF1F",
"player_name": "Gabe Vincent",
"sport": "basketball",
"league": "NBA",
"first_name": "Gabe",
"last_name": "Vincent",
"team_name": "Miami Heat",
"team_id": "26BB4DC5722F",
"number": "2",
"position": "SG",
"age": "24",
"height": "74",
"weight": 220
},
{
"id": "E799C7F2449A",
"player_name": "Thanasis Antetokounmpo",
"sport": "basketball",
"league": "NBA",
"first_name": "Thanasis",
"last_name": "Antetokounmpo",
"team_name": "Milwaukee Bucks",
"team_id": "14682EF45C4D",
"number": "43",
"position": "SF",
"age": "21",
"height": "78",
"weight": 212
},
{
"id": "4F2B17499E0B",
"player_name": "Ivica Zubac",
"sport": "basketball",
"league": "NBA",
"first_name": "Ivica",
"last_name": "Zubac",
"team_name": "Los Angeles Clippers",
"team_id": "3E1EA77686B9",
"number": "40",
"position": "C",
"age": "24",
"height": "80",
"weight": 237
},
...
],
"page": 1,
"total_pages": 4
}

API Endpoint (deprecated)

DEPRECATED

Deprecated endpoint

https://api.opticodds.com/api/v2/players