getanyapi 0.1.0__py3-none-any.whl

getanyapi/platforms/google_finance.py

@@ -0,0 +1,170 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the google_finance 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 GoogleFinanceQuoteInput(TypedDict, total=False):
+    """Input for Google Finance Quote."""
+
+    symbol: Required[str]
+    """The symbol to quote. US stocks use a plain ticker (e.g. AAPL, TSLA); non-US stocks add a market suffix (e.g. VOW3.DE, BABA.HK, BARC.L); indices use a caret (e.g. ^GSPC, ^DJI); crypto and currencies use pair form (e.g. BTC-USD, EURUSD=X); mutual funds and futures use their symbol (e.g. VFIAX, ES=F). Common alternate forms are accepted and normalized (e.g. AAPL:NASDAQ, .DJI, BTC/USD). Exact symbols only, not a company-name search."""
+
+
+class GoogleFinanceQuoteData(BaseModel):
+    items: list[GoogleFinanceQuoteItem] = Field(
+        description="The quote for the requested symbol: name, current price, day change (absolute and percent), quote currency, exchange and market state, plus intraday and reference figures. Up to one element (empty when the symbol did not resolve)."
+    )
+
+
+class GoogleFinanceQuoteItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    ask: float | None = Field(default=None, description="Current ask price.")
+    asset_type: str | None = Field(
+        default=None,
+        alias="assetType",
+        description="Instrument class (e.g. EQUITY, ETF, CRYPTOCURRENCY, CURRENCY, INDEX, MUTUALFUND, FUTURE).",
+    )
+    average_volume: float | None = Field(
+        default=None, alias="averageVolume", description="Average daily trading volume."
+    )
+    bid: float | None = Field(default=None, description="Current bid price.")
+    change: float | None = Field(
+        default=None,
+        description="Absolute price change on the day, in the quote currency.",
+    )
+    change_percent: float | None = Field(
+        default=None,
+        alias="changePercent",
+        description="Percent price change on the day.",
+    )
+    currency: str | None = Field(
+        default=None,
+        description="ISO currency the quote is priced in (e.g. USD). Present whenever the upstream returns this record.",
+    )
+    day_high: float | None = Field(
+        default=None,
+        alias="dayHigh",
+        description="Highest price so far in the current session.",
+    )
+    day_low: float | None = Field(
+        default=None,
+        alias="dayLow",
+        description="Lowest price so far in the current session.",
+    )
+    exchange: str | None = Field(
+        default=None,
+        description="Exchange the instrument trades on (e.g. NasdaqGS). Present whenever the upstream returns this record.",
+    )
+    fifty_two_week_high: float | None = Field(
+        default=None,
+        alias="fiftyTwoWeekHigh",
+        description="Highest price over the trailing 52 weeks.",
+    )
+    fifty_two_week_low: float | None = Field(
+        default=None,
+        alias="fiftyTwoWeekLow",
+        description="Lowest price over the trailing 52 weeks.",
+    )
+    market_cap: float | None = Field(
+        default=None,
+        alias="marketCap",
+        description="Market capitalization in the quote currency.",
+    )
+    market_state: str | None = Field(
+        default=None,
+        alias="marketState",
+        description="Current market state (e.g. REGULAR, PRE, POST, CLOSED).",
+    )
+    name: str | None = Field(
+        default=None,
+        description="Instrument or company name. Present whenever the upstream returns this record.",
+    )
+    open: float | None = Field(
+        default=None, description="Opening price for the current session."
+    )
+    previous_close: float | None = Field(
+        default=None, alias="previousClose", description="Previous session close price."
+    )
+    price: float = Field(description="Current price in the quote currency.")
+    symbol: str = Field(description="Resolved ticker symbol for the quote.")
+    timestamp: str | None = Field(
+        default=None, description="Timestamp of the quote (ISO 8601)."
+    )
+    volume: float | None = Field(
+        default=None, description="Traded volume for the current session."
+    )
+
+
+class GoogleFinanceNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def quote(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleFinanceQuoteInput],
+    ) -> RunResult[GoogleFinanceQuoteData]:
+        """Google Finance Quote
+
+        Fetch a live quote for any stock, index, ETF, mutual fund, currency pair, or
+        crypto symbol: name, current price, the absolute and percent change on the
+        day, quote currency, exchange and market state, plus intraday and reference
+        figures (open, day high/low, previous close, volume, market cap, and the
+        52-week range) with transparent per-request USD pricing.
+
+        Price: $0.0005 per request plus $0.0015 per result.
+
+        Example:
+            res = client.google_finance.quote(symbol="AAPL:NASDAQ")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_finance.quote", dict(input), options
+        )
+        return RunResult[GoogleFinanceQuoteData].model_validate(raw)
+
+
+class AsyncGoogleFinanceNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def quote(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[GoogleFinanceQuoteInput],
+    ) -> RunResult[GoogleFinanceQuoteData]:
+        """Google Finance Quote
+
+        Fetch a live quote for any stock, index, ETF, mutual fund, currency pair, or
+        crypto symbol: name, current price, the absolute and percent change on the
+        day, quote currency, exchange and market state, plus intraday and reference
+        figures (open, day high/low, previous close, volume, market cap, and the
+        52-week range) with transparent per-request USD pricing.
+
+        Price: $0.0005 per request plus $0.0015 per result.
+
+        Example:
+            res = client.google_finance.quote(symbol="AAPL:NASDAQ")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_finance.quote", dict(input), options
+        )
+        return RunResult[GoogleFinanceQuoteData].model_validate(raw)

