This documentation provides the necessary information to use the NBA Stats API. These APIs provide access to NBA season and playoff totals, advanced statistics, shot chart data, and more.

View API Documentation

Base URL

All URLs referenced in this documentation use the following base URL:

https://nba-stats-db.herokuapp.com/

Endpoint Examples

Top 20 Scorers by Season Method: Get

https://nba-stats-db.herokuapp.com/api/playerdata/topscorers/total/season/2023/

Success Response:

Code: 200

Content:

{
    "count": 8,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": 203,
            "player_name": "Nikola Jokić",
            "age": 27,
            "games": 69,
            "games_started": 69,
            "minutes_played": 2323,
            "field_goals": 646,
            "field_attempts": 1022,
            "field_percent": "0.632",
            "three_fg": 57,
            "three_attempts": 149,
            "three_percent": "0.383",
            "two_fg": 589,
            "two_attempts": 873,
            "two_percent": "0.675",
            "effect_fg_percent": "0.660",
            "ft": 341,
            "fta": 415,
            "ft_percent": "0.822",
            "ORB": 167,
            "DRB": 650,
            "TRB": 817,
            "AST": 678,
            "STL": 87,
            "BLK": 47,
            "TOV": 247,
            "PF": 174,
            "PTS": 1690,
            "team": "DEN",
            "season": 2023
        },
        {
            "id": 846,
            "player_name": "Nikola Jokić",
            "age": 26,
            "games": 74,
            "games_started": 74,
            "minutes_played": 2476,
            "field_goals": 764,
            "field_attempts": 1311,
            "field_percent": "0.583",
            "three_fg": 97,
            "three_attempts": 288,
            "three_percent": "0.337",
            "two_fg": 667,
            "two_attempts": 1023,
            "two_percent": "0.652",
            "effect_fg_percent": "0.620",
            "ft": 379,
            "fta": 468,
            "ft_percent": "0.810",
            "ORB": 206,
            "DRB": 813,
            "TRB": 1019,
            "AST": 584,
            "STL": 109,
            "BLK": 63,
            "TOV": 281,
            "PF": 191,
            "PTS": 2004,
            "team": "DEN",
            "season": 2022
        },
	...
	]
}

All Players in Season Method: Get

https://nba-stats-db.herokuapp.com/api/playerdata/season/2023

Success Response:

Code: 200

Content:

{
    "count": 609,
    "next": "https://nba-stats-db.herokuapp.com/api/playerdata/season/2023/?page=2",
    "previous": null,
    "results": [
        {
            "id": 1,
            "player_name": "Jalen Green",
            "age": 20,
            "games": 76,
            "games_started": 76,
            "minutes_played": 2602,
            "field_goals": 566,
            "field_attempts": 1359,
            "field_percent": "0.416",
            "three_fg": 187,
            "three_attempts": 554,
            "three_percent": "0.338",
            "two_fg": 379,
            "two_attempts": 805,
            "two_percent": "0.471",
            "effect_fg_percent": "0.485",
            "ft": 364,
            "fta": 463,
            "ft_percent": "0.786",
            "ORB": 43,
            "DRB": 241,
            "TRB": 284,
            "AST": 281,
            "STL": 59,
            "BLK": 18,
            "TOV": 200,
            "PF": 131,
            "PTS": 1683,
            "team": "HOU",
            "season": 2023
        },
        {
            "id": 2,
            "player_name": "Jabari Smith Jr.",
            "age": 19,
            "games": 79,
            "games_started": 79,
            "minutes_played": 2451,
            "field_goals": 364,
            "field_attempts": 892,
            "field_percent": "0.408",
            "three_fg": 120,
            "three_attempts": 391,
            "three_percent": "0.307",
            "two_fg": 244,
            "two_attempts": 501,
            "two_percent": "0.487",
            "effect_fg_percent": "0.475",
            "ft": 162,
            "fta": 206,
            "ft_percent": "0.786",
            "ORB": 122,
            "DRB": 447,
            "TRB": 569,
            "AST": 101,
            "STL": 43,
            "BLK": 74,
            "TOV": 104,
            "PF": 227,
            "PTS": 1010,
            "team": "HOU",
            "season": 2023
        },
	...
	]
}

Reference

All statistics are referenced from basketball-reference.com