newsdataapi 0.3.2__tar.gz → 0.3.4__tar.gz

{newsdataapi-0.3.2 → newsdataapi-0.3.4}/.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
     steps:
       - uses: actions/checkout@v4
 

{newsdataapi-0.3.2 → newsdataapi-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: newsdataapi
-Version: 0.3.2
+Version: 0.3.4
 Summary: Official Python client (SDK) for the Newsdata.io News API — fetch real-time, historical, crypto, and stock-market news via REST, with validation, retries, pagination, and typed exceptions.
 Project-URL: Homepage, https://newsdata.io
 Project-URL: Documentation, https://newsdata.io/documentation
@@ -35,6 +35,8 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -43,9 +45,9 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
+Requires-Python: >=3.8
 Requires-Dist: requests<3,>=2.25
-Requires-Dist: websockets<17,>=16
+Requires-Dist: websockets<17,>=16; python_version >= '3.10'
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -77,7 +79,7 @@ If you use [uv](https://github.com/astral-sh/uv):
 uv add newsdataapi
 ```
 
-Supports Python 3.10 through 3.14. The runtime dependencies are `requests` (REST) and `websockets` (real-time streaming).
+Supports Python 3.8 through 3.14. The runtime dependencies are `requests` (REST) and `websockets` (real-time streaming). `NewsDataApiWebSocket` requires Python 3.10 or newer, so `websockets` is only installed there; on 3.8 and 3.9 the REST client works as usual.
 
 ## Quickstart
 
@@ -139,7 +141,7 @@ for page in client.latest_api(q="news", paginate=True, max_pages=5):
 
 ## Real-time news (WebSocket)
 
-Register a query first — the returned `registration_id` identifies it from then on:
+Requires Python 3.10 or newer. Register a query first — the returned `registration_id` identifies it from then on:
 
 ```python
 from newsdataapi import NewsDataApiClient, NewsDataApiWebSocket
@@ -219,6 +221,8 @@ ws = NewsDataApiWebSocket(
 ```python
 from newsdataapi import (
     NewsdataAPIError,
+    NewsdataApiKeyLimitExceededError,
+    NewsdataApiLimitExceededError,
     NewsdataAuthError,
     NewsdataNetworkError,
     NewsdataRateLimitError,
@@ -228,6 +232,10 @@ try:
     client.latest_api(q="news")
 except NewsdataAuthError as e:
     print(f"bad API key (HTTP {e.status_code})")
+except NewsdataApiKeyLimitExceededError:
+    print("this API key's own credit cap is exhausted")
+except NewsdataApiLimitExceededError:
+    print("account credit pool is exhausted")
 except NewsdataRateLimitError as e:
     print(f"rate limited; retry after {e.retry_after}s")
 except NewsdataAPIError as e:
@@ -240,18 +248,24 @@ The full hierarchy:
 
 ```
 NewsdataException
-├── NewsdataValidationError      (also a ValueError; carries .param)
-├── NewsdataAPIError             (carries .status_code, .response_body)
-│   ├── NewsdataAuthError        (401 / 403)
-│   ├── NewsdataRateLimitError   (429; carries .retry_after)
-│   └── NewsdataServerError      (5xx)
-├── NewsdataNetworkError         (carries .original)
-└── NewsdataWebSocketError       (real-time stream)
+├── NewsdataValidationError              (also a ValueError; carries .param)
+├── NewsdataAPIError                     (carries .status_code, .response_body)
+│   ├── NewsdataAuthError                (401 / 403)
+│   ├── NewsdataRateLimitError           (429; carries .retry_after)
+│   │   ├── NewsdataApiLimitExceededError      (account credit pool exhausted)
+│   │   └── NewsdataApiKeyLimitExceededError   (this API key's own credit cap exhausted)
+│   └── NewsdataServerError              (5xx)
+├── NewsdataNetworkError                 (carries .original)
+└── NewsdataWebSocketError               (real-time stream)
     └── NewsdataWebSocketAuthError  (handshake 401 / 403, or policy-violation close 1008)
 ```
 
+`NewsdataApiLimitExceededError` and `NewsdataApiKeyLimitExceededError` are both subclasses of `NewsdataRateLimitError`, so existing code that only catches `NewsdataRateLimitError` keeps working unchanged — catch the specific subclasses only if you want to react differently to each. Neither is ever retried.
+
 `NewsdataException` is always a valid catch-all.
 
+When a request succeeds and `include_headers=True`, the response dict's `response_headers` also carries `X-API-Limit-Remaining` (account pool) and, for API keys with a credit cap, `X-APIKEY-Limit-Remaining` (that key's own remaining credits).
+
 ## Save results to CSV
 
 ```python

{newsdataapi-0.3.2 → newsdataapi-0.3.4}/README.md

@@ -27,7 +27,7 @@ If you use [uv](https://github.com/astral-sh/uv):
 uv add newsdataapi
 ```
 
-Supports Python 3.10 through 3.14. The runtime dependencies are `requests` (REST) and `websockets` (real-time streaming).
+Supports Python 3.8 through 3.14. The runtime dependencies are `requests` (REST) and `websockets` (real-time streaming). `NewsDataApiWebSocket` requires Python 3.10 or newer, so `websockets` is only installed there; on 3.8 and 3.9 the REST client works as usual.
 
 ## Quickstart
 
@@ -89,7 +89,7 @@ for page in client.latest_api(q="news", paginate=True, max_pages=5):
 
 ## Real-time news (WebSocket)
 
-Register a query first — the returned `registration_id` identifies it from then on:
+Requires Python 3.10 or newer. Register a query first — the returned `registration_id` identifies it from then on:
 
 ```python
 from newsdataapi import NewsDataApiClient, NewsDataApiWebSocket
@@ -169,6 +169,8 @@ ws = NewsDataApiWebSocket(
 ```python
 from newsdataapi import (
     NewsdataAPIError,
+    NewsdataApiKeyLimitExceededError,
+    NewsdataApiLimitExceededError,
     NewsdataAuthError,
     NewsdataNetworkError,
     NewsdataRateLimitError,
@@ -178,6 +180,10 @@ try:
     client.latest_api(q="news")
 except NewsdataAuthError as e:
     print(f"bad API key (HTTP {e.status_code})")
+except NewsdataApiKeyLimitExceededError:
+    print("this API key's own credit cap is exhausted")
+except NewsdataApiLimitExceededError:
+    print("account credit pool is exhausted")
 except NewsdataRateLimitError as e:
     print(f"rate limited; retry after {e.retry_after}s")
 except NewsdataAPIError as e:
@@ -190,18 +196,24 @@ The full hierarchy:
 
 ```
 NewsdataException
-├── NewsdataValidationError      (also a ValueError; carries .param)
-├── NewsdataAPIError             (carries .status_code, .response_body)
-│   ├── NewsdataAuthError        (401 / 403)
-│   ├── NewsdataRateLimitError   (429; carries .retry_after)
-│   └── NewsdataServerError      (5xx)
-├── NewsdataNetworkError         (carries .original)
-└── NewsdataWebSocketError       (real-time stream)
+├── NewsdataValidationError              (also a ValueError; carries .param)
+├── NewsdataAPIError                     (carries .status_code, .response_body)
+│   ├── NewsdataAuthError                (401 / 403)
+│   ├── NewsdataRateLimitError           (429; carries .retry_after)
+│   │   ├── NewsdataApiLimitExceededError      (account credit pool exhausted)
+│   │   └── NewsdataApiKeyLimitExceededError   (this API key's own credit cap exhausted)
+│   └── NewsdataServerError              (5xx)
+├── NewsdataNetworkError                 (carries .original)
+└── NewsdataWebSocketError               (real-time stream)
     └── NewsdataWebSocketAuthError  (handshake 401 / 403, or policy-violation close 1008)
 ```
 
+`NewsdataApiLimitExceededError` and `NewsdataApiKeyLimitExceededError` are both subclasses of `NewsdataRateLimitError`, so existing code that only catches `NewsdataRateLimitError` keeps working unchanged — catch the specific subclasses only if you want to react differently to each. Neither is ever retried.
+
 `NewsdataException` is always a valid catch-all.
 
+When a request succeeds and `include_headers=True`, the response dict's `response_headers` also carries `X-API-Limit-Remaining` (account pool) and, for API keys with a credit cap, `X-APIKEY-Limit-Remaining` (that key's own remaining credits).
+
 ## Save results to CSV
 
 ```python

{newsdataapi-0.3.2 → newsdataapi-0.3.4}/pyproject.toml

@@ -5,11 +5,13 @@ dynamic = ["version"]
 readme = "README.md"
 license = { file = "LICENSE" }
 authors = [{ name = "NewsData.io", email = "contact@newsdata.io" }]
-requires-python = ">=3.10"
+requires-python = ">=3.8"
 
 dependencies = [
     "requests>=2.25,<3",
-    "websockets>=16,<17",
+    # websockets 16 needs Python 3.10+. On 3.8/3.9 it is not installed: the
+    # REST client works there, and NewsDataApiWebSocket raises on construction.
+    "websockets>=16,<17; python_version >= '3.10'",
 ]
 
 keywords = [
@@ -37,6 +39,8 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
@@ -90,7 +94,7 @@ addopts = [
 
 [tool.ruff]
 line-length = 100
-target-version = "py310"
+target-version = "py38"
 
 [tool.ruff.lint]
 select = [
@@ -107,6 +111,7 @@ select = [
 ]
 
 [tool.mypy]
-python_version = "3.10"
+# mypy no longer accepts 3.8 as a target; the 3.8 CI job covers it at runtime.
+python_version = "3.9"
 strict = true
 files = ["src/newsdataapi"]

{newsdataapi-0.3.2 → newsdataapi-0.3.4}/src/newsdataapi/__init__.py

@@ -4,6 +4,8 @@ from .client import NewsDataApiClient
 from .csv_export import save_to_csv
 from .exceptions import (
     NewsdataAPIError,
+    NewsdataApiKeyLimitExceededError,
+    NewsdataApiLimitExceededError,
     NewsdataAuthError,
     NewsdataException,
     NewsdataNetworkError,
@@ -15,12 +17,14 @@ from .exceptions import (
 )
 from .websocket import NewsDataApiWebSocket
 
-__version__ = "0.3.2"
+__version__ = "0.3.4"
 
 __all__ = [
     "NewsDataApiClient",
     "NewsDataApiWebSocket",
     "NewsdataAPIError",
+    "NewsdataApiKeyLimitExceededError",
+    "NewsdataApiLimitExceededError",
     "NewsdataAuthError",
     "NewsdataException",
     "NewsdataNetworkError",

{newsdataapi-0.3.2 → newsdataapi-0.3.4}/src/newsdataapi/client.py

@@ -18,6 +18,8 @@ from requests.exceptions import RequestException
 from . import constants, csv_export
 from .exceptions import (
     NewsdataAPIError,
+    NewsdataApiKeyLimitExceededError,
+    NewsdataApiLimitExceededError,
     NewsdataAuthError,
     NewsdataException,
     NewsdataNetworkError,
@@ -85,7 +87,10 @@ _MUTEX_GROUPS: tuple[tuple[str, ...], ...] = (
     ("domain", "domainurl", "excludedomain", "excludedomainurl"),
 )
 
-_QUOTA_EXHAUSTED_CODES = frozenset({"ApiKeyLimitExceeded", "ApiLimitExceeded"})
+_QUOTA_EXHAUSTED_ERRORS: dict[str, type[NewsdataRateLimitError]] = {
+    "ApiLimitExceeded": NewsdataApiLimitExceededError,
+    "ApiKeyLimitExceeded": NewsdataApiKeyLimitExceededError,
+}
 
 
 def _validate_params(user_params: Mapping[str, Any]) -> dict[str, Any]:
@@ -1190,13 +1195,19 @@ class NewsDataApiClient:
                 continue
 
             elapsed = time.perf_counter() - t0
-            logger.debug(
-                "%d %s (%.2fs) X-API-Limit-Remaining=%s",
+            apikey_limit_remaining = response.headers.get("X-APIKEY-Limit-Remaining")
+            log_msg = "%d %s (%.2fs) X-API-Limit-Remaining=%s"
+            log_args = [
                 response.status_code,
                 response.reason,
                 elapsed,
                 response.headers.get("X-API-Limit-Remaining"),
-            )
+            ]
+            if apikey_limit_remaining is not None:
+                # Only sent for API keys that have a credit cap set.
+                log_msg += " X-APIKEY-Limit-Remaining=%s"
+                log_args.append(apikey_limit_remaining)
+            logger.debug(log_msg, *log_args)
 
             try:
                 body: Any = response.json()
@@ -1230,11 +1241,10 @@ class NewsDataApiClient:
             # Rate limit.
             if response.status_code == 429:
                 retry_after = _parse_retry_after(response.headers.get("Retry-After"))
-                if (
-                    _extract_error_code(body) in _QUOTA_EXHAUSTED_CODES
-                    or attempt >= self.max_retries
-                ):
-                    raise NewsdataRateLimitError(
+                error_code = _extract_error_code(body)
+                exc_cls = _QUOTA_EXHAUSTED_ERRORS.get(error_code or "", NewsdataRateLimitError)
+                if error_code in _QUOTA_EXHAUSTED_ERRORS or attempt >= self.max_retries:
+                    raise exc_cls(
                         body,
                         status_code=429,
                         response_body=body if isinstance(body, dict) else None,

{newsdataapi-0.3.2 → newsdataapi-0.3.4}/src/newsdataapi/exceptions.py

@@ -40,7 +40,7 @@ class NewsdataAPIError(NewsdataException):
         message: Any,
         *,
         status_code: int | None = None,
-        response_body: dict[str, Any] | None = None,
+        response_body: dict[str, Any] | None = None
     ) -> None:
         super().__init__(message)
         self.status_code = status_code
@@ -76,6 +76,21 @@ class NewsdataRateLimitError(NewsdataAPIError):
         self.retry_after = retry_after
 
 
+class NewsdataApiLimitExceededError(NewsdataRateLimitError):
+    """Raised on 429 when the account's overall credit pool is exhausted.
+
+    Blocks every API key on the account, regardless of any per-key cap.
+    Never retried.
+    """
+
+
+class NewsdataApiKeyLimitExceededError(NewsdataRateLimitError):
+    """Raised on 429 when this specific API key's own credit cap
+    (``max_credit_limit``) is exhausted, even though the account's overall
+    pool may still have credits left. Never retried.
+    """
+
+
 class NewsdataServerError(NewsdataAPIError):
     """Raised on 5xx responses when retries are exhausted."""
 

{newsdataapi-0.3.2 → newsdataapi-0.3.4}/src/newsdataapi/websocket.py

@@ -11,14 +11,11 @@ from __future__ import annotations
 import asyncio
 import json
 import logging
+import sys
 import time
 from collections.abc import AsyncIterator, Iterator
 from typing import Any
 
-from websockets.asyncio import client as _asyncio_client
-from websockets.exceptions import ConnectionClosedError, InvalidStatus
-from websockets.sync import client as _sync_client
-
 from . import constants
 from .client import NewsDataApiClient, _redact_url, _validate_params
 from .exceptions import (
@@ -27,6 +24,15 @@ from .exceptions import (
     NewsdataWebSocketError,
 )
 
+# websockets requires Python 3.10+ and is not installed on older versions,
+# where only the REST client is available.
+_WEBSOCKET_SUPPORTED = sys.version_info >= (3, 10)
+
+if _WEBSOCKET_SUPPORTED:
+    from websockets.asyncio import client as _asyncio_client
+    from websockets.exceptions import ConnectionClosedError, InvalidStatus
+    from websockets.sync import client as _sync_client
+
 logger = logging.getLogger(__name__)
 
 
@@ -109,6 +115,9 @@ class NewsDataApiWebSocket:
     always raises :class:`~newsdataapi.NewsdataWebSocketAuthError` and is
     never retried.
 
+    Requires Python 3.10 or newer; on older versions the constructor raises
+    :class:`~newsdataapi.NewsdataWebSocketError`.
+
     Args:
         api_client: The :class:`~newsdataapi.NewsDataApiClient` that supplies
             the API key and performs the management HTTP calls. Not closed by
@@ -147,6 +156,12 @@ class NewsDataApiWebSocket:
         additional_headers: dict[str, str] | None = None,
         proxy: str | None = None,
     ) -> None:
+        if not _WEBSOCKET_SUPPORTED:
+            raise NewsdataWebSocketError(
+                "NewsDataApiWebSocket requires Python 3.10 or newer (this is Python "
+                f"{sys.version_info.major}.{sys.version_info.minor}); "
+                "NewsDataApiClient works on Python 3.8+"
+            )
         self.api_client = api_client
         self._base_url = base_url
         self._reconnect = reconnect

{newsdataapi-0.3.2 → newsdataapi-0.3.4}/tests/conftest.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import sys
 from collections.abc import Iterator
 
 import pytest
@@ -9,6 +10,9 @@ import responses
 
 from newsdataapi import NewsDataApiClient
 
+# test_websocket.py imports websockets, which is only installed on Python 3.10+.
+collect_ignore = ["test_websocket.py"] if sys.version_info < (3, 10) else []
+
 
 @pytest.fixture
 def mocked_responses() -> Iterator[responses.RequestsMock]:

{newsdataapi-0.3.2 → newsdataapi-0.3.4}/tests/test_unit.py

@@ -7,6 +7,7 @@ API key.
 
 from __future__ import annotations
 
+import sys
 from datetime import datetime, timedelta, timezone
 from email.utils import format_datetime
 from pathlib import Path
@@ -18,6 +19,8 @@ import responses
 from newsdataapi import (
     NewsDataApiClient,
     NewsdataAPIError,
+    NewsdataApiKeyLimitExceededError,
+    NewsdataApiLimitExceededError,
     NewsDataApiWebSocket,
     NewsdataAuthError,
     NewsdataException,
@@ -25,6 +28,7 @@ from newsdataapi import (
     NewsdataRateLimitError,
     NewsdataServerError,
     NewsdataValidationError,
+    NewsdataWebSocketError,
     save_to_csv,
 )
 from newsdataapi.client import (
@@ -726,6 +730,26 @@ def test_include_headers_merges_into_response(
     assert response["response_headers"]["X-API-Limit-Remaining"] == "100"
 
 
+def test_include_headers_merges_apikey_limit_header(
+    mocked_responses: responses.RequestsMock,
+) -> None:
+    """``X-APIKEY-Limit-Remaining`` is only sent for API keys with a credit
+    cap, but the client passes it through like any other header."""
+    with NewsDataApiClient("k", include_headers=True, max_retries=1) as c:
+        mocked_responses.get(
+            LATEST_URL,
+            json={"status": "success", "results": []},
+            status=200,
+            headers={
+                "X-API-Limit-Remaining": "100",
+                "X-APIKEY-Limit-Remaining": "25",
+            },
+        )
+        response = c.latest_api()
+    assert isinstance(response, dict)
+    assert response["response_headers"]["X-APIKEY-Limit-Remaining"] == "25"
+
+
 def test_status_error_with_200_raises_api_error(
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
@@ -833,18 +857,27 @@ def test_429_exhausted_raises_rate_limit_with_retry_after(
     assert exc_info.value.retry_after == 5
 
 
-@pytest.mark.parametrize("code", ["ApiKeyLimitExceeded", "ApiLimitExceeded"])
+@pytest.mark.parametrize(
+    ("code", "expected_exc"),
+    [
+        ("ApiLimitExceeded", NewsdataApiLimitExceededError),
+        ("ApiKeyLimitExceeded", NewsdataApiKeyLimitExceededError),
+    ],
+)
 def test_429_quota_exhausted_raises_without_retry(
     code: str,
+    expected_exc: type[NewsdataRateLimitError],
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
     no_sleep: None,
 ) -> None:
-    """A 429 whose error code means exhausted credits is never retried."""
+    """A 429 whose error code means exhausted credits is never retried,
+    and raises the specific subclass for that code."""
     body = {"status": "error", "results": {"message": "limit", "code": code}}
     mocked_responses.get(LATEST_URL, json=body, status=429)
-    with pytest.raises(NewsdataRateLimitError) as exc_info:
+    with pytest.raises(expected_exc) as exc_info:
         client.latest_api()
+    assert isinstance(exc_info.value, NewsdataRateLimitError)
     assert len(mocked_responses.calls) == 1
     assert exc_info.value.response_body == body
 
@@ -1348,7 +1381,23 @@ WS_REGISTER_URL = "https://newsdata.io/api/1/websocket/register"
 WS_FETCH_URL = "https://newsdata.io/api/1/websocket/fetch"
 WS_DELETE_URL = "https://newsdata.io/api/1/websocket/delete"
 
+# NewsDataApiWebSocket can't be constructed below Python 3.10.
+requires_websocket = pytest.mark.skipif(
+    sys.version_info < (3, 10), reason="WebSocket support requires Python 3.10+"
+)
+
+
+def test_websocket_requires_python_310(
+    client: NewsDataApiClient,
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    """Below Python 3.10, construction fails up front with a clear error."""
+    monkeypatch.setattr("newsdataapi.websocket._WEBSOCKET_SUPPORTED", False)
+    with pytest.raises(NewsdataWebSocketError, match="requires Python 3.10"):
+        NewsDataApiWebSocket(client)
+
 
+@requires_websocket
 def test_websocket_register_posts_query_params(
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
@@ -1375,6 +1424,7 @@ def test_websocket_register_posts_query_params(
     assert not sent.body  # params travel in the query string, not a body
 
 
+@requires_websocket
 def test_websocket_register_always_sends_news_type_latest(
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
@@ -1390,6 +1440,7 @@ def test_websocket_register_always_sends_news_type_latest(
     assert "news_type=latest" in sent_url
 
 
+@requires_websocket
 def test_websocket_register_mutex_validation_applies(
     client: NewsDataApiClient,
 ) -> None:
@@ -1398,6 +1449,7 @@ def test_websocket_register_mutex_validation_applies(
         NewsDataApiWebSocket(client).websocket_register(q="a", qInTitle="b")
 
 
+@requires_websocket
 def test_websocket_register_raw_query(
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
@@ -1414,6 +1466,7 @@ def test_websocket_register_raw_query(
     assert "news_type=latest" in sent_url
 
 
+@requires_websocket
 def test_websocket_register_raw_query_rejects_unknown_param(
     client: NewsDataApiClient,
 ) -> None:
@@ -1422,6 +1475,7 @@ def test_websocket_register_raw_query_rejects_unknown_param(
         NewsDataApiWebSocket(client).websocket_register(raw_query="q=pizza&size=10")
 
 
+@requires_websocket
 def test_websocket_register_sends_excludedomainurl(
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
@@ -1439,6 +1493,7 @@ def test_websocket_register_sends_excludedomainurl(
     assert "excludedomainurl=bbc.com%2Ccnn.com" in sent_url
 
 
+@requires_websocket
 def test_websocket_register_duplicate_409(
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
@@ -1466,6 +1521,7 @@ def test_websocket_register_duplicate_409(
     assert len(mocked_responses.calls) == 1  # 4xx is never retried
 
 
+@requires_websocket
 def test_websocket_register_403_raises_auth(
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
@@ -1476,6 +1532,7 @@ def test_websocket_register_403_raises_auth(
         NewsDataApiWebSocket(client).websocket_register(q="pizza")
 
 
+@requires_websocket
 def test_websocket_register_429_exhausts_to_rate_limit(
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
@@ -1488,6 +1545,7 @@ def test_websocket_register_429_exhausts_to_rate_limit(
         NewsDataApiWebSocket(client).websocket_register(q="pizza")
 
 
+@requires_websocket
 def test_websocket_fetch_returns_queries(
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
@@ -1518,6 +1576,7 @@ def test_websocket_fetch_returns_queries(
     assert "apikey=test_key_xxx" in sent_url
 
 
+@requires_websocket
 def test_websocket_delete_sends_registration_id(
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
@@ -1537,6 +1596,7 @@ def test_websocket_delete_sends_registration_id(
     assert "registration_id=abc123" in sent_url
 
 
+@requires_websocket
 def test_websocket_delete_unknown_id_404(
     client: NewsDataApiClient,
     mocked_responses: responses.RequestsMock,
@@ -1547,6 +1607,7 @@ def test_websocket_delete_unknown_id_404(
     assert exc_info.value.status_code == 404
 
 
+@requires_websocket
 @pytest.mark.parametrize("bad_id", ["", None, 123])
 def test_websocket_delete_rejects_bad_registration_id(
     client: NewsDataApiClient,