getanyapi 0.1.0__py3-none-any.whl

getanyapi/platforms/glassdoor.py

@@ -0,0 +1,93 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the glassdoor 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 GlassdoorJobsInput(TypedDict, total=False):
+    """Input for Glassdoor Jobs."""
+
+    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."""
+    url: Required[str]
+    """A Glassdoor company or job search page URL (e.g. https://www.glassdoor.com/Jobs/Google-Jobs-E9079.htm)."""
+
+
+class GlassdoorJobsData(BaseModel):
+    items: list[GlassdoorJobsItem] = Field(
+        description="Job listing records: title, employer, location, salary estimate, rating, and posting details."
+    )
+
+
+class GlassdoorJobsItem(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    title: str
+    url: str
+
+
+class GlassdoorNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def jobs(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GlassdoorJobsInput],
+    ) -> RunResult[GlassdoorJobsData]:
+        """Glassdoor Jobs
+
+        Fetch job listings from any Glassdoor company or job search page URL - up to
+        20 normalized job records per request at a flat USD price.
+
+        Price: $0.005 per request plus $0.00475 per result.
+
+        Example:
+            res = client.glassdoor.jobs(limit=3, url="https://www.glassdoor.com/Job/software-engineer-jobs-SRCH_KO0,17.htm")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "glassdoor.jobs", dict(input), options
+        )
+        return RunResult[GlassdoorJobsData].model_validate(raw)
+
+
+class AsyncGlassdoorNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def jobs(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GlassdoorJobsInput],
+    ) -> RunResult[GlassdoorJobsData]:
+        """Glassdoor Jobs
+
+        Fetch job listings from any Glassdoor company or job search page URL - up to
+        20 normalized job records per request at a flat USD price.
+
+        Price: $0.005 per request plus $0.00475 per result.
+
+        Example:
+            res = client.glassdoor.jobs(limit=3, url="https://www.glassdoor.com/Job/software-engineer-jobs-SRCH_KO0,17.htm")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "glassdoor.jobs", dict(input), options
+        )
+        return RunResult[GlassdoorJobsData].model_validate(raw)

getanyapi/platforms/google.py

