getanyapi 0.61.2__tar.gz → 0.63.0__tar.gz

{getanyapi-0.61.2 → getanyapi-0.63.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: getanyapi
-Version: 0.61.2
+Version: 0.63.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
@@ -195,8 +195,9 @@ result = agent_signup(label="my-agent")
 client = AnyAPI(api_key=result.secret)
 ```
 
-The key ships with a small starter balance and a per-key spend cap; a human funds it by claiming
-it at `result.claim_url`.
+The key ships with a small starter balance and a per-key spend cap; to go past the cap, a human
+authorizes an AnyAPI wallet over OAuth, as described in
+[agent self-signup](https://getanyapi.com/docs/agent-self-signup).
 
 ## Docs
 

{getanyapi-0.61.2 → getanyapi-0.63.0}/README.md

@@ -166,8 +166,9 @@ result = agent_signup(label="my-agent")
 client = AnyAPI(api_key=result.secret)
 ```
 
-The key ships with a small starter balance and a per-key spend cap; a human funds it by claiming
-it at `result.claim_url`.
+The key ships with a small starter balance and a per-key spend cap; to go past the cap, a human
+authorizes an AnyAPI wallet over OAuth, as described in
+[agent self-signup](https://getanyapi.com/docs/agent-self-signup).
 
 ## Docs
 

{getanyapi-0.61.2 → getanyapi-0.63.0}/pyproject.toml

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

{getanyapi-0.61.2 → getanyapi-0.63.0}/src/getanyapi/__init__.py

@@ -55,7 +55,7 @@ from .types import (
     unwrap,
 )
 
-__version__ = "0.61.2"
+__version__ = "0.63.0"
 
 __all__ = [
     # clients + top-level functions

{getanyapi-0.61.2 → getanyapi-0.63.0}/src/getanyapi/platforms/maps.py

@@ -746,7 +746,7 @@ class MapsNamespace:
         Fetch up to 100 Google Maps reviews for a place by place ID, sorted the way
         you need, in one normalized response.
 
-        Price: $0.00605 per request plus $0.00005 per result (maximum $0.0105).
+        Price: $0.0035 per request.
 
         Example:
             res = client.maps.reviews(limit=3, placeId="ChIJN1t_tDeuEmsRUsoyG83frY4")
@@ -881,7 +881,7 @@ class AsyncMapsNamespace:
         Fetch up to 100 Google Maps reviews for a place by place ID, sorted the way
         you need, in one normalized response.
 
-        Price: $0.00605 per request plus $0.00005 per result (maximum $0.0105).
+        Price: $0.0035 per request.
 
         Example:
             res = client.maps.reviews(limit=3, placeId="ChIJN1t_tDeuEmsRUsoyG83frY4")

{getanyapi-0.61.2 → getanyapi-0.63.0}/src/getanyapi/platforms/zillow.py

@@ -15,6 +15,21 @@ if TYPE_CHECKING:
     from .._client import AnyAPI
 
 
+class ZillowAgentInput(TypedDict, total=False):
+    """Input for Zillow Agent."""
+
+    allowFallbacks: NotRequired[bool]
+    """Optional, default true. When false, only the sources listed in `source` may serve; the request is refused with no charge if none of them can. When true, the listed sources are tried first and any other source may serve after them, at the normal price. Default: true."""
+    ignoreSources: NotRequired[list[str]]
+    """Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
+    preferLatencyUnderMs: NotRequired[int]
+    """Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. Minimum: 1."""
+    source: NotRequired[list[str]]
+    """Optional. Source ids to prefer, in order, taken from this endpoint's `lanes[].source.id` in /catalog or /apis. Omit it and the cheapest source serves, with automatic failover. Listed sources are tried first in the order given, then the others, unless `allowFallbacks` is false. A single source with `allowFallbacks` false is served only by that source at its price, quoted and charged exactly, with no failover. The price is that of the dearest source that may serve. An id that does not serve this endpoint is rejected as invalid input with no charge; a listed source that is not serving right now is refused with no charge, so omit `source` to be served by another. On a paginated walk, later pages must include the source that served page one, or omit `source`."""
+    url: Required[str]
+    """Zillow agent profile URL (e.g. https://www.zillow.com/profile/gregorycarlsonATX/)."""
+
+
 class ZillowPropertyInput(TypedDict, total=False):
     """Input for Zillow Property."""
 
@@ -152,6 +167,67 @@ class ZillowSearchInput(TypedDict, total=False):
     """Optional. Source ids to prefer, in order, taken from this endpoint's `lanes[].source.id` in /catalog or /apis. Omit it and the cheapest source serves, with automatic failover. Listed sources are tried first in the order given, then the others, unless `allowFallbacks` is false. A single source with `allowFallbacks` false is served only by that source at its price, quoted and charged exactly, with no failover. The price is that of the dearest source that may serve. An id that does not serve this endpoint is rejected as invalid input with no charge; a listed source that is not serving right now is refused with no charge, so omit `source` to be served by another. On a paginated walk, later pages must include the source that served page one, or omit `source`."""
 
 
+class ZillowAgentData(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    bio: str | None = Field(
+        default=None, description="Agent's self-written biography, as HTML."
+    )
+    company: str | None = Field(
+        default=None,
+        description="Brokerage or business name the agent works under. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
+    )
+    email: str | None = Field(
+        default=None,
+        description="Agent's email address as listed on the profile. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
+    )
+    for_sale_count: int | None = Field(
+        default=None,
+        alias="forSaleCount",
+        description="Number of active for-sale listings.",
+    )
+    image: str | None = Field(
+        default=None,
+        description="Profile photo URL. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
+    )
+    is_top_agent: bool | None = Field(
+        default=None,
+        alias="isTopAgent",
+        description="True when Zillow flags the agent as a top agent.",
+    )
+    name: str = Field(
+        description="Agent's full name. Populated whenever the provider has data for the entity."
+    )
+    phone: str | None = Field(
+        default=None,
+        description="Agent's phone number as listed on the profile (the cell number when one is listed). Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
+    )
+    rating: float | None = Field(
+        default=None, description="Average review rating out of 5."
+    )
+    review_count: int | None = Field(
+        default=None,
+        alias="reviewCount",
+        description="Number of reviews on the profile.",
+    )
+    service_areas: list[str] | None = Field(
+        default=None,
+        alias="serviceAreas",
+        description='Cities and areas the agent lists as served, e.g. "Austin, TX".',
+    )
+    total_sales: int | None = Field(
+        default=None,
+        alias="totalSales",
+        description="Total sales on record for the agent (for a team lead, the team's total).",
+    )
+    url: str = Field(
+        description="Canonical Zillow profile URL. Populated whenever the provider has data for the entity."
+    )
+    username: str = Field(
+        description="Zillow screen name, the last segment of the profile URL. Populated whenever the provider has data for the entity."
+    )
+
+
 class ZillowPropertyData(BaseModel):
     items: list[ZillowPropertyItem] = Field(
         description="The matched property record (single element for a property lookup). Populated whenever the provider has data for the entity."
@@ -344,6 +420,27 @@ class ZillowNamespace:
     def __init__(self, client: "AnyAPI") -> None:
         self._client = client
 
+    def agent(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[ZillowAgentInput],
+    ) -> RunResult[ZillowAgentData]:
+        """Zillow Agent
+
+        Fetch one Zillow real estate agent's profile by URL: name, phone, email,
+        brokerage, rating, review count, sales, and service areas.
+
+        Price: $0.0005 per request.
+
+        Example:
+            res = client.zillow.agent(url="https://www.zillow.com/profile/gregorycarlsonATX/")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "zillow.agent", dict(input), options
+        )
+        return RunResult[ZillowAgentData].model_validate(raw)
+
     def property(
         self,
         *,
@@ -396,6 +493,27 @@ class AsyncZillowNamespace:
     def __init__(self, client: "AsyncAnyAPI") -> None:
         self._client = client
 
+    async def agent(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[ZillowAgentInput],
+    ) -> RunResult[ZillowAgentData]:
+        """Zillow Agent
+
+        Fetch one Zillow real estate agent's profile by URL: name, phone, email,
+        brokerage, rating, review count, sales, and service areas.
+
+        Price: $0.0005 per request.
+
+        Example:
+            res = client.zillow.agent(url="https://www.zillow.com/profile/gregorycarlsonATX/")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "zillow.agent", dict(input), options
+        )
+        return RunResult[ZillowAgentData].model_validate(raw)
+
     async def property(
         self,
         *,

{getanyapi-0.61.2 → getanyapi-0.63.0}/src/getanyapi/types.py

@@ -10,7 +10,7 @@ unknown fields, exposed via ``.model_extra``.
 
 from __future__ import annotations
 
-from typing import Any, Generic, Literal, TypeVar, cast
+from typing import Any, Generic, Literal, TypeVar, cast, get_args
 
 from pydantic import BaseModel, ConfigDict, Field, model_validator
 from typing_extensions import TypedDict
@@ -73,9 +73,10 @@ class OutputFound(BaseModel, Generic[T]):
 # words; ``tests/test_not_found_reason.py`` holds the two together once the live
 # OpenAPI carries the field. ``not_found``: the source states the target does not
 # exist, or returned nothing for it. ``suspended``: the platform has suspended the
-# account.
-NotFoundReason = Literal["not_found", "suspended"]
-NOT_FOUND_REASONS: tuple[str, ...] = ("not_found", "suspended")
+# account. ``unavailable``: the platform did not show this to the source: it may not
+# exist, or it may be visible only to signed-in users.
+NotFoundReason = Literal["not_found", "suspended", "unavailable"]
+NOT_FOUND_REASONS: tuple[str, ...] = get_args(NotFoundReason)
 
 
 class OutputNotFound(BaseModel):
@@ -283,8 +284,6 @@ class AgentSignupResult(BaseModel):
 
     secret: str
     cap_usd: float = Field(alias="capUsd")
-    claim_token: str = Field(alias="claimToken")
-    claim_url: str = Field(alias="claimUrl")
 
 
 # Convenience aliases used by the transport for untyped generic runs.

{getanyapi-0.61.2 → getanyapi-0.63.0}/tests/test_account.py

@@ -464,23 +464,30 @@ def test_describe_404_raises_not_found() -> None:
         client.describe("nope.gone")
 
 
-def test_agent_signup_maps_result(monkeypatch: pytest.MonkeyPatch) -> None:
+SIGNUP_BODY: dict[str, object] = {"secret": "sk_live_x", "capUsd": 0.15, "keyId": "key_1"}
+# The gateway still sends these retired claim-flow fields until it drops them.
+RETIRED_SIGNUP_FIELDS: dict[str, object] = {
+    "verificationStatus": "pending",
+    "claimToken": "",
+    "claimUrl": "https://getanyapi.com/dashboard",
+}
+
+
+@pytest.mark.parametrize(
+    "body",
+    [SIGNUP_BODY, {**SIGNUP_BODY, **RETIRED_SIGNUP_FIELDS}],
+    ids=["without-retired-fields", "with-retired-fields"],
+)
+def test_agent_signup_maps_result(
+    monkeypatch: pytest.MonkeyPatch, body: dict[str, object]
+) -> None:
     captured: dict[str, object] = {}
 
     def handler(request: httpx.Request) -> httpx.Response:
         captured["path"] = request.url.path
         captured["auth"] = request.headers.get("authorization")
         captured["body"] = json.loads(request.content)
-        return json_response(
-            200,
-            {
-                "secret": "sk_live_x",
-                "capUsd": 0.15,
-                "claimToken": "tok",
-                "claimUrl": "https://getanyapi.com/dashboard",
-                "keyId": "key_1",
-            },
-        )
+        return json_response(200, body)
 
     transport = httpx.MockTransport(handler)
     import getanyapi._client as client_mod
@@ -498,8 +505,6 @@ def test_agent_signup_maps_result(monkeypatch: pytest.MonkeyPatch) -> None:
     assert captured["body"] == {"sponsorEmail": "me@x.com", "label": "bot"}
     assert result.secret == "sk_live_x"
     assert result.cap_usd == 0.15
-    assert result.claim_token == "tok"
-    assert result.claim_url == "https://getanyapi.com/dashboard"
 
 
 async def test_async_account() -> None: