getanyapi 0.1.0__py3-none-any.whl

getanyapi/platforms/maps.py

@@ -0,0 +1,412 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the maps 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 MapsContactsInput(TypedDict, total=False):
+    """Input for Google Maps Contacts."""
+
+    language: NotRequired[str]
+    """Two-letter language code for the results (e.g. en). Default: en."""
+    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: Required[str]
+    """Free-text location to search in, ideally city plus country (e.g. Denver, USA)."""
+    query: Required[str]
+    """What you would type in the Google Maps search bar (e.g. dentist)."""
+
+
+class MapsPlaceInput(TypedDict, total=False):
+    """Input for Google Maps Place Lookup."""
+
+    language: NotRequired[str]
+    """Two-letter language code for the result details (e.g. en). Default: en."""
+    location: NotRequired[str]
+    """Optional free-text location to scope the search, ideally city plus state or country (e.g. San Francisco, CA). Narrows the query to the best match in that area."""
+    query: Required[str]
+    """The business name or search text to look up, as you would type it into the Google Maps search bar (e.g. Blue Bottle Coffee)."""
+
+
+class MapsReviewsInput(TypedDict, total=False):
+    """Input for Google Maps Reviews."""
+
+    language: NotRequired[str]
+    """Two-letter language code for the review details (e.g. en). Default: en."""
+    limit: NotRequired[int]
+    """Maximum number of results to return (1-100, default 100). You are billed per result returned, so a lower limit costs less. Range: 1 to 100."""
+    placeId: Required[str]
+    """The Google Maps place ID to fetch reviews for (e.g. ChIJj61dQgK6j4AR4GeTYWZsKWw)."""
+    sort: NotRequired[
+        Literal["newest", "mostRelevant", "highestRanking", "lowestRanking"]
+    ]
+    """Order in which reviews are returned (e.g. newest). Default: newest."""
+
+
+class MapsSearchInput(TypedDict, total=False):
+    """Input for Google Maps Search."""
+
+    language: NotRequired[str]
+    """Two-letter language code for the results (e.g. en). Default: en."""
+    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: Required[str]
+    """Free-text location to search in, ideally city plus country (e.g. Austin, USA)."""
+    query: Required[str]
+    """What you would type in the Google Maps search bar (e.g. coffee shop)."""
+
+
+class MapsContactsData(BaseModel):
+    items: list[MapsContactsItem] = Field(
+        description="Business records: name, address, rating, plus enriched contact details such as emails, phone numbers, and social profiles."
+    )
+
+
+class MapsContactsItem(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    name: str
+    url: str
+
+
+class MapsPlaceData(BaseModel):
+    items: list[MapsPlaceItem] = Field(
+        description="The best-matching place for the query, with full details: name, address, contact info, category, rating, opening hours, and coordinates. Up to one element (empty when nothing matched)."
+    )
+
+
+class MapsPlaceItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    address: str | None = Field(
+        default=None,
+        description="Full formatted street address. Present whenever the upstream returns this record.",
+    )
+    category: str | None = Field(
+        default=None,
+        description="Primary Google Maps category (e.g. Coffee shop). Present whenever the upstream returns this record.",
+    )
+    city: str | None = None
+    country_code: str | None = Field(
+        default=None, alias="countryCode", description="Two-letter country code."
+    )
+    hours: list[MapsPlaceHour] | None = Field(
+        default=None,
+        description="Opening hours by day: each element is an object with the day name and its hours.",
+    )
+    image: str | None = Field(
+        default=None, description="URL of the primary place photo."
+    )
+    latitude: float | None = Field(
+        default=None, description="Present whenever the upstream returns this record."
+    )
+    longitude: float | None = Field(
+        default=None, description="Present whenever the upstream returns this record."
+    )
+    name: str = Field(description="Business or place name.")
+    neighborhood: str | None = None
+    permanently_closed: bool | None = Field(
+        default=None,
+        alias="permanentlyClosed",
+        description="Whether the place is permanently closed.",
+    )
+    phone: str | None = Field(default=None, description="Formatted phone number.")
+    place_id: str | None = Field(
+        default=None,
+        alias="placeId",
+        description="Google Maps place id. Present whenever the upstream returns this record.",
+    )
+    plus_code: str | None = Field(
+        default=None, alias="plusCode", description="Google Plus Code for the location."
+    )
+    postal_code: str | None = Field(default=None, alias="postalCode")
+    price_level: str | None = Field(
+        default=None,
+        alias="priceLevel",
+        description="Price level indicator (e.g. a price range).",
+    )
+    rating: float | None = Field(default=None, description="Average star rating.")
+    reviews_count: int | None = Field(
+        default=None, alias="reviewsCount", description="Total number of reviews."
+    )
+    state: str | None = Field(default=None, description="State or region name.")
+    street: str | None = Field(
+        default=None, description="Street portion of the address."
+    )
+    url: str = Field(description="Google Maps URL for the place.")
+    website: str | None = Field(default=None, description="Business website URL.")
+
+
+class MapsPlaceHour(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+
+class MapsReviewsData(BaseModel):
+    items: list[MapsReviewsItem] = Field(
+        description="Review records: reviewer, star rating, review text (empty when the reviewer left only a rating), publish date, likes, and owner response where present."
+    )
+
+
+class MapsReviewsItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    author: str | None = Field(
+        default=None,
+        description="Reviewer display name. Present whenever the upstream returns this record.",
+    )
+    is_local_guide: bool | None = Field(
+        default=None,
+        alias="isLocalGuide",
+        description="Whether the reviewer is a Google Local Guide.",
+    )
+    likes: int | None = Field(
+        default=None, description="Number of likes on the review."
+    )
+    origin: str | None = Field(
+        default=None, description="Source of the review (e.g. Google)."
+    )
+    owner_response: str | None = Field(
+        default=None,
+        alias="ownerResponse",
+        description="Owner's reply text; empty when there is none.",
+    )
+    owner_response_at: str | None = Field(
+        default=None,
+        alias="ownerResponseAt",
+        description="ISO 8601 timestamp of the owner's reply; empty when there is none.",
+    )
+    place_id: str | None = Field(
+        default=None,
+        alias="placeId",
+        description="Google Maps place id the review belongs to. Present whenever the upstream returns this record.",
+    )
+    published_ago: str | None = Field(
+        default=None,
+        alias="publishedAgo",
+        description="Human-relative publish time (e.g. '7 hours ago').",
+    )
+    published_at: str | None = Field(
+        default=None,
+        alias="publishedAt",
+        description="ISO 8601 timestamp the review was published. Present whenever the upstream returns this record.",
+    )
+    rating: float | None = Field(
+        default=None, description="Star rating the reviewer gave (1-5)."
+    )
+    review_id: str = Field(alias="reviewId", description="Stable Google review id.")
+    reviewer_id: str | None = Field(default=None, alias="reviewerId")
+    reviewer_reviews_count: int | None = Field(
+        default=None,
+        alias="reviewerReviewsCount",
+        description="Total number of reviews the reviewer has written.",
+    )
+    text: str | None = Field(
+        default=None,
+        description="Review text; empty string when the reviewer left only a star rating.",
+    )
+    url: str | None = Field(
+        default=None,
+        description="Direct URL to the review on Google Maps. Present whenever the upstream returns this record.",
+    )
+
+
+class MapsSearchData(BaseModel):
+    items: list[MapsSearchItem] = Field(
+        description="Place records: name, category, address, coordinates, rating, review count, and contact basics."
+    )
+
+
+class MapsSearchItem(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    name: str
+    url: str
+
+
+class MapsNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def contacts(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[MapsContactsInput],
+    ) -> RunResult[MapsContactsData]:
+        """Google Maps Contacts
+
+        Search Google Maps for businesses and enrich each result with contact
+        details - emails, phones, and social profiles from their websites - up to 20
+        records per request.
+
+        Price: $0.00005 per request plus $0.003 per result.
+
+        Example:
+            res = client.maps.contacts(limit=3, location="Austin, TX", query="coffee shop")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "maps.contacts", dict(input), options
+        )
+        return RunResult[MapsContactsData].model_validate(raw)
+
+    def place(
+        self, *, options: RequestOptions | None = None, **input: Unpack[MapsPlaceInput]
+    ) -> RunResult[MapsPlaceData]:
+        """Google Maps Place Lookup
+
+        Look up a place on Google Maps by name or search query (optionally scoped to
+        a location) and get the best-matching place with full details - address,
+        phone, website, rating, hours, and coordinates - as normalized JSON priced
+        per request in USD.
+
+        Price: $0.003 per request plus $0.005 per result.
+
+        Example:
+            res = client.maps.place(location="San Francisco, CA", query="Blue Bottle Coffee")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "maps.place", dict(input), options
+        )
+        return RunResult[MapsPlaceData].model_validate(raw)
+
+    def reviews(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[MapsReviewsInput],
+    ) -> RunResult[MapsReviewsData]:
+        """Google Maps Reviews
+
+        Fetch up to 100 Google Maps reviews for a place by place ID, sorted the way
+        you need, in one flat-priced normalized response.
+
+        Price: $0.00005 per request plus $0.0004 per result.
+
+        Example:
+            res = client.maps.reviews(limit=3, placeId="ChIJN1t_tDeuEmsRUsoyG83frY4")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "maps.reviews", dict(input), options
+        )
+        return RunResult[MapsReviewsData].model_validate(raw)
+
+    def search(
+        self, *, options: RequestOptions | None = None, **input: Unpack[MapsSearchInput]
+    ) -> RunResult[MapsSearchData]:
+        """Google Maps Search
+
+        Search Google Maps for places matching a query and location - up to 20
+        normalized place records with ratings, addresses, and contact basics per
+        request.
+
+        Price: $0.00005 per request plus $0.003 per result.
+
+        Example:
+            res = client.maps.search(limit=3, location="Austin, TX", query="coffee")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "maps.search", dict(input), options
+        )
+        return RunResult[MapsSearchData].model_validate(raw)
+
+
+class AsyncMapsNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def contacts(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[MapsContactsInput],
+    ) -> RunResult[MapsContactsData]:
+        """Google Maps Contacts
+
+        Search Google Maps for businesses and enrich each result with contact
+        details - emails, phones, and social profiles from their websites - up to 20
+        records per request.
+
+        Price: $0.00005 per request plus $0.003 per result.
+
+        Example:
+            res = client.maps.contacts(limit=3, location="Austin, TX", query="coffee shop")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "maps.contacts", dict(input), options
+        )
+        return RunResult[MapsContactsData].model_validate(raw)
+
+    async def place(
+        self, *, options: RequestOptions | None = None, **input: Unpack[MapsPlaceInput]
+    ) -> RunResult[MapsPlaceData]:
+        """Google Maps Place Lookup
+
+        Look up a place on Google Maps by name or search query (optionally scoped to
+        a location) and get the best-matching place with full details - address,
+        phone, website, rating, hours, and coordinates - as normalized JSON priced
+        per request in USD.
+
+        Price: $0.003 per request plus $0.005 per result.
+
+        Example:
+            res = client.maps.place(location="San Francisco, CA", query="Blue Bottle Coffee")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "maps.place", dict(input), options
+        )
+        return RunResult[MapsPlaceData].model_validate(raw)
+
+    async def reviews(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[MapsReviewsInput],
+    ) -> RunResult[MapsReviewsData]:
+        """Google Maps Reviews
+
+        Fetch up to 100 Google Maps reviews for a place by place ID, sorted the way
+        you need, in one flat-priced normalized response.
+
+        Price: $0.00005 per request plus $0.0004 per result.
+
+        Example:
+            res = client.maps.reviews(limit=3, placeId="ChIJN1t_tDeuEmsRUsoyG83frY4")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "maps.reviews", dict(input), options
+        )
+        return RunResult[MapsReviewsData].model_validate(raw)
+
+    async def search(
+        self, *, options: RequestOptions | None = None, **input: Unpack[MapsSearchInput]
+    ) -> RunResult[MapsSearchData]:
+        """Google Maps Search
+
+        Search Google Maps for places matching a query and location - up to 20
+        normalized place records with ratings, addresses, and contact basics per
+        request.
+
+        Price: $0.00005 per request plus $0.003 per result.
+
+        Example:
+            res = client.maps.search(limit=3, location="Austin, TX", query="coffee")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "maps.search", dict(input), options
+        )
+        return RunResult[MapsSearchData].model_validate(raw)