@@ -0,0 +1,232 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the google 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 GoogleImagesInput(TypedDict, total=False):
+    """Input for Google Images."""
+
+    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]
+    """Image search query (e.g. golden gate bridge at sunset)."""
+
+
+class GoogleNewsInput(TypedDict, total=False):
+    """Input for Google News."""
+
+    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]
+    """News search query; supports operators like '-', 'OR', and 'site:' (e.g. bitcoin site:cnn.com)."""
+    region: NotRequired[str]
+    """Region and language for the search as COUNTRY:lang (e.g. US:en). Default: US:en."""
+    timeframe: NotRequired[str]
+    """Time window for results: 1h, 1d, 7d, 1y, or all (e.g. 1d). Default: 7d."""
+
+
+class GoogleSearchInput(TypedDict, total=False):
+    """Input for Google Search."""
+
+    gl: NotRequired[str]
+    """Two-letter country code for result localization (e.g. us, gb, de). Default: us."""
+    query: Required[str]
+    """The Google search query."""
+
+
+class GoogleImagesData(BaseModel):
+    items: list[GoogleImagesItem] = Field(
+        description="Image result records: image URL, dimensions, title, and the source page it appears on."
+    )
+
+
+class GoogleImagesItem(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    title: str
+    url: str
+
+
+class GoogleNewsData(BaseModel):
+    items: list[GoogleNewsItem] = Field(
+        description="Article records: headline, source name, article link, and publish time."
+    )
+
+
+class GoogleNewsItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    published_at: str | None = Field(
+        default=None,
+        alias="publishedAt",
+        description="Publish time. Present whenever the upstream returns this record.",
+    )
+    snippet: str | None = Field(
+        default=None, description="Article snippet when available."
+    )
+    source: str | None = Field(
+        default=None,
+        description="Publisher name. Present whenever the upstream returns this record.",
+    )
+    title: str
+    url: str = Field(description="Article link.")
+
+
+class GoogleSearchData(BaseModel):
+    query: str
+    results: list[GoogleSearchResult]
+
+
+class GoogleSearchResult(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    link: str
+    position: int
+    snippet: str
+    title: str
+
+
+class GoogleNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def images(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleImagesInput],
+    ) -> RunResult[GoogleImagesData]:
+        """Google Images
+
+        Run a Google Images search and get structured results - image URLs,
+        dimensions, titles, and source pages - with flat per-request USD pricing.
+
+        Price: $0.00005 per request plus $0.0024 per result.
+
+        Example:
+            res = client.google.images(limit=5, query="golden retriever")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "google.images", dict(input), options
+        )
+        return RunResult[GoogleImagesData].model_validate(raw)
+
+    def news(
+        self, *, options: RequestOptions | None = None, **input: Unpack[GoogleNewsInput]
+    ) -> RunResult[GoogleNewsData]:
+        """Google News
+
+        Search Google News by keyword and get fresh articles - headlines, sources,
+        links, and publish times - as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.google.news(limit=5, query="openai")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "google.news", dict(input), options
+        )
+        return RunResult[GoogleNewsData].model_validate(raw)
+
+    def search(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleSearchInput],
+    ) -> RunResult[GoogleSearchData]:
+        """Google Search
+
+        Run a Google web search and get the organic results (title, link, snippet,
+        position) as clean JSON. One call, billed per request in real dollars.
+
+        Price: $0.00099 per request.
+
+        Example:
+            res = client.google.search(query="best coffee maker")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "google.search", dict(input), options
+        )
+        return RunResult[GoogleSearchData].model_validate(raw)
+
+
+class AsyncGoogleNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def images(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleImagesInput],
+    ) -> RunResult[GoogleImagesData]:
+        """Google Images
+
+        Run a Google Images search and get structured results - image URLs,
+        dimensions, titles, and source pages - with flat per-request USD pricing.
+
+        Price: $0.00005 per request plus $0.0024 per result.
+
+        Example:
+            res = client.google.images(limit=5, query="golden retriever")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "google.images", dict(input), options
+        )
+        return RunResult[GoogleImagesData].model_validate(raw)
+
+    async def news(
+        self, *, options: RequestOptions | None = None, **input: Unpack[GoogleNewsInput]
+    ) -> RunResult[GoogleNewsData]:
+        """Google News
+
+        Search Google News by keyword and get fresh articles - headlines, sources,
+        links, and publish times - as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.google.news(limit=5, query="openai")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "google.news", dict(input), options
+        )
+        return RunResult[GoogleNewsData].model_validate(raw)
+
+    async def search(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleSearchInput],
+    ) -> RunResult[GoogleSearchData]:
+        """Google Search
+
+        Run a Google web search and get the organic results (title, link, snippet,
+        position) as clean JSON. One call, billed per request in real dollars.
+
+        Price: $0.00099 per request.
+
+        Example:
+            res = client.google.search(query="best coffee maker")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "google.search", dict(input), options
+        )
+        return RunResult[GoogleSearchData].model_validate(raw)

getanyapi/platforms/google_ads.py