getanyapi/platforms/google_shopping.py

@@ -0,0 +1,103 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the google_shopping 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 GoogleShoppingSearchInput(TypedDict, total=False):
+    """Input for Google Shopping Search."""
+
+    country: NotRequired[str]
+    """ISO 3166-1 alpha-2 country code for localized results (e.g. "us", "gb", "de"). Default: us."""
+    language: NotRequired[str]
+    """ISO 639-1 language code for results (e.g. "en", "es", "fr"). Default: en."""
+    limit: NotRequired[int]
+    """Maximum number of results to return (1-10, default 10). You are billed per result returned, so a lower limit costs less. Range: 1 to 10."""
+    query: Required[str]
+    """Product name, brand, or keywords to search for (e.g. "Nike running shoes")."""
+    sortBy: NotRequired[
+        Literal["BEST_MATCH", "LOWEST_PRICE", "HIGHEST_PRICE", "TOP_RATED"]
+    ]
+    """Sort order for results (e.g. "LOWEST_PRICE"); defaults to relevance."""
+
+
+class GoogleShoppingSearchData(BaseModel):
+    items: list[GoogleShoppingSearchItem] = Field(
+        description="Matching product offers: title, price, store name, rating, shipping info, and product link."
+    )
+
+
+class GoogleShoppingSearchItem(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    title: str
+    url: str
+
+
+class GoogleShoppingNamespace:
+    """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[GoogleShoppingSearchInput],
+    ) -> RunResult[GoogleShoppingSearchData]:
+        """Google Shopping Search
+
+        Search Google Shopping by keyword and get up to 10 product offers - title,
+        price, store, rating, and link - localized by country and language, at a
+        flat per-request USD price.
+
+        Price: $0.01625 per request.
+
+        Example:
+            res = client.google_shopping.search(limit=10, query="airpods")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_shopping.search", dict(input), options
+        )
+        return RunResult[GoogleShoppingSearchData].model_validate(raw)
+
+
+class AsyncGoogleShoppingNamespace:
+    """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[GoogleShoppingSearchInput],
+    ) -> RunResult[GoogleShoppingSearchData]:
+        """Google Shopping Search
+
+        Search Google Shopping by keyword and get up to 10 product offers - title,
+        price, store, rating, and link - localized by country and language, at a
+        flat per-request USD price.
+
+        Price: $0.01625 per request.
+
+        Example:
+            res = client.google_shopping.search(limit=10, query="airpods")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "google_shopping.search", dict(input), options
+        )
+        return RunResult[GoogleShoppingSearchData].model_validate(raw)