getanyapi/platforms/pandaexpress.py

@@ -0,0 +1,262 @@
+# Generated - do not edit. Regenerate with: pnpm generate
+"""Generated namespace module for the pandaexpress 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 PandaexpressLocationsInput(TypedDict, total=False):
+    """Input for Panda Express Locations."""
+
+    latitude: Required[float]
+    """Latitude of the search center. Range: -90 to 90."""
+    limit: NotRequired[int]
+    """Maximum number of restaurants to return (1-50, default 10). Range: 1 to 50."""
+    longitude: Required[float]
+    """Longitude of the search center. Range: -180 to 180."""
+    radius: NotRequired[int]
+    """Search radius in miles (default 10). Range: 1 to 100."""
+
+
+class PandaexpressMenuInput(TypedDict, total=False):
+    """Input for Panda Express Menu."""
+
+    restaurantId: Required[str]
+    """Panda Express restaurant id (the `id` from Panda Express Locations)."""
+
+
+class PandaexpressNutritionInput(TypedDict, total=False):
+    """Input for Panda Express Nutrition."""
+
+    query: Required[str]
+    """Menu item name (or substring) to look up, e.g. "orange chicken" or "chow mein"."""
+
+
+class PandaexpressLocationsData(BaseModel):
+    restaurants: list[PandaexpressLocationsRestaurant] = Field(
+        description="Nearby Panda Express restaurants, nearest first."
+    )
+
+
+class PandaexpressLocationsRestaurant(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    address: str
+    can_deliver: bool = Field(alias="canDeliver")
+    can_pickup: bool = Field(alias="canPickup")
+    city: str
+    distance_miles: float = Field(alias="distanceMiles")
+    id: int
+    is_open: bool = Field(alias="isOpen")
+    latitude: float
+    longitude: float
+    name: str
+    phone: str
+    state: str
+    zip: str
+
+
+class PandaexpressMenuData(BaseModel):
+    categories: list[PandaexpressMenuCategorie] = Field(
+        description="Menu categories in display order."
+    )
+
+
+class PandaexpressMenuCategorie(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    items: list[PandaexpressMenuItem]
+    name: str
+
+
+class PandaexpressMenuItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    calories: int = Field(
+        description="Base calories when published by the restaurant, else 0."
+    )
+    description: str
+    name: str
+    price_usd: float = Field(
+        alias="priceUsd",
+        description="Item price in USD (0 for items priced only via size/option selection).",
+    )
+
+
+class PandaexpressNutritionData(BaseModel):
+    items: list[PandaexpressNutritionItem] = Field(
+        description="Matching menu items with official nutrition facts."
+    )
+
+
+class PandaexpressNutritionItem(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    calories: float
+    cholesterol_mg: float = Field(alias="cholesterolMg")
+    dietary_fiber_g: float = Field(alias="dietaryFiberG")
+    name: str
+    protein_g: float = Field(alias="proteinG")
+    saturated_fat_g: float = Field(alias="saturatedFatG")
+    serving_size_oz: float = Field(alias="servingSizeOz")
+    sodium_mg: float = Field(alias="sodiumMg")
+    sugars_g: float = Field(alias="sugarsG")
+    total_carb_g: float = Field(alias="totalCarbG")
+    total_fat_g: float = Field(alias="totalFatG")
+    trans_fat_g: float = Field(alias="transFatG")
+
+
+class PandaexpressNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AnyAPI") -> None:
+        self._client = client
+
+    def locations(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[PandaexpressLocationsInput],
+    ) -> RunResult[PandaexpressLocationsData]:
+        """Panda Express Locations
+
+        Find Panda Express restaurants near a latitude/longitude, sorted by
+        distance, with address, phone, hours availability, and pickup/delivery
+        support. One call, billed per request in real dollars.
+
+        Price: $0.0009 per request.
+
+        Example:
+            res = client.pandaexpress.locations(latitude=34.0522, limit=5, longitude=-118.2437)
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "pandaexpress.locations", dict(input), options
+        )
+        return RunResult[PandaexpressLocationsData].model_validate(raw)
+
+    def menu(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[PandaexpressMenuInput],
+    ) -> RunResult[PandaexpressMenuData]:
+        """Panda Express Menu
+
+        Get the live menu for a Panda Express restaurant by id: categories with item
+        names, descriptions, and USD prices. Pair with Panda Express Locations to
+        resolve a restaurant id. One call, billed per request in real dollars.
+
+        Price: $0.0009 per request.
+
+        Example:
+            res = client.pandaexpress.menu(restaurantId="112551")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "pandaexpress.menu", dict(input), options
+        )
+        return RunResult[PandaexpressMenuData].model_validate(raw)
+
+    def nutrition(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[PandaexpressNutritionInput],
+    ) -> RunResult[PandaexpressNutritionData]:
+        """Panda Express Nutrition
+
+        Look up official Panda Express nutrition facts by item name: serving size,
+        calories, fat, cholesterol, sodium, carbs, fiber, sugars, and protein. One
+        call, billed per request in real dollars.
+
+        Price: $0.006 per request.
+
+        Example:
+            res = client.pandaexpress.nutrition(query="orange chicken")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "pandaexpress.nutrition", dict(input), options
+        )
+        return RunResult[PandaexpressNutritionData].model_validate(raw)
+
+
+class AsyncPandaexpressNamespace:
+    """Typed methods for this platform. Attached lazily to the client."""
+
+    def __init__(self, client: "AsyncAnyAPI") -> None:
+        self._client = client
+
+    async def locations(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[PandaexpressLocationsInput],
+    ) -> RunResult[PandaexpressLocationsData]:
+        """Panda Express Locations
+
+        Find Panda Express restaurants near a latitude/longitude, sorted by
+        distance, with address, phone, hours availability, and pickup/delivery
+        support. One call, billed per request in real dollars.
+
+        Price: $0.0009 per request.
+
+        Example:
+            res = client.pandaexpress.locations(latitude=34.0522, limit=5, longitude=-118.2437)
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "pandaexpress.locations", dict(input), options
+        )
+        return RunResult[PandaexpressLocationsData].model_validate(raw)
+
+    async def menu(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[PandaexpressMenuInput],
+    ) -> RunResult[PandaexpressMenuData]:
+        """Panda Express Menu
+
+        Get the live menu for a Panda Express restaurant by id: categories with item
+        names, descriptions, and USD prices. Pair with Panda Express Locations to
+        resolve a restaurant id. One call, billed per request in real dollars.
+
+        Price: $0.0009 per request.
+
+        Example:
+            res = client.pandaexpress.menu(restaurantId="112551")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "pandaexpress.menu", dict(input), options
+        )
+        return RunResult[PandaexpressMenuData].model_validate(raw)
+
+    async def nutrition(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[PandaexpressNutritionInput],
+    ) -> RunResult[PandaexpressNutritionData]:
+        """Panda Express Nutrition
+
+        Look up official Panda Express nutrition facts by item name: serving size,
+        calories, fat, cholesterol, sodium, carbs, fiber, sugars, and protein. One
+        call, billed per request in real dollars.
+
+        Price: $0.006 per request.
+
+        Example:
+            res = client.pandaexpress.nutrition(query="orange chicken")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "pandaexpress.nutrition", dict(input), options
+        )
+        return RunResult[PandaexpressNutritionData].model_validate(raw)