We are excited to announce a new release of the API-BASKETBALL, featuring several significant improvements to enrich your data projects and sports analysis. This update addresses user needs for more comprehensive data and easier access to detailed statistics. Discover the latest updates included in this release below.

LEAGUES ENDPOINT: NEW COVERAGE FIELD

We’ve added a new coverage field in the leagues endpoint to provide a more detailed view of the available coverage for each competition in the API. Now, you can verify which statistics, standings, players, odds and other data are available for each league, offering increased transparency to optimize your queries.

{
  "get": "leagues",
  "parameters": {
    "id": "12",
    "season": "2023-2024"
  },
  "errors": [],
  "results": 1,
  "response": [
    {
      "id": 12,
      "name": "NBA",
      "type": "League",
      "logo": "https://media.api-sports.io/basketball/leagues/12.png",
      "country": {
        "id": 5,
        "name": "USA",
        "code": "US",
        "flag": "https://media.api-sports.io/flags/us.svg"
      },
      "seasons": [
        {
          "season": "2023-2024",
          "start": "2023-10-05",
          "end": "2024-04-14",
          "coverage": {
            "games": {
              "statistics": {
                "teams": true,
                "players": true
              }
            },
            "standings": true,
            "players": true,
            "odds": true
          }
        }
      ]
    }
  ]
}

GAMES ENDPOINT: NEW STATISTICS SUB-ENDPOINTS

Two new endpoints have been added to the games section, enhancing your ability to analyze team and player statistics:

• games/statistics/teams: This endpoint allows you to retrieve team statistics for one or multiple games by using game IDs as filters. This is especially useful for comparing team performance across multiple games.

• games/statistics/players: With this endpoint, you can obtain player statistics for one or more games by their game IDs. Additionally, you can access all statistics for a specific player during a particular season, making it easier to track individual performances throughout the season.

A new venue field has also been added to the games endpoint.

Sample data for games/statistics/teams

{
  "get": "games",
  "parameters": {
    "id": "391053"
  },
  "errors": [],
  "results": 2,
  "response": [
    {
      "game": {
        "id": 391053
      },
      "team": {
        "id": 813
      },
      "field_goals": {
        "total": 22,
        "attempts": 66,
        "percentage": 33
      },
      "threepoint_goals": {
        "total": 8,
        "attempts": 29,
        "percentage": 27
      },
      "freethrows_goals": {
        "total": 26,
        "attempts": 34,
        "percentage": 76
      },
      "rebounds": {
        "total": 38,
        "offence": 10,
        "defense": 28
      },
      "assists": 14,
      "steals": 11,
      "blocks": 2,
      "turnovers": 11,
      "personal_fouls": 23
    }
  ]
}

Sample data for games/statistics/players

{
  "get": "games",
  "parameters": {
    "id": "391053"
  },
  "errors": [],
  "results": 18,
  "response": [
    {
      "game": {
        "id": 391053
      },
      "team": {
        "id": 813
      },
      "player": {
        "id": 4235,
        "name": "Simonis Zygimantas"
      },
      "type": "starters",
      "minutes": "27:35",
      "field_goals": {
        "total": 0,
        "attempts": 6,
        "percentage": null
      },
      "threepoint_goals": {
        "total": 0,
        "attempts": 2,
        "percentage": null
      },
      "freethrows_goals": {
        "total": 0,
        "attempts": 0,
        "percentage": null
      },
      "rebounds": {
        "total": 5
      },
      "assists": 1,
      "points": 0
    }
  ]
}

NEW PLAYERS ENDPOINT

We are introducing a new players endpoint, providing access to player profile data. You can also filter this data for active players in a specific season, league or team.

Sample data for players

{
  "get": "players",
  "parameters": {
    "team": "1",
    "season": "2023-2024"
  },
  "errors": [],
  "results": 16,
  "response": [
    {
      "id": 4,
      "name": "Blogg Campbell",
      "number": "3",
      "country": "Australia",
      "position": "Guard",
      "age": 20
    },
    {
      "id": 13,
      "name": "Bowen Kyle",
      "number": "14",
      "country": "Australia",
      "position": "Forward",
      "age": 23
    },
    {
      "id": 5,
      "name": "Cameron Flynn",
      "number": "11",
      "country": "New Zealand",
      "position": "Guard",
      "age": 23
    },
    {
      "id": 6,
      "name": "Clark Ian",
      "number": "21",
      "country": "USA",
      "position": "Guard",
      "age": 32
    },
    {
      "id": 7,
      "name": "Dellavedova Matthew",
      "number": "8",
      "country": "Australia",
      "position": "Guard",
      "age": 33
    },
    {
      "id": 8,
      "name": "Goulding Chris",
      "number": "43",
      "country": "Australia",
      "position": "Guard",
      "age": 35
    },
    {
      "id": 1,
      "name": "Hukporti Ariel",
      "number": "15",
      "country": "Germany",
      "position": "Center",
      "age": 21
    },
    {
      "id": 9,
      "name": "Ili Shea",
      "number": "51",
      "country": "New Zealand",
      "position": "Guard",
      "age": 31
    }
  ]
}

WHY THESE CHANGES?

These new features offer greater granularity in match and performance analysis, simplifying access to key statistics. Whether you’re a developer, an analyst, or a business using our API for your projects, these additions will help you improve both efficiency and accuracy.

HOW TO GET STARTED?

If you’re already an API-BASKETBALL user, these new features are available now. Visit the API documentation to get all the technical details on the new endpoints and fields.

With this new release, this API becomes even more powerful and flexible, offering users deeper data insights to enhance their analyses and applications. If you have any questions or feedback, feel free to contact us.