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

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