getanyapi/platforms/hackernews.py

@@ -0,0 +1,276 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the hackernews 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 HackernewsProfileInput(TypedDict, total=False):
+    """Input for Hacker News Profile."""
+
+    handle: Required[str]
+    """Hacker News username, e.g. "pg"."""
+
+
+class HackernewsSearchInput(TypedDict, total=False):
+    """Input for Hacker News Search."""
+
+    query: Required[str]
+    """Search keyword, e.g. "ai"."""
+    tags: NotRequired[str]
+    """Optional result filter, e.g. "story" or "comment"."""
+
+
+class HackernewsStoryInput(TypedDict, total=False):
+    """Input for Hacker News Story."""
+
+    id: Required[str]
+    """Hacker News story id, e.g. "47340079"."""
+
+
+class HackernewsStoryCommentsInput(TypedDict, total=False):
+    """Input for Hacker News Story Comments."""
+
+    id: Required[str]
+    """Hacker News story id, e.g. "47340079"."""
+
+
+class HackernewsProfileData(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    bio: str
+    karma: int
+    username: str
+
+
+class HackernewsSearchData(BaseModel):
+    results: list[HackernewsSearchResult]
+
+
+class HackernewsSearchResult(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    author: str
+    comments: int
+    id: str
+    points: int
+    published_at: str = Field(alias="publishedAt")
+    title: str
+    url: str
+
+
+class HackernewsStoryData(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    author: str
+    comments: int
+    points: int
+    published_at: str = Field(alias="publishedAt")
+    title: str
+    url: str
+
+
+class HackernewsStoryCommentsData(BaseModel):
+    comments: list[HackernewsStoryCommentsComment]
+
+
+class HackernewsStoryCommentsComment(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    author: str
+    id: str
+    parent_id: str = Field(alias="parentId")
+    published_at: str = Field(alias="publishedAt")
+    text: str
+
+
+class HackernewsNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def profile(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[HackernewsProfileInput],
+    ) -> RunResult[HackernewsProfileData]:
+        """Hacker News Profile
+
+        Get a Hacker News user's public profile by username - karma, bio, and
+        account details as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.hackernews.profile(handle="pg")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "hackernews.profile", dict(input), options
+        )
+        return RunResult[HackernewsProfileData].model_validate(raw)
+
+    def search(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[HackernewsSearchInput],
+    ) -> RunResult[HackernewsSearchData]:
+        """Hacker News Search
+
+        Search Hacker News by keyword - matching stories with title, link, author,
+        points, and comment count as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.hackernews.search(query="ai")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "hackernews.search", dict(input), options
+        )
+        return RunResult[HackernewsSearchData].model_validate(raw)
+
+    def story(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[HackernewsStoryInput],
+    ) -> RunResult[HackernewsStoryData]:
+        """Hacker News Story
+
+        Get a Hacker News story by id - title, link, author, points, and comment
+        count as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.hackernews.story(id="47340079")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "hackernews.story", dict(input), options
+        )
+        return RunResult[HackernewsStoryData].model_validate(raw)
+
+    def story_comments(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[HackernewsStoryCommentsInput],
+    ) -> RunResult[HackernewsStoryCommentsData]:
+        """Hacker News Story Comments
+
+        List the comments on a Hacker News story by id - text, author, and timestamp
+        as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.hackernews.story_comments(id="47340079")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "hackernews.story_comments", dict(input), options
+        )
+        return RunResult[HackernewsStoryCommentsData].model_validate(raw)
+
+
+class AsyncHackernewsNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def profile(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[HackernewsProfileInput],
+    ) -> RunResult[HackernewsProfileData]:
+        """Hacker News Profile
+
+        Get a Hacker News user's public profile by username - karma, bio, and
+        account details as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.hackernews.profile(handle="pg")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "hackernews.profile", dict(input), options
+        )
+        return RunResult[HackernewsProfileData].model_validate(raw)
+
+    async def search(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[HackernewsSearchInput],
+    ) -> RunResult[HackernewsSearchData]:
+        """Hacker News Search
+
+        Search Hacker News by keyword - matching stories with title, link, author,
+        points, and comment count as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.hackernews.search(query="ai")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "hackernews.search", dict(input), options
+        )
+        return RunResult[HackernewsSearchData].model_validate(raw)
+
+    async def story(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[HackernewsStoryInput],
+    ) -> RunResult[HackernewsStoryData]:
+        """Hacker News Story
+
+        Get a Hacker News story by id - title, link, author, points, and comment
+        count as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.hackernews.story(id="47340079")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "hackernews.story", dict(input), options
+        )
+        return RunResult[HackernewsStoryData].model_validate(raw)
+
+    async def story_comments(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[HackernewsStoryCommentsInput],
+    ) -> RunResult[HackernewsStoryCommentsData]:
+        """Hacker News Story Comments
+
+        List the comments on a Hacker News story by id - text, author, and timestamp
+        as clean JSON, billed per request in USD.
+
+        Price: $0.00325 per request.
+
+        Example:
+            res = client.hackernews.story_comments(id="47340079")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "hackernews.story_comments", dict(input), options
+        )
+        return RunResult[HackernewsStoryCommentsData].model_validate(raw)

