getanyapi 0.1.0__py3-none-any.whl

getanyapi/platforms/tripadvisor.py

@@ -0,0 +1,180 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the tripadvisor platform."""
+
+from __future__ import annotations
+
+from typing import 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 TripadvisorReviewsInput(TypedDict, total=False):
+    """Input for Tripadvisor Reviews."""
+
+    limit: NotRequired[int]
+    """Maximum number of results to return (1-20, default 20). You are billed per result returned, so a lower limit costs less. Range: 1 to 20."""
+    since: NotRequired[str]
+    """Only return reviews newer than this date, YYYY-MM-DD or a relative window like '3 months' (e.g. 2026-01-01)."""
+    url: Required[str]
+    """Tripadvisor page URL of the hotel, restaurant, or attraction."""
+
+
+class TripadvisorSearchInput(TypedDict, total=False):
+    """Input for Tripadvisor Search."""
+
+    currency: NotRequired[str]
+    """ISO currency code for prices (e.g. USD, EUR). Default: USD."""
+    limit: NotRequired[int]
+    """Maximum number of results to return (1-20, default 20). You are billed per result returned, so a lower limit costs less. Range: 1 to 20."""
+    query: Required[str]
+    """Destination or keyword to search for (e.g. Barcelona)."""
+
+
+class TripadvisorReviewsData(BaseModel):
+    items: list[TripadvisorReviewsItem] = Field(
+        description="Review records for the place: rating, title, review text, publish date, trip type, and reviewer details."
+    )
+
+
+class TripadvisorReviewsItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    published_at: str | None = Field(
+        default=None,
+        alias="publishedAt",
+        description="Publish date. Present whenever the upstream returns this record.",
+    )
+    rating: float = Field(description="Star rating (typically 1-5).")
+    text: str = Field(description="Review body text.")
+    title: str | None = Field(
+        default=None, description="Present whenever the upstream returns this record."
+    )
+    url: str | None = Field(
+        default=None,
+        description="Canonical review URL. Present whenever the upstream returns this record.",
+    )
+
+
+class TripadvisorSearchData(BaseModel):
+    items: list[TripadvisorSearchItem] = Field(
+        description="Matching place records: name, type (hotel/restaurant/attraction), rating, review count, address, contact details, and pricing."
+    )
+
+
+class TripadvisorSearchItem(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    rating: float
+    title: str
+    url: str
+
+
+class TripadvisorNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def reviews(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TripadvisorReviewsInput],
+    ) -> RunResult[TripadvisorReviewsData]:
+        """Tripadvisor Reviews
+
+        Fetch the latest reviews for any Tripadvisor hotel, restaurant, or
+        attraction by its page URL - rating, text, date, and trip details as
+        normalized JSON with transparent per-request USD pricing.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.tripadvisor.reviews(limit=3, url="https://www.tripadvisor.com/Hotel_Review-g60763-d93450-Reviews-The_Plaza-New_York_City_New_York.html")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "tripadvisor.reviews", dict(input), options
+        )
+        return RunResult[TripadvisorReviewsData].model_validate(raw)
+
+    def search(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TripadvisorSearchInput],
+    ) -> RunResult[TripadvisorSearchData]:
+        """Tripadvisor Search
+
+        Search Tripadvisor for hotels, restaurants, and attractions in any
+        destination and get rich place records (ratings, review counts, contact
+        details, pricing) as normalized JSON with transparent per-request USD
+        pricing.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.tripadvisor.search(limit=3, query="Paris")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "tripadvisor.search", dict(input), options
+        )
+        return RunResult[TripadvisorSearchData].model_validate(raw)
+
+
+class AsyncTripadvisorNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def reviews(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TripadvisorReviewsInput],
+    ) -> RunResult[TripadvisorReviewsData]:
+        """Tripadvisor Reviews
+
+        Fetch the latest reviews for any Tripadvisor hotel, restaurant, or
+        attraction by its page URL - rating, text, date, and trip details as
+        normalized JSON with transparent per-request USD pricing.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.tripadvisor.reviews(limit=3, url="https://www.tripadvisor.com/Hotel_Review-g60763-d93450-Reviews-The_Plaza-New_York_City_New_York.html")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "tripadvisor.reviews", dict(input), options
+        )
+        return RunResult[TripadvisorReviewsData].model_validate(raw)
+
+    async def search(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TripadvisorSearchInput],
+    ) -> RunResult[TripadvisorSearchData]:
+        """Tripadvisor Search
+
+        Search Tripadvisor for hotels, restaurants, and attractions in any
+        destination and get rich place records (ratings, review counts, contact
+        details, pricing) as normalized JSON with transparent per-request USD
+        pricing.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.tripadvisor.search(limit=3, query="Paris")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "tripadvisor.search", dict(input), options
+        )
+        return RunResult[TripadvisorSearchData].model_validate(raw)

getanyapi/platforms/trustpilot.py

@@ -0,0 +1,114 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the trustpilot platform."""
+
+from __future__ import annotations
+
+from typing import 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 TrustpilotReviewsInput(TypedDict, total=False):
+    """Input for Trustpilot Reviews."""
+
+    company: Required[str]
+    """Brand name or Trustpilot review-page URL to fetch reviews for (e.g. nike or https://www.trustpilot.com/review/nike.com)."""
+    limit: NotRequired[int]
+    """Maximum number of results to return (1-50, default 50). You are billed per result returned, so a lower limit costs less. Range: 1 to 50."""
+    sortBy: NotRequired[str]
+    """Review ordering: auto, relevancy, or recent (e.g. recent). Default: auto."""
+    stars: NotRequired[str]
+    """Limit reviews to a single star rating from 1 to 5 (e.g. 5); omit for all ratings."""
+    verifiedOnly: NotRequired[bool]
+    """Set true to return only verified reviews (e.g. true). Default: false."""
+
+
+class TrustpilotReviewsData(BaseModel):
+    items: list[TrustpilotReviewsItem] = Field(
+        description="Review records: star rating, review title and text, date, reviewer name and country, and company reply when present."
+    )
+
+
+class TrustpilotReviewsItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    published_at: str | None = Field(
+        default=None,
+        alias="publishedAt",
+        description="Publish date (ISO 8601). Present whenever the upstream returns this record.",
+    )
+    rating: float = Field(description="Star rating (1-5).")
+    text: str = Field(description="Review body text.")
+    title: str | None = Field(
+        default=None, description="Present whenever the upstream returns this record."
+    )
+    url: str | None = Field(
+        default=None,
+        description="Canonical review URL. Present whenever the upstream returns this record.",
+    )
+    verified: bool | None = Field(
+        default=None, description="Whether the reviewer is verified."
+    )
+
+
+class TrustpilotNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def reviews(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TrustpilotReviewsInput],
+    ) -> RunResult[TrustpilotReviewsData]:
+        """Trustpilot Reviews
+
+        Pull Trustpilot reviews for any company by brand name - star ratings, review
+        text, dates, and reviewer details as clean JSON, billed per request in USD.
+
+        Price: $0.01625 per request.
+
+        Example:
+            res = client.trustpilot.reviews(company="stripe.com", limit=3)
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "trustpilot.reviews", dict(input), options
+        )
+        return RunResult[TrustpilotReviewsData].model_validate(raw)
+
+
+class AsyncTrustpilotNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def reviews(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TrustpilotReviewsInput],
+    ) -> RunResult[TrustpilotReviewsData]:
+        """Trustpilot Reviews
+
+        Pull Trustpilot reviews for any company by brand name - star ratings, review
+        text, dates, and reviewer details as clean JSON, billed per request in USD.
+
+        Price: $0.01625 per request.
+
+        Example:
+            res = client.trustpilot.reviews(company="stripe.com", limit=3)
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "trustpilot.reviews", dict(input), options
+        )
+        return RunResult[TrustpilotReviewsData].model_validate(raw)

