getanyapi 0.35.2__tar.gz → 0.36.0__tar.gz

{getanyapi-0.35.2 → getanyapi-0.36.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: getanyapi
-Version: 0.35.2
+Version: 0.36.0
 Summary: Official typed Python SDK for AnyAPI: any API, one wallet, USD, no subscriptions.
 Project-URL: Homepage, https://getanyapi.com
 Project-URL: Documentation, https://getanyapi.com/docs

{getanyapi-0.35.2 → getanyapi-0.36.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "getanyapi"
-version = "0.35.2"
+version = "0.36.0"
 description = "Official typed Python SDK for AnyAPI: any API, one wallet, USD, no subscriptions."
 readme = "README.md"
 requires-python = ">=3.10"

{getanyapi-0.35.2 → getanyapi-0.36.0}/src/getanyapi/__init__.py

@@ -54,7 +54,7 @@ from .types import (
     unwrap,
 )
 
-__version__ = "0.35.2"
+__version__ = "0.36.0"
 
 __all__ = [
     # clients + top-level functions

{getanyapi-0.35.2 → getanyapi-0.36.0}/src/getanyapi/_account.py

@@ -49,13 +49,26 @@ def catalog_request(category: str | None) -> tuple[str, dict[str, str]]:
 
 
 def search_request(
-    query: str,
+    query: str | None,
     category: str | None,
     platform: str | None,
     limit: int | None,
 ) -> tuple[str, dict[str, str]]:
-    """Path and query params for dedicated ranked discovery search."""
-    params = {"q": query}
+    """Path and query params for dedicated ranked discovery search.
+
+    The gateway needs at least one of query, category or platform, in any
+    combination, so a scope with no query at all is a valid search. An absent or
+    empty query omits ``q`` entirely, because an empty ``q`` is a different
+    request.
+    """
+    if not query and category is None and platform is None:
+        raise AnyAPIError(
+            "search needs at least one of query, category, or platform",
+            status=0,
+        )
+    params: dict[str, str] = {}
+    if query:
+        params["q"] = query
     if category is not None:
         params["category"] = category
     if platform is not None:

{getanyapi-0.35.2 → getanyapi-0.36.0}/src/getanyapi/_async_client.py

@@ -370,7 +370,7 @@ class AsyncAnyAPI:
     async def search(
         self,
         *,
-        query: str,
+        query: str | None = None,
         category: str | None = None,
         platform: str | None = None,
         limit: int | None = None,

{getanyapi-0.35.2 → getanyapi-0.36.0}/src/getanyapi/_client.py

@@ -398,7 +398,7 @@ class AnyAPI:
     def search(
         self,
         *,
-        query: str,
+        query: str | None = None,
         category: str | None = None,
         platform: str | None = None,
         limit: int | None = None,

{getanyapi-0.35.2 → getanyapi-0.36.0}/src/getanyapi/platforms/tiktok.py

@@ -1884,7 +1884,7 @@ class TiktokNamespace:
         List recent TikTok videos for a hashtag (creator, caption, views, likes,
         shares).
 
-        Price: $0.0036 per request.
+        Price: $0.00144 per request.
 
         Example:
             res = client.tiktok.hashtag_videos(hashtag="cooking", limit=3)
@@ -2759,7 +2759,7 @@ class AsyncTiktokNamespace:
         List recent TikTok videos for a hashtag (creator, caption, views, likes,
         shares).
 
-        Price: $0.0036 per request.
+        Price: $0.00144 per request.
 
         Example:
             res = client.tiktok.hashtag_videos(hashtag="cooking", limit=3)

{getanyapi-0.35.2 → getanyapi-0.36.0}/tests/test_account.py

@@ -12,6 +12,7 @@ import pytest
 
 from conftest import json_response, make_async_client, make_sync_client
 from getanyapi import (
+    AnyAPIError,
     DiscoveryPricing,
     FlatPricingOffer,
     LinearPricingOffer,
@@ -331,6 +332,40 @@ def test_search_reads_every_shared_ranked_field_and_forwards_filters() -> None:
     assert found.model_dump(by_alias=True, exclude_defaults=True) == body
 
 
+def test_search_scopes_without_a_query_and_omits_q_entirely() -> None:
+    body = discovery_search()
+
+    def respond(req: httpx.Request) -> httpx.Response:
+        assert req.url.path == "/catalog/search"
+        assert dict(req.url.params) == {"platform": "reddit"}
+        return json_response(200, body)
+
+    client, _ = make_sync_client(respond)
+    assert client.search(platform="reddit").results
+
+
+def test_search_omits_an_empty_query_rather_than_sending_it_empty() -> None:
+    body = discovery_search()
+
+    def respond(req: httpx.Request) -> httpx.Response:
+        assert "q" not in dict(req.url.params)
+        return json_response(200, body)
+
+    client, _ = make_sync_client(respond)
+    assert client.search(query="", category="social").results
+
+
+def test_search_without_query_category_or_platform_never_calls_the_gateway() -> None:
+    client, recorder = make_sync_client(
+        lambda _req: json_response(200, discovery_search())
+    )
+    with pytest.raises(
+        AnyAPIError, match="at least one of query, category, or platform"
+    ):
+        client.search(limit=5)
+    assert recorder.requests == []
+
+
 def test_search_drops_safe_additive_result_and_envelope_fields() -> None:
     body = discovery_search()
     results = cast("list[dict[str, object]]", body["results"])