getanyapi/platforms/indeed.py

@@ -0,0 +1,114 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the indeed 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 IndeedJobsInput(TypedDict, total=False):
+    """Input for Indeed Jobs."""
+
+    country: NotRequired[str]
+    """Two-letter country site code (e.g. us, uk, de). Default: us."""
+    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."""
+    location: NotRequired[str]
+    """City, state, zip, or 'remote'."""
+    query: Required[str]
+    """Job search keywords (e.g. software engineer)."""
+
+
+class IndeedJobsData(BaseModel):
+    items: list[IndeedJobsItem] = Field(
+        description="Job listing records: title, employer, location, salary when available, job type, posting date, and description."
+    )
+
+
+class IndeedJobsItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    city: str | None = None
+    company: str | None = Field(
+        default=None, description="Present whenever the upstream returns this record."
+    )
+    country: str | None = None
+    date_published: str | None = Field(
+        default=None, alias="datePublished", description="ISO 8601 publish date."
+    )
+    description: str | None = Field(
+        default=None, description="Plain-text job description."
+    )
+    expired: bool | None = None
+    job_id: str = Field(alias="jobId", description="Indeed job key.")
+    postal_code: str | None = Field(default=None, alias="postalCode")
+    salary_currency: str | None = Field(default=None, alias="salaryCurrency")
+    salary_max: float | None = Field(default=None, alias="salaryMax")
+    salary_min: float | None = Field(default=None, alias="salaryMin")
+    salary_unit: str | None = Field(
+        default=None,
+        alias="salaryUnit",
+        description="Salary period, e.g. YEAR or HOUR.",
+    )
+    state: str | None = None
+    title: str
+    url: str = Field(description="Indeed job posting URL.")
+
+
+class IndeedNamespace:
+    """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[IndeedJobsInput]
+    ) -> RunResult[IndeedJobsData]:
+        """Indeed Jobs
+
+        Search Indeed job listings by keyword, location, and country - up to 20
+        normalized job records per request at a flat USD price.
+
+        Price: $0.0008 per request plus $0.00008 per result.
+
+        Example:
+            res = client.indeed.jobs(limit=3, location="Austin, TX", query="data analyst")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "indeed.jobs", dict(input), options
+        )
+        return RunResult[IndeedJobsData].model_validate(raw)
+
+
+class AsyncIndeedNamespace:
+    """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[IndeedJobsInput]
+    ) -> RunResult[IndeedJobsData]:
+        """Indeed Jobs
+
+        Search Indeed job listings by keyword, location, and country - up to 20
+        normalized job records per request at a flat USD price.
+
+        Price: $0.0008 per request plus $0.00008 per result.
+
+        Example:
+            res = client.indeed.jobs(limit=3, location="Austin, TX", query="data analyst")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "indeed.jobs", dict(input), options
+        )
+        return RunResult[IndeedJobsData].model_validate(raw)