getanyapi/platforms/truthsocial.py

@@ -0,0 +1,226 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the truthsocial platform."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing_extensions import Required, TypedDict, Unpack
+
+from ..types import RequestOptions, RunResult
+
+if TYPE_CHECKING:
+    from .._async_client import AsyncAnyAPI
+    from .._client import AnyAPI
+
+
+class TruthsocialPostInput(TypedDict, total=False):
+    """Input for Truth Social Post."""
+
+    url: Required[str]
+    """Full Truth Social post URL, e.g. "https://truthsocial.com/@realDonaldTrump/posts/116824551176646175"."""
+
+
+class TruthsocialProfileInput(TypedDict, total=False):
+    """Input for Truth Social Profile."""
+
+    handle: Required[str]
+    """Truth Social handle without the @, e.g. "realDonaldTrump"."""
+
+
+class TruthsocialUserPostsInput(TypedDict, total=False):
+    """Input for Truth Social User Posts."""
+
+    handle: Required[str]
+    """Truth Social handle without the @, e.g. "realDonaldTrump"."""
+
+
+class TruthsocialPostData(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    comments: int
+    display_name: str = Field(alias="displayName")
+    id: str
+    likes: int
+    published_at: str = Field(alias="publishedAt")
+    shares: int
+    text: str
+    username: str
+
+
+class TruthsocialProfileData(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    avatar_url: str = Field(alias="avatarUrl")
+    bio: str
+    display_name: str = Field(alias="displayName")
+    followers: int
+    following: int
+    id: str
+    joined_at: str = Field(alias="joinedAt")
+    posts_count: int = Field(alias="postsCount")
+    private: bool
+    url: str
+    username: str
+    verified: bool
+
+
+class TruthsocialUserPostsData(BaseModel):
+    posts: list[TruthsocialUserPostsPost]
+
+
+class TruthsocialUserPostsPost(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    comments: int
+    id: str
+    likes: int
+    published_at: str = Field(alias="publishedAt")
+    shares: int
+    text: str
+    url: str
+
+
+class TruthsocialNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def post(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TruthsocialPostInput],
+    ) -> RunResult[TruthsocialPostData]:
+        """Truth Social Post
+
+        Get a single Truth Social post by its URL - text, author, engagement (likes,
+        comments, shares), and timestamp as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.truthsocial.post(url="https://truthsocial.com/@realDonaldTrump/posts/116824551176646175")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "truthsocial.post", dict(input), options
+        )
+        return RunResult[TruthsocialPostData].model_validate(raw)
+
+    def profile(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TruthsocialProfileInput],
+    ) -> RunResult[TruthsocialProfileData]:
+        """Truth Social Profile
+
+        Get a Truth Social account's public profile by handle - display name, bio,
+        follower/following counts, and post count as clean JSON, billed per request
+        in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.truthsocial.profile(handle="realDonaldTrump")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "truthsocial.profile", dict(input), options
+        )
+        return RunResult[TruthsocialProfileData].model_validate(raw)
+
+    def user_posts(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TruthsocialUserPostsInput],
+    ) -> RunResult[TruthsocialUserPostsData]:
+        """Truth Social User Posts
+
+        List a Truth Social account's recent posts by handle - text, engagement
+        (likes, comments, shares), and timestamps as clean JSON, billed per request
+        in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.truthsocial.user_posts(handle="realDonaldTrump")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "truthsocial.user_posts", dict(input), options
+        )
+        return RunResult[TruthsocialUserPostsData].model_validate(raw)
+
+
+class AsyncTruthsocialNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def post(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TruthsocialPostInput],
+    ) -> RunResult[TruthsocialPostData]:
+        """Truth Social Post
+
+        Get a single Truth Social post by its URL - text, author, engagement (likes,
+        comments, shares), and timestamp as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.truthsocial.post(url="https://truthsocial.com/@realDonaldTrump/posts/116824551176646175")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "truthsocial.post", dict(input), options
+        )
+        return RunResult[TruthsocialPostData].model_validate(raw)
+
+    async def profile(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TruthsocialProfileInput],
+    ) -> RunResult[TruthsocialProfileData]:
+        """Truth Social Profile
+
+        Get a Truth Social account's public profile by handle - display name, bio,
+        follower/following counts, and post count as clean JSON, billed per request
+        in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.truthsocial.profile(handle="realDonaldTrump")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "truthsocial.profile", dict(input), options
+        )
+        return RunResult[TruthsocialProfileData].model_validate(raw)
+
+    async def user_posts(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TruthsocialUserPostsInput],
+    ) -> RunResult[TruthsocialUserPostsData]:
+        """Truth Social User Posts
+
+        List a Truth Social account's recent posts by handle - text, engagement
+        (likes, comments, shares), and timestamps as clean JSON, billed per request
+        in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.truthsocial.user_posts(handle="realDonaldTrump")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "truthsocial.user_posts", dict(input), options
+        )
+        return RunResult[TruthsocialUserPostsData].model_validate(raw)