@@ -0,0 +1,380 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the google_ads 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
+from .._pagination import (
+    AsyncPaginator,
+    Paginator,
+    apaginate,
+    paginate,
+)
+
+if TYPE_CHECKING:
+    from .._async_client import AsyncAnyAPI
+    from .._client import AnyAPI
+
+
+class GoogleAdsAdDetailsInput(TypedDict, total=False):
+    """Input for Google Ads Ad Details."""
+
+    url: Required[str]
+    """Google Ads Transparency Center creative URL (e.g. "https://adstransparency.google.com/advertiser/AR.../creative/CR...")."""
+
+
+class GoogleAdsAdvertiserSearchInput(TypedDict, total=False):
+    """Input for Google Ads Advertiser Search."""
+
+    query: Required[str]
+    """Advertiser name or keyword to search for (e.g. "lululemon")."""
+    region: NotRequired[str]
+    """Two-letter country code to scope results (e.g. "AU", "CA"). Defaults to US."""
+
+
+class GoogleAdsCompanyAdsInput(TypedDict, total=False):
+    """Input for Google Ads Company Ads."""
+
+    advertiserId: NotRequired[str]
+    """Advertiser ID. Provide either domain or advertiserId."""
+    cursor: NotRequired[str]
+    """Opaque pagination cursor from a previous response's nextCursor."""
+    domain: NotRequired[str]
+    """Company domain (e.g. "lululemon.com"). Provide either domain or advertiserId."""
+    format: NotRequired[Literal["text", "image", "video"]]
+    """Ad format filter."""
+    platform: NotRequired[
+        Literal[
+            "google_maps", "google_play", "google_search", "google_shopping", "youtube"
+        ]
+    ]
+    """Platform filter."""
+    region: NotRequired[str]
+    """Two-letter country code to scope results (e.g. "US", "AU")."""
+    topic: NotRequired[Literal["all", "political"]]
+    """Search topic. "political" requires a region."""
+
+
+class GoogleAdsSearchInput(TypedDict, total=False):
+    """Input for Google Ads Transparency."""
+
+    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."""
+    url: Required[str]
+    """A Google Ads Transparency Center URL for a selected advertiser or domain (e.g. https://adstransparency.google.com/advertiser/AR01614014350098432001?region=US)."""
+
+
+class GoogleAdsAdDetailsData(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    advertiser_id: str = Field(alias="advertiserId")
+    creative_id: str = Field(alias="creativeId")
+    first_shown: str = Field(alias="firstShown", description="ISO 8601 date.")
+    format: str
+    impressions_max: int = Field(alias="impressionsMax")
+    impressions_min: int = Field(alias="impressionsMin")
+    last_shown: str = Field(alias="lastShown", description="ISO 8601 date.")
+    variations: list[GoogleAdsAdDetailsVariation]
+
+
+class GoogleAdsAdDetailsVariation(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    all_text: str = Field(alias="allText")
+    description: str
+    destination_url: str = Field(alias="destinationUrl")
+    headline: str
+    image_url: str = Field(alias="imageUrl")
+
+
+class GoogleAdsAdvertiserSearchData(BaseModel):
+    advertisers: list[GoogleAdsAdvertiserSearchAdvertiser]
+
+
+class GoogleAdsAdvertiserSearchAdvertiser(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    ads_estimate: int = Field(
+        alias="adsEstimate",
+        description="Estimated number of ads for this advertiser/region.",
+    )
+    advertiser_id: str = Field(alias="advertiserId")
+    name: str
+    region: str
+
+
+class GoogleAdsCompanyAdsData(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    ads: list[GoogleAdsCompanyAdsAd]
+    ads_estimate: int = Field(
+        alias="adsEstimate", description="Estimated total number of ads."
+    )
+    next_cursor: str = Field(alias="nextCursor")
+
+
+class GoogleAdsCompanyAdsAd(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    ad_url: str = Field(alias="adUrl")
+    advertiser_id: str = Field(alias="advertiserId")
+    advertiser_name: str = Field(alias="advertiserName")
+    creative_id: str = Field(alias="creativeId")
+    first_shown: str = Field(alias="firstShown", description="ISO 8601 date.")
+    format: str
+    image_url: str = Field(alias="imageUrl")
+    last_shown: str = Field(alias="lastShown", description="ISO 8601 date.")
+
+
+class GoogleAdsSearchData(BaseModel):
+    items: list[GoogleAdsSearchItem] = Field(
+        description="Ad records from the Transparency Center: advertiser, ad format, creative details, preview URL, and first/last shown dates."
+    )
+
+
+class GoogleAdsSearchItem(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    id: str
+    url: str
+
+
+class GoogleAdsNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def ad_details(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleAdsAdDetailsInput],
+    ) -> RunResult[GoogleAdsAdDetailsData]:
+        """Google Ads Ad Details
+
+        Look up a single Google Ads Transparency Center creative by URL and get its
+        format, run dates, impression range, regions, and creative variations as
+        clean JSON, billed per request in USD.
+
+        Price: $0.002 per request.
+
+        Example:
+            res = client.google_ads.ad_details(url="https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_ads.ad_details", dict(input), options
+        )
+        return RunResult[GoogleAdsAdDetailsData].model_validate(raw)
+
+    def advertiser_search(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleAdsAdvertiserSearchInput],
+    ) -> RunResult[GoogleAdsAdvertiserSearchData]:
+        """Google Ads Advertiser Search
+
+        Search the Google Ads Transparency Center for advertisers by keyword and get
+        matching advertiser IDs, regions, and estimated ad counts as clean JSON,
+        billed per request in USD.
+
+        Price: $0.002 per request.
+
+        Example:
+            res = client.google_ads.advertiser_search(query="lululemon")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_ads.advertiser_search", dict(input), options
+        )
+        return RunResult[GoogleAdsAdvertiserSearchData].model_validate(raw)
+
+    def company_ads(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleAdsCompanyAdsInput],
+    ) -> RunResult[GoogleAdsCompanyAdsData]:
+        """Google Ads Company Ads
+
+        List the ads a company is running from the Google Ads Transparency Center by
+        domain or advertiser ID - creative ID, format, ad URL, and first/last shown
+        dates - with cursor pagination, billed per request in USD.
+
+        Price: $0.002 per request.
+
+        Example:
+            res = client.google_ads.company_ads(domain="lululemon.com")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_ads.company_ads", dict(input), options
+        )
+        return RunResult[GoogleAdsCompanyAdsData].model_validate(raw)
+
+    def iter_company_ads(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleAdsCompanyAdsInput],
+    ) -> Paginator[GoogleAdsCompanyAdsAd, GoogleAdsCompanyAdsData]:
+        """Iterate Google Ads Company Ads results, following pagination cursors.
+
+        Yields validated `GoogleAdsCompanyAdsAd` items from the `ads` field of
+        each page. Use `.pages()` on the returned paginator to walk whole
+        `RunResult` pages.
+        """
+        return paginate(
+            self._client,
+            "google_ads.company_ads",
+            dict(input),
+            "ads",
+            item_model=GoogleAdsCompanyAdsAd,
+            data_model=GoogleAdsCompanyAdsData,
+            bare=False,
+            options=options,
+        )
+
+    def search(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleAdsSearchInput],
+    ) -> RunResult[GoogleAdsSearchData]:
+        """Google Ads Transparency
+
+        Pull the ads an advertiser is currently running from the Google Ads
+        Transparency Center - creative details, formats, and run dates - as clean
+        JSON, billed per request in USD.
+
+        Price: $0.00005 per request plus $0.0013 per result.
+
+        Example:
+            res = client.google_ads.search(limit=3, url="https://adstransparency.google.com/?region=US&domain=nike.com")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_ads.search", dict(input), options
+        )
+        return RunResult[GoogleAdsSearchData].model_validate(raw)
+
+
+class AsyncGoogleAdsNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def ad_details(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleAdsAdDetailsInput],
+    ) -> RunResult[GoogleAdsAdDetailsData]:
+        """Google Ads Ad Details
+
+        Look up a single Google Ads Transparency Center creative by URL and get its
+        format, run dates, impression range, regions, and creative variations as
+        clean JSON, billed per request in USD.
+
+        Price: $0.002 per request.
+
+        Example:
+            res = client.google_ads.ad_details(url="https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_ads.ad_details", dict(input), options
+        )
+        return RunResult[GoogleAdsAdDetailsData].model_validate(raw)
+
+    async def advertiser_search(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleAdsAdvertiserSearchInput],
+    ) -> RunResult[GoogleAdsAdvertiserSearchData]:
+        """Google Ads Advertiser Search
+
+        Search the Google Ads Transparency Center for advertisers by keyword and get
+        matching advertiser IDs, regions, and estimated ad counts as clean JSON,
+        billed per request in USD.
+
+        Price: $0.002 per request.
+
+        Example:
+            res = client.google_ads.advertiser_search(query="lululemon")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_ads.advertiser_search", dict(input), options
+        )
+        return RunResult[GoogleAdsAdvertiserSearchData].model_validate(raw)
+
+    async def company_ads(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleAdsCompanyAdsInput],
+    ) -> RunResult[GoogleAdsCompanyAdsData]:
+        """Google Ads Company Ads
+
+        List the ads a company is running from the Google Ads Transparency Center by
+        domain or advertiser ID - creative ID, format, ad URL, and first/last shown
+        dates - with cursor pagination, billed per request in USD.
+
+        Price: $0.002 per request.
+
+        Example:
+            res = client.google_ads.company_ads(domain="lululemon.com")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_ads.company_ads", dict(input), options
+        )
+        return RunResult[GoogleAdsCompanyAdsData].model_validate(raw)
+
+    def iter_company_ads(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleAdsCompanyAdsInput],
+    ) -> AsyncPaginator[GoogleAdsCompanyAdsAd, GoogleAdsCompanyAdsData]:
+        """Iterate Google Ads Company Ads results, following pagination cursors.
+
+        Yields validated `GoogleAdsCompanyAdsAd` items from the `ads` field of
+        each page. Use `.pages()` on the returned paginator to walk whole
+        `RunResult` pages.
+        """
+        return apaginate(
+            self._client,
+            "google_ads.company_ads",
+            dict(input),
+            "ads",
+            item_model=GoogleAdsCompanyAdsAd,
+            data_model=GoogleAdsCompanyAdsData,
+            bare=False,
+            options=options,
+        )
+
+    async def search(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleAdsSearchInput],
+    ) -> RunResult[GoogleAdsSearchData]:
+        """Google Ads Transparency
+
+        Pull the ads an advertiser is currently running from the Google Ads
+        Transparency Center - creative details, formats, and run dates - as clean
+        JSON, billed per request in USD.
+
+        Price: $0.00005 per request plus $0.0013 per result.
+
+        Example:
+            res = client.google_ads.search(limit=3, url="https://adstransparency.google.com/?region=US&domain=nike.com")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_ads.search", dict(input), options
+        )
+        return RunResult[GoogleAdsSearchData].model_validate(raw)