getanyapi 0.1.0__py3-none-any.whl

getanyapi/platforms/ebay.py

@@ -0,0 +1,215 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the ebay platform."""
+
+from __future__ import annotations
+
+from typing import Literal, TYPE_CHECKING
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing_extensions import NotRequired, Required, TypedDict, Unpack
+
+from ..types import RequestOptions, RunResult
+
+if TYPE_CHECKING:
+    from .._async_client import AsyncAnyAPI
+    from .._client import AnyAPI
+
+
+class EbaySearchInput(TypedDict, total=False):
+    """Input for eBay Search."""
+
+    limit: NotRequired[int]
+    """Maximum number of results to return (1 to 25, default 25). You are billed per result returned, so a lower limit costs less. Range: 1 to 25."""
+    maxPrice: NotRequired[int]
+    """Optional maximum item price in USD. Minimum: 0."""
+    minPrice: NotRequired[int]
+    """Optional minimum item price in USD. Minimum: 0."""
+    query: Required[str]
+    """Search keywords, e.g. "nintendo switch" or "vintage levis 501"."""
+
+
+class EbaySoldListingsInput(TypedDict, total=False):
+    """Input for eBay Sold Listings."""
+
+    condition: NotRequired[Literal["any", "new", "used"]]
+    """Item condition filter (e.g. used). Default: any."""
+    daysBack: NotRequired[int]
+    """How many days back to include sold listings, 1-90 (e.g. 30). Default: 30."""
+    limit: NotRequired[int]
+    """Maximum number of results to return (1-25, default 25). You are billed per result returned, so a lower limit costs less. Range: 1 to 25."""
+    query: Required[str]
+    """Search keyword for sold items (e.g. iphone 13 pro)."""
+    site: NotRequired[
+        Literal[
+            "ebay.com",
+            "ebay.co.uk",
+            "ebay.de",
+            "ebay.fr",
+            "ebay.it",
+            "ebay.es",
+            "ebay.ca",
+            "ebay.com.au",
+        ]
+    ]
+    """eBay country site to search (e.g. ebay.co.uk). Default: ebay.com."""
+
+
+class EbaySearchData(BaseModel):
+    items: list[EbaySearchItem] = Field(
+        description="Listing records: title, price, condition, shipping cost, seller info, image, and item URL."
+    )
+
+
+class EbaySearchItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    condition: str | None = None
+    image: str | None = Field(
+        default=None,
+        description="Primary listing image URL. Present whenever the upstream returns this record.",
+    )
+    item_id: str = Field(alias="itemId", description="eBay item identifier.")
+    listing_type: str | None = Field(
+        default=None, alias="listingType", description="Auction, FixedPrice, etc."
+    )
+    price: float | None = Field(default=None, description="Listing price.")
+    seller_feedback_percent: float | None = Field(
+        default=None,
+        alias="sellerFeedbackPercent",
+        description="Seller positive-feedback percentage.",
+    )
+    seller_name: str | None = Field(default=None, alias="sellerName")
+    shipping_cost: str | None = Field(
+        default=None,
+        alias="shippingCost",
+        description="Shipping cost or free-delivery label.",
+    )
+    title: str
+    url: str
+
+
+class EbaySoldListingsData(BaseModel):
+    items: list[EbaySoldListingsItem] = Field(
+        description="Sold listing records: title, sold price, sale date, condition, shipping, and item URL."
+    )
+
+
+class EbaySoldListingsItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    condition: str | None = None
+    ended_at: str | None = Field(
+        default=None, alias="endedAt", description="Sale date (ISO 8601)."
+    )
+    image: str | None = Field(
+        default=None,
+        description="Primary listing image URL. Present whenever the upstream returns this record.",
+    )
+    item_id: str = Field(alias="itemId", description="eBay item identifier.")
+    listing_type: str | None = Field(default=None, alias="listingType")
+    seller_username: str | None = Field(default=None, alias="sellerUsername")
+    sold_currency: str | None = Field(default=None, alias="soldCurrency")
+    sold_price: float | None = Field(
+        default=None, alias="soldPrice", description="Final sold price."
+    )
+    title: str
+    total_price: float | None = Field(
+        default=None, alias="totalPrice", description="Sold price plus shipping."
+    )
+    url: str
+
+
+class EbayNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def search(
+        self, *, options: RequestOptions | None = None, **input: Unpack[EbaySearchInput]
+    ) -> RunResult[EbaySearchData]:
+        """eBay Search
+
+        Search eBay active listings by keyword and get title, price, condition,
+        shipping, seller, and sold count in one normalized response. You are billed
+        per result returned.
+
+        Price: $0.001 per request plus $0.00234 per result.
+
+        Example:
+            res = client.ebay.search(limit=3, query="nintendo switch")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "ebay.search", dict(input), options
+        )
+        return RunResult[EbaySearchData].model_validate(raw)
+
+    def sold_listings(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[EbaySoldListingsInput],
+    ) -> RunResult[EbaySoldListingsData]:
+        """eBay Sold Listings
+
+        Retrieve recently sold eBay listings for any keyword - sold price, sale
+        date, condition, and item details - ideal for pricing research, at a flat
+        per-request USD price.
+
+        Price: $0.00005 per request plus $0.004 per result.
+
+        Example:
+            res = client.ebay.sold_listings(limit=3, query="nintendo switch")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "ebay.sold_listings", dict(input), options
+        )
+        return RunResult[EbaySoldListingsData].model_validate(raw)
+
+
+class AsyncEbayNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def search(
+        self, *, options: RequestOptions | None = None, **input: Unpack[EbaySearchInput]
+    ) -> RunResult[EbaySearchData]:
+        """eBay Search
+
+        Search eBay active listings by keyword and get title, price, condition,
+        shipping, seller, and sold count in one normalized response. You are billed
+        per result returned.
+
+        Price: $0.001 per request plus $0.00234 per result.
+
+        Example:
+            res = client.ebay.search(limit=3, query="nintendo switch")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "ebay.search", dict(input), options
+        )
+        return RunResult[EbaySearchData].model_validate(raw)
+
+    async def sold_listings(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[EbaySoldListingsInput],
+    ) -> RunResult[EbaySoldListingsData]:
+        """eBay Sold Listings
+
+        Retrieve recently sold eBay listings for any keyword - sold price, sale
+        date, condition, and item details - ideal for pricing research, at a flat
+        per-request USD price.
+
+        Price: $0.00005 per request plus $0.004 per result.
+
+        Example:
+            res = client.ebay.sold_listings(limit=3, query="nintendo switch")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "ebay.sold_listings", dict(input), options
+        )
+        return RunResult[EbaySoldListingsData].model_validate(raw)

getanyapi/platforms/email.py

@@ -0,0 +1,166 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the email platform."""
+
+from __future__ import annotations
+
+from typing import Any, TYPE_CHECKING
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing_extensions import NotRequired, Required, TypedDict, Unpack
+
+from ..types import RequestOptions, RunResult
+
+if TYPE_CHECKING:
+    from .._async_client import AsyncAnyAPI
+    from .._client import AnyAPI
+
+
+class EmailFindInput(TypedDict, total=False):
+    """Input for Email Finder."""
+
+    person: NotRequired[dict[str, Any]]
+    """The person to find an email for, e.g. {"firstName": "Jane", "surname": "Doe", "domain": "acme.com"} (domain also accepts a company name)."""
+
+
+class EmailVerifyInput(TypedDict, total=False):
+    """Input for Email Verifier."""
+
+    email: Required[str]
+    """The email address to verify (e.g. jane.doe@acme.com)."""
+
+
+class EmailFindData(BaseModel):
+    items: list[EmailFindItem] = Field(
+        description="Email lookup records: the discovered email address, verification status, and the matched person and company details."
+    )
+
+
+class EmailFindItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    domain: str | None = None
+    email: str = Field(
+        description="Discovered email address, or empty when none was found."
+    )
+    first_name: str | None = Field(default=None, alias="firstName")
+    is_deliverable: bool | None = Field(default=None, alias="isDeliverable")
+    last_name: str | None = Field(default=None, alias="lastName")
+    status: str = Field(description="Lookup status (e.g. found, not_found).")
+
+
+class EmailVerifyData(BaseModel):
+    items: list[EmailVerifyItem] = Field(
+        description="Verification records: the email address with its deliverability verdict and syntax, domain, and mailbox check details."
+    )
+
+
+class EmailVerifyItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    catch_all: bool | None = Field(
+        default=None, alias="catchAll", description="Domain accepts all addresses."
+    )
+    disposable: bool | None = None
+    domain: str | None = None
+    email: str
+    free: bool | None = Field(default=None, description="Free email provider.")
+    reason: str | None = None
+    role: bool | None = Field(
+        default=None, description="Role-based address (e.g. info@)."
+    )
+    score: int | None = Field(default=None, description="Confidence score (0-100).")
+    status: str = Field(
+        description="Deliverability verdict (e.g. valid, risky, invalid)."
+    )
+
+
+class EmailNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def find(
+        self, *, options: RequestOptions | None = None, **input: Unpack[EmailFindInput]
+    ) -> RunResult[EmailFindData]:
+        """Email Finder
+
+        Find a person's work email address from their name and company domain, with
+        transparent per-request USD pricing.
+
+        Price: $0.005 per request plus $0.008 per result.
+
+        Example:
+            res = client.email.find(person={"domain": "stripe.com", "firstName": "Patrick", "surname": "Collison"})
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "email.find", dict(input), options
+        )
+        return RunResult[EmailFindData].model_validate(raw)
+
+    def verify(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[EmailVerifyInput],
+    ) -> RunResult[EmailVerifyData]:
+        """Email Verifier
+
+        Verify any email address for deliverability - syntax, domain, and mailbox
+        checks in one normalized response, priced per request in USD.
+
+        Price: $0.0008 per result.
+
+        Example:
+            res = client.email.verify(email="patrick@stripe.com")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "email.verify", dict(input), options
+        )
+        return RunResult[EmailVerifyData].model_validate(raw)
+
+
+class AsyncEmailNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def find(
+        self, *, options: RequestOptions | None = None, **input: Unpack[EmailFindInput]
+    ) -> RunResult[EmailFindData]:
+        """Email Finder
+
+        Find a person's work email address from their name and company domain, with
+        transparent per-request USD pricing.
+
+        Price: $0.005 per request plus $0.008 per result.
+
+        Example:
+            res = client.email.find(person={"domain": "stripe.com", "firstName": "Patrick", "surname": "Collison"})
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "email.find", dict(input), options
+        )
+        return RunResult[EmailFindData].model_validate(raw)
+
+    async def verify(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[EmailVerifyInput],
+    ) -> RunResult[EmailVerifyData]:
+        """Email Verifier
+
+        Verify any email address for deliverability - syntax, domain, and mailbox
+        checks in one normalized response, priced per request in USD.
+
+        Price: $0.0008 per result.
+
+        Example:
+            res = client.email.verify(email="patrick@stripe.com")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "email.verify", dict(input), options
+        )
+        return RunResult[EmailVerifyData].model_validate(raw)