Issue with multiple requests

[christophermlight]

I have a lot of code using nba_api that was working as of Feb 12, 2026 that is not working today. I seem to have isolated the issue to making multiple requests within the same python code. The block of code below times out on the second request (error: "urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='stats.nba.com', port=443): Read timed out. (read timeout=30)"). However, commenting out any two of the requests allows the remaining one to run fine.

Does this have something to do with the way that nba_api manages requests and the way NBA.com limits them?

example code:

gameID = '0022500710'

box1 = playbyplayv3.PlayByPlayV3(game_id=gameID)
outputs1 = box1.get_data_frames()[0]
print(outputs1)

box2 = boxscoreadvancedv3.BoxScoreAdvancedV3(game_id=gameID)
outputs2 = box2.get_data_frames()[0]
print(outputs2)

box3 = boxscoretraditionalv3.BoxScoreTraditionalV3(game_id=gameID)
outputs3 = box3.get_data_frames()[0]
print(outputs3)

[GarrettAGenz]

I am also having issues today. Specifically with commonallplayers and boxscoretraditionalv3. I am receiving the same error. I thought maybe my address was just blacklisted but I'm now thinking this may be a bigger issue with the nba.stats.com endpoints.

[lapisas]

I am also having an issue with any calls. The one I have tried most is scheduleleaguev2. It worked fine early this morning but has timed out for the past 2 hours. The live json endpoints appear to be functional

[EramMKabir]

I am having an issue with the following endpoints as well:

ScheduleLeagueV2

CommonTeamRoster

PlayerGameLog

LeagueGameFinder

I tried using them, and they all failed. All calls resulted in this error:

requests.exceptions.ReadTimeout: HTTPSConnectionPool(host='stats.nba.com', port=443): Read timed out. (read timeout=30)

I used get_data_frames as well.

I isolated one of the endpoints into a simple Python script that only called the endpoint, and it hanged. Trying to call the API from the browser resulted in a hanged connection, as well. I think this is an issue with the API. I hope the devs address this soon.

[ekal-alperen]

I also have the issue with multiple endpoints for couple of hours

[ekal-alperen]

Seems like working now for me.

[nathank00]

Same issues timing out at all endpoints listed above (still unsuccessful at 16:40 EST)

[sreckoskocilic]

+1
it looks that only stats API is failing. Live endpoints are alive
https://cdn.nba.com/static/json/liveData/boxscore/boxscore_0022500793.json
https://cdn.nba.com/static/json/liveData/playbyplay/playbyplay_0022500793.json
https://cdn.nba.com/static/json/liveData/scoreboard/todaysScoreboard_00.json
https://cdn.nba.com/static/json/liveData/odds/odds_todaysGames.json

Integration tests fail as well, could be related to networking issue if the api is not being throttled by some reason.

((py_venv_312) ) apps/nba_api(master ✔) >>>  pytest tests/integration/
============================================== test session starts ==============================================
platform darwin -- Python 3.12.12, pytest-9.0.2, pluggy-1.6.0
rootdir: /Users/skocho/apps/nba_api
configfile: pyproject.toml
plugins: anyio-4.12.1, html-4.0.2, metadata-3.1.1, rerunfailures-15.1, ordering-0.6, seleniumbase-4.38.3, xdist-3.6.1
collected 37 items / 2 errors

==================================================== ERRORS =====================================================
__________________ ERROR collecting tests/integration/test_stats_endpoints_responses_valid.py ___________________
ImportError while importing test module '/Users/skocho/apps/nba_api/tests/integration/test_stats_endpoints_responses_valid.py'.
Hint: make sure your test modules/packages have valid Python names.
Traceback:
/opt/homebrew/Cellar/python@3.12/3.12.12_2/Frameworks/Python.framework/Versions/3.12/lib/python3.12/importlib/__init__.py:90: in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
tests/integration/test_stats_endpoints_responses_valid.py:6: in <module>
    from deferred_endpoints import deferred_endpoints, DeferredEndpoint
E   ModuleNotFoundError: No module named 'deferred_endpoints'
___________________ ERROR collecting tests/integration/test_stats_library_playbyplayregex.py ____________________
../../py_venv_312/lib/python3.12/site-packages/urllib3/connectionpool.py:534: in _make_request
    response = conn.getresponse()
               ^^^^^^^^^^^^^^^^^^
../../py_venv_312/lib/python3.12/site-packages/urllib3/connection.py:571: in getresponse
    httplib_response = super().getresponse()
                       ^^^^^^^^^^^^^^^^^^^^^
/opt/homebrew/Cellar/python@3.12/3.12.12_2/Frameworks/Python.framework/Versions/3.12/lib/python3.12/http/client.py:1430: in getresponse
    response.begin()
/opt/homebrew/Cellar/python@3.12/3.12.12_2/Frameworks/Python.framework/Versions/3.12/lib/python3.12/http/client.py:331: in begin
    version, status, reason = self._read_status()
                              ^^^^^^^^^^^^^^^^^^^
/opt/homebrew/Cellar/python@3.12/3.12.12_2/Frameworks/Python.framework/Versions/3.12/lib/python3.12/http/client.py:292: in _read_status
    line = str(self.fp.readline(_MAXLINE + 1), "iso-8859-1")
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
/opt/homebrew/Cellar/python@3.12/3.12.12_2/Frameworks/Python.framework/Versions/3.12/lib/python3.12/socket.py:720: in readinto
    return self._sock.recv_into(b)
           ^^^^^^^^^^^^^^^^^^^^^^^
/opt/homebrew/Cellar/python@3.12/3.12.12_2/Frameworks/Python.framework/Versions/3.12/lib/python3.12/ssl.py:1251: in recv_into
    return self.read(nbytes, buffer)
           ^^^^^^^^^^^^^^^^^^^^^^^^^
/opt/homebrew/Cellar/python@3.12/3.12.12_2/Frameworks/Python.framework/Versions/3.12/lib/python3.12/ssl.py:1103: in read
    return self._sslobj.read(len, buffer)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
E   TimeoutError: The read operation timed out

The above exception was the direct cause of the following exception:
../../py_venv_312/lib/python3.12/site-packages/requests/adapters.py:667: in send
    resp = conn.urlopen(
../../py_venv_312/lib/python3.12/site-packages/urllib3/connectionpool.py:841: in urlopen
    retries = retries.increment(
../../py_venv_312/lib/python3.12/site-packages/urllib3/util/retry.py:490: in increment
    raise reraise(type(error), error, _stacktrace)
          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
../../py_venv_312/lib/python3.12/site-packages/urllib3/util/util.py:39: in reraise
    raise value
../../py_venv_312/lib/python3.12/site-packages/urllib3/connectionpool.py:787: in urlopen
    response = self._make_request(
../../py_venv_312/lib/python3.12/site-packages/urllib3/connectionpool.py:536: in _make_request
    self._raise_timeout(err=e, url=url, timeout_value=read_timeout)
../../py_venv_312/lib/python3.12/site-packages/urllib3/connectionpool.py:367: in _raise_timeout
    raise ReadTimeoutError(
E   urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='stats.nba.com', port=443): Read timed out. (read timeout=30)

During handling of the above exception, another exception occurred:
tests/integration/test_stats_library_playbyplayregex.py:17: in pytest_generate_tests
    for game_id in get_game_ids()
                   ^^^^^^^^^^^^^^
tests/integration/test_stats_library_playbyplayregex.py:24: in get_game_ids
    gamefinder = ScoreboardV2(
../../py_venv_312/lib/python3.12/site-packages/nba_api/stats/endpoints/scoreboardv2.py:208: in __init__
    self.get_request()
../../py_venv_312/lib/python3.12/site-packages/nba_api/stats/endpoints/scoreboardv2.py:211: in get_request
    self.nba_response = NBAStatsHTTP().send_api_request(
../../py_venv_312/lib/python3.12/site-packages/nba_api/library/http.py:160: in send_api_request
    response = self.get_session().get(
../../py_venv_312/lib/python3.12/site-packages/requests/sessions.py:602: in get
    return self.request("GET", url, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
../../py_venv_312/lib/python3.12/site-packages/requests/sessions.py:589: in request
    resp = self.send(prep, **send_kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
../../py_venv_312/lib/python3.12/site-packages/requests/sessions.py:703: in send
    r = adapter.send(request, **kwargs)
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
../../py_venv_312/lib/python3.12/site-packages/requests/adapters.py:713: in send
    raise ReadTimeout(e, request=request)
E   requests.exceptions.ReadTimeout: HTTPSConnectionPool(host='stats.nba.com', port=443): Read timed out. (read timeout=30)
=============================================== warnings summary ================================================
tests/integration/test_stats_library_playbyplayregex.py:24
  /Users/skocho/apps/nba_api/tests/integration/test_stats_library_playbyplayregex.py:24: DeprecationWarning: ScoreboardV2 has known issues with line score data for 2025-26 season games (October 22 - December 25, 2025). Please use ScoreboardV3 instead. ScoreboardV3 is fully backward compatible and works for all historical seasons. See: https://github.com/swar/nba_api/issues/596
    gamefinder = ScoreboardV2(

-- Docs: https://docs.pytest.org/en/stable/how-to/capture-warnings.html
============================================ short test summary info ============================================
ERROR tests/integration/test_stats_endpoints_responses_valid.py
ERROR tests/integration/test_stats_library_playbyplayregex.py - requests.exceptions.ReadTimeout: HTTPSConnectionPool(host='stats.nba.com', port=443): Read timed out. (read ...
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Interrupted: 2 errors during collection !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
========================================= 1 warning, 2 errors in 30.49s =========================================

[Zaydoeeeeee]

The leaguegamelog endpoint is down as well. My script cant even get paste this endpoint. It hasn't worked all day for me. It was fine February 12th, 2026. So it seems like the entire api is just down right now. Anyone know when this will be resolved?

[kermitine]

Same here. ScoreBoardV3 getting timed out despite headers and a very generous timeout time.

[sk408]

nba api isn't providing any headers to stats.nba.com so it's blocking the requests as bot requests. once the headers are placed, it works.

[kermitine]

nba api isn't providing any headers to stats.nba.com so it's blocking the requests as bot requests. once the headers are placed, it works.

Not the case for me at least. I manually added headers and increased the timeout time and im still getting a timeout error.

[christophermlight]

Adding headers didn’t solve my problem with getting timed out if a single python program contained more than one request. Each of my requests would go through if I made only that single request, but more than one request in a program would cause the second to be timed out (even with custom headers).

Using time.sleep() with times up to 10 seconds between calls also didn’t solve this problem.

[sk408]

It wasn't using the headers except for one request. I had to monkey patch it

def patch_nba_api_headers() -> None:
"""Patch nba_api's global headers so every request uses our
browser-like headers. Passing headers= per-endpoint isn't enough
because the shared requests.Session caches connection state with
whatever headers were used first.

Call this once at import time from modules that use nba_api.
"""
try:
    from nba_api.stats.library import http as stats_http
    from nba_api.library import http as base_http

    stats_http.STATS_HEADERS = NBA_STATS_HEADERS          # global constant
    stats_http.NBAStatsHTTP.headers = NBA_STATS_HEADERS    # class default
    # Reset any existing session so stale connections are dropped
    stats_http.NBAStatsHTTP._session = None
    base_http.NBAHTTP._session = None
except Exception:
    pass  # nba_api not installed — nothing to patch

[Zaydoeeeeee]

It wasn't using the headers except for one request. I had to monkey patch it

def patch_nba_api_headers() -> None: """Patch nba_api's global headers so every request uses our browser-like headers. Passing headers= per-endpoint isn't enough because the shared requests.Session caches connection state with whatever headers were used first.

Call this once at import time from modules that use nba_api.
"""
try:
    from nba_api.stats.library import http as stats_http
    from nba_api.library import http as base_http

    stats_http.STATS_HEADERS = NBA_STATS_HEADERS          # global constant
    stats_http.NBAStatsHTTP.headers = NBA_STATS_HEADERS    # class default
    # Reset any existing session so stale connections are dropped
    stats_http.NBAStatsHTTP._session = None
    base_http.NBAHTTP._session = None
except Exception:
    pass  # nba_api not installed — nothing to patch

It wasn't using the headers except for one request. I had to monkey patch it

def patch_nba_api_headers() -> None: """Patch nba_api's global headers so every request uses our browser-like headers. Passing headers= per-endpoint isn't enough because the shared requests.Session caches connection state with whatever headers were used first.

Call this once at import time from modules that use nba_api.
"""
try:
    from nba_api.stats.library import http as stats_http
    from nba_api.library import http as base_http

    stats_http.STATS_HEADERS = NBA_STATS_HEADERS          # global constant
    stats_http.NBAStatsHTTP.headers = NBA_STATS_HEADERS    # class default
    # Reset any existing session so stale connections are dropped
    stats_http.NBAStatsHTTP._session = None
    base_http.NBAHTTP._session = None
except Exception:
    pass  # nba_api not installed — nothing to patch

So it's working now for you? All endpoints by doing this?

[sk408]

yes, with these headers

NBA_STATS_HEADERS: dict[str, str] = {
"Accept": "application/json, text/plain, /",
"Accept-Encoding": "gzip, deflate, br",
"Accept-Language": "en-US,en;q=0.9",
"Cache-Control": "no-cache",
"Connection": "keep-alive",
"Host": "stats.nba.com",
"Origin": "https://www.nba.com",
"Pragma": "no-cache",
"Referer": "https://www.nba.com/",
"Sec-Ch-Ua": '"Google Chrome";v="131", "Chromium";v="131", "Not_A Brand";v="24"',
"Sec-Ch-Ua-Mobile": "?0",
"Sec-Ch-Ua-Platform": '"Windows"',
"Sec-Fetch-Dest": "empty",
"Sec-Fetch-Mode": "cors",
"Sec-Fetch-Site": "same-site",
"User-Agent": (
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
"AppleWebKit/537.36 (KHTML, like Gecko) "
"Chrome/131.0.0.0 Safari/537.36"
),
}