What is Basketball head?

Basketball head is a reliable source of NBA player statistics. It uses basketball-reference as the source of truth for the latest statistics. The data is then replicated and served to allow for low latency and high throughput. Use this service if you’d like to leverage basketball data in a personal project or production application to get the latest NBA player statistics.

Main Components

Currently there are three main components

• Player Discovery - Find players.
• Player Career Stats - Get stats across multiple dimensions over the course of the player’s career.
• Player Games - View the individual statistics of the games the player has plated in.

Player Discovery

Player discovery is used to identify players in the database. For example if searching for statistics of a certain player, you would first search for that player to retrieve the playerId. From that playerId the career stats and games can be queried.

List Players (POST)
Lists all players in the database. Allows for pagination using the last evaluated key.

Search Players (POST)
Search players in the database by first and last name prefixes. Allows for pagination using the last evaluated key.

Player Metadata (GET)
Given an internal player id, return the player metadata.

Player Career Stats

Player Game Stats

Feature Requests and Bugs

Please open a discussion. Prefix the discussion name with [BUG] for bugs and [FEATURE REQUEST] for feature requests to allow for easy identification.

Glossary

For an in-depth definition of each statistic used in the responses of this API, visit basketball-reference

FAQ

None yet. Open a discussion to get answers to your questions.