Skip to main content

Players API Documentation

Requirement

You need an API key to use OddsBlaze. Get access at www.oddsblaze.com.

Description​

This endpoint returns players.

API Endpoint​

https://players.oddsblaze.com/

Parameters​

key (required)​

Your OddsBlaze API key.

league (required)​

The league id (e.g. nba).

team​

The team id, name, or abbreviation (e.g. 07c9744d-f56a-5fe5-8835-f7e7369a7484, Los Angeles Lakers, or LAL). Separate multiple teams with a comma (e.g. Los Angeles Lakers,New York Knicks).

id​

The player id (e.g. df0e45cc-5091-5b07-9a2e-1bf9b1381e21). Separate multiple ids with a comma (e.g. df0e45cc-5091-5b07-9a2e-1bf9b1381e21,105caa44-84c0-58ec-b31f-d117e085c8ed).

name​

The player name (e.g. LeBron James). Separate multiple names with a comma (e.g. LeBron James,Luka Doncic).

position​

The player position (e.g. SF). Separate multiple positions with a comma (e.g. SF,PG).

number​

The player number (e.g. 23). Separate multiple numbers with a comma (e.g. 23,77).

mappings​

Hide all mappings (mappings=false) or only include certain providers (e.g. mappings=espn). Separate multiple providers with a comma (e.g. mappings=espn,sofascore).

mappings_{provider}_id​

The mappings provider id (e.g. mappings_espn_id=1966). Separate multiple ids with a comma (e.g. mappings_sofascore_id=817181,861608).

Example URLs​

NBA players:

https://players.oddsblaze.com/?key=your_key&league=nba

NHL players:

https://players.oddsblaze.com/?key=your_key&league=nhl

Example Response​

{
  "updated": "2026-05-26T23:49:25.137Z",
  "league": {
    "id": "nba",
    "name": "NBA",
    "sport": "Basketball"
  },
  "teams": [
    {
      "id": "07c9744d-f56a-5fe5-8835-f7e7369a7484",
      "name": "Los Angeles Lakers",
      "abbreviation": "LAL",
      "players": [
        {
          "id": "df0e45cc-5091-5b07-9a2e-1bf9b1381e21",
          "name": "LeBron James",
          "position": "SF",
          "number": "23",
          "birthdate": "1984-12-30",
          "age": 41,
          "mappings": {
            "ESPN": {
              "id": "1966"
            },
            "NBA": {
              "id": "2544"
            },
            "Sofascore": {
              "id": "817181"
            },
            "SportsDataIO": {
              "id": "20000571"
            }
          }
        },
        {
          "id": "105caa44-84c0-58ec-b31f-d117e085c8ed",
          "name": "Luka Dončić",
          "position": "PG",
          "number": "77",
          "birthdate": "1999-02-28",
          "age": 27,
          "mappings": {
            "ESPN": {
              "id": "3945274"
            },
            "NBA": {
              "id": "1629029"
            },
            "Sofascore": {
              "id": "861608"
            },
            "SportsDataIO": {
              "id": "20001984"
            }
          }
        }
      ]
    }
  ]
}