getanyapi 0.43.0__tar.gz → 0.45.0__tar.gz

{getanyapi-0.43.0 → getanyapi-0.45.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: getanyapi
-Version: 0.43.0
+Version: 0.45.0
 Summary: Official typed Python SDK for AnyAPI: any API, one wallet, USD, no subscriptions.
 Project-URL: Homepage, https://getanyapi.com
 Project-URL: Documentation, https://getanyapi.com/docs

{getanyapi-0.43.0 → getanyapi-0.45.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "getanyapi"
-version = "0.43.0"
+version = "0.45.0"
 description = "Official typed Python SDK for AnyAPI: any API, one wallet, USD, no subscriptions."
 readme = "README.md"
 requires-python = ">=3.10"

{getanyapi-0.43.0 → getanyapi-0.45.0}/src/getanyapi/__init__.py

@@ -54,7 +54,7 @@ from .types import (
     unwrap,
 )
 
-__version__ = "0.43.0"
+__version__ = "0.45.0"
 
 __all__ = [
     # clients + top-level functions

{getanyapi-0.43.0 → getanyapi-0.45.0}/src/getanyapi/platforms/amazon.py

@@ -35,6 +35,21 @@ class AmazonBestsellersInput(TypedDict, total=False):
     """Maximum number of results to return (1-20, default 20). Range: 1 to 20. Default: 20."""
     preferLatencyUnderMs: NotRequired[int]
     """Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. Minimum: 1."""
+    requireFields: NotRequired[
+        list[
+            Literal[
+                "categoryName",
+                "currency",
+                "image",
+                "offersCount",
+                "price",
+                "rank",
+                "rating",
+                "reviewsCount",
+            ]
+        ]
+    ]
+    """Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `offersCount` or `categoryName`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a product that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
     url: Required[str]
     """Amazon Best Sellers category URL (e.g. https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics)."""
 
@@ -137,6 +152,22 @@ class AmazonSearchInput(TypedDict, total=False):
     """Maximum number of results to return (1-20, default 20). Range: 1 to 20. Default: 20."""
     preferLatencyUnderMs: NotRequired[int]
     """Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. Minimum: 1."""
+    requireFields: NotRequired[
+        list[
+            Literal[
+                "currency",
+                "image",
+                "isSponsored",
+                "listPrice",
+                "offersCount",
+                "position",
+                "price",
+                "rating",
+                "reviewsCount",
+            ]
+        ]
+    ]
+    """Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `offersCount`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a product that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
     url: Required[str]
     """Amazon search or category URL to pull results from (e.g. https://www.amazon.com/s?k=gaming+mouse)."""
 
@@ -193,7 +224,7 @@ class AmazonBestsellersItem(BaseModel):
     category_name: str | None = Field(
         default=None,
         alias="categoryName",
-        description="Best Sellers category name the product ranks in.",
+        description="Best Sellers category name the product ranks in, or null when the serving source does not publish it.",
     )
     currency: str | None = Field(
         default=None, description='Price currency symbol or code, e.g. "$".'
@@ -204,7 +235,7 @@ class AmazonBestsellersItem(BaseModel):
     offers_count: int | None = Field(
         default=None,
         alias="offersCount",
-        description="Number of available offers; 0 when unknown.",
+        description="Number of available offers, or null when the serving source does not publish it.",
     )
     price: float | None = Field(
         default=None, description="Listed price; 0 when no offer is available."
@@ -367,12 +398,12 @@ class AmazonSearchItem(BaseModel):
     list_price: float | None = Field(
         default=None,
         alias="listPrice",
-        description="Pre-discount list price when on sale; 0 when not discounted.",
+        description="Pre-discount list price when on sale, 0 when not discounted, or null when the serving source does not publish it.",
     )
     offers_count: int | None = Field(
         default=None,
         alias="offersCount",
-        description="Number of available offers; 0 when unknown.",
+        description="Number of available offers, or null when the serving source does not publish it.",
     )
     position: int | None = Field(
         default=None, description="1-based position of the result on the search page."

{getanyapi-0.43.0 → getanyapi-0.45.0}/src/getanyapi/platforms/google.py

@@ -3,7 +3,7 @@
 
 from __future__ import annotations
 
-from typing import Literal, TYPE_CHECKING
+from typing import TYPE_CHECKING
 
 from pydantic import BaseModel, ConfigDict, Field
 from typing_extensions import NotRequired, Required, TypedDict, Unpack
@@ -37,10 +37,6 @@ class GoogleAiOverviewInput(TypedDict, total=False):
     """Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. Minimum: 1."""
     prompt: Required[str]
     """The question or prompt to answer with a Google AI Overview."""
-    requireFields: NotRequired[
-        list[Literal["citations", "index", "scrapedAt", "title", "url"]]
-    ]
-    """Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `citations` or `index`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a result that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
 
 
 class GoogleAutocompleteInput(TypedDict, total=False):

{getanyapi-0.43.0 → getanyapi-0.45.0}/src/getanyapi/platforms/instagram.py

@@ -160,6 +160,8 @@ class InstagramMediaTranscriptInput(TypedDict, total=False):
 class InstagramPostInput(TypedDict, total=False):
     """Input for Instagram Post."""
 
+    hostVideo: NotRequired[bool]
+    """Set true to also get the post's video on a hosted MP4 link that plays without an Instagram session. The file is downloaded and stored for you, and the response adds `hostedUrl`, `expiresUtc` and `bytes`. It is charged as an extra on top of the price, and it never changes which source serves you: every source offers it at the same price. A post with no video, or a post that does not exist, is refused with no charge rather than billed for a file that cannot exist. Omit it and nothing is downloaded, nothing is stored, and nothing extra is charged. Default: false."""
     preferLatencyUnderMs: NotRequired[int]
     """Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. Minimum: 1."""
     requireFields: NotRequired[
@@ -213,10 +215,12 @@ class InstagramProfileContactInput(TypedDict, total=False):
 class InstagramReelTranscriptInput(TypedDict, total=False):
     """Input for Instagram Reel Transcript."""
 
+    hostVideo: NotRequired[bool]
+    """Set true to also get the reel's MP4 on a hosted link you can play without an Instagram session. Charged as an extra on top of the transcript (e.g. true). Default: false."""
     preferLatencyUnderMs: NotRequired[int]
     """Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. Minimum: 1."""
     url: Required[str]
-    """The URL of a public Instagram reel or video post with spoken audio (e.g. https://www.instagram.com/reel/C8yKXdRxKqK/)."""
+    """The URL of a public Instagram reel or video post (e.g. https://www.instagram.com/reel/C8yKXdRxKqK/), or an Instagram CDN media URL you already hold."""
     wordTimestamps: NotRequired[bool]
     """Set true to include a precise timestamp for every word in the transcript (e.g. true). Default: false."""
 
@@ -973,10 +977,24 @@ class InstagramMediaTranscriptTranscript(BaseModel):
 class InstagramPostData(BaseModel):
     model_config = ConfigDict(extra="allow", populate_by_name=True)
 
+    bytes: int | None = Field(
+        default=None,
+        description="Size of the hosted MP4 in bytes. Present only when the request set `hostVideo` to true.",
+    )
     display_url: str = Field(
         alias="displayUrl",
         description="Populated whenever the provider has data for the entity.",
     )
+    expires_utc: int | None = Field(
+        default=None,
+        alias="expiresUtc",
+        description="When `hostedUrl` stops working, as a UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Present only when the request set `hostVideo` to true.",
+    )
+    hosted_url: str | None = Field(
+        default=None,
+        alias="hostedUrl",
+        description="AnyAPI-hosted MP4 of this post's video, playable without an Instagram session. Present only when the request set `hostVideo` to true.",
+    )
     id: str = Field(
         description="Populated whenever the provider has data for the entity."
     )
@@ -1177,57 +1195,72 @@ class InstagramProfileContactData(BaseModel):
 
 class InstagramReelTranscriptData(BaseModel):
     items: list[InstagramReelTranscriptItem] = Field(
-        description="Transcript record for the requested reel (one item), with the full transcript text, timed segments, and source video metadata. Populated whenever the provider has data for the entity."
+        description="Record for the requested reel (one item), with the full transcript text, timed segments, source video metadata, and the hosted video link when hostVideo was asked for. Populated whenever the provider has data for the entity."
     )
 
 
 class InstagramReelTranscriptItem(BaseModel):
     model_config = ConfigDict(extra="allow", populate_by_name=True)
 
-    caption: str | None = Field(
+    bytes: int | None = Field(
         default=None,
-        description="The reel's caption text. Empty when the reel has no caption.",
+        description="Size of the hosted MP4 in bytes. Present only when hostVideo was true.",
     )
-    comment_count: int | None = Field(
+    duration_seconds: float | None = Field(
         default=None,
-        alias="commentCount",
-        description="Number of comments on the reel.",
+        alias="durationSeconds",
+        description="Video duration in seconds. Absent when there is no transcript, which is what measures it.",
     )
-    created_utc: float | None = Field(
+    expires_utc: float | None = Field(
         default=None,
-        alias="createdUtc",
-        description="UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.",
+        alias="expiresUtc",
+        description="UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. After this moment the hosted MP4 is deleted. Present only when hostVideo was true.",
     )
-    duration_seconds: float | None = Field(
-        default=None, alias="durationSeconds", description="Video duration in seconds."
+    hosted_url: str | None = Field(
+        default=None,
+        alias="hostedUrl",
+        description="A direct link to the downloaded MP4, hosted by AnyAPI and playable without an Instagram session. Present only when hostVideo was true.",
     )
     id: str = Field(
-        description="The reel's numeric Instagram media ID, as a string. Populated whenever the provider has data for the entity."
+        description="The reel's numeric Instagram media ID, as a string. Empty when the request supplied a CDN media URL, which carries no post record. Populated whenever the provider has data for the entity."
     )
     language: str | None = Field(
         default=None,
-        description='Detected spoken language (ISO 639-1 code, e.g. "en"). Empty when the upstream omits it.',
+        description='Detected spoken language (ISO 639-1 code, e.g. "en"). Absent when there is no transcript.',
     )
     like_count: int | None = Field(
-        default=None, alias="likeCount", description="Number of likes on the reel."
+        default=None,
+        alias="likeCount",
+        description="Number of likes on the reel. Absent when the lane that served the lookup does not carry a like count.",
+    )
+    media_type: str | None = Field(
+        default=None,
+        alias="mediaType",
+        description="What kind of media this is, as Instagram labels it (for example a video or an image post).",
     )
     owner_username: str | None = Field(
         default=None,
         alias="ownerUsername",
-        description="Username of the reel's owner, without the @ prefix. Empty when the upstream omits it.",
+        description="Username of the reel's owner, without the @ prefix. Empty when the request supplied a CDN media URL.",
     )
     segments: list[InstagramReelTranscriptSegment] | None = Field(
         default=None,
-        description="Time-aligned transcript segments, each with its text and start/end offsets in seconds.",
+        description="Time-aligned transcript segments, each with its text, speaker label, and start/end offsets in seconds. Empty when the reel has no detectable spoken audio.",
+    )
+    shortcode: str | None = Field(
+        default=None,
+        description="The reel's short code, the part of its instagram.com URL after /reel/. Empty when the request supplied a CDN media URL.",
     )
     text: str = Field(
         description="The full speech transcript. Empty when the reel has no detectable spoken audio. Populated whenever the provider has data for the entity."
     )
-    url: str = Field(
-        description="Canonical URL of the reel, with tracking query params stripped. Populated whenever the provider has data for the entity."
+    thumbnail_url: str | None = Field(
+        default=None,
+        alias="thumbnailUrl",
+        description="A link to the reel's cover image on Instagram. This link is signed by Instagram and stops working after a short time.",
     )
-    view_count: int | None = Field(
-        default=None, alias="viewCount", description="Number of video views."
+    url: str = Field(
+        description="The reel URL the request asked for, returned as sent. Populated whenever the provider has data for the entity."
     )
 
 
@@ -1238,6 +1271,10 @@ class InstagramReelTranscriptSegment(BaseModel):
         default=None,
         description="Segment end offset in seconds from the start of the video.",
     )
+    speaker: str | None = Field(
+        default=None,
+        description='Which speaker said this segment, as a stable label within this transcript (e.g. "0", "1").',
+    )
     start: float | None = Field(
         default=None,
         description="Segment start offset in seconds from the start of the video.",
@@ -1245,6 +1282,24 @@ class InstagramReelTranscriptSegment(BaseModel):
     text: str | None = Field(
         default=None, description="The segment's transcribed text."
     )
+    words: list[InstagramReelTranscriptWord] | None = Field(
+        default=None,
+        description="Every word in the segment with its own timing. Present only when wordTimestamps was true.",
+    )
+
+
+class InstagramReelTranscriptWord(BaseModel):
+    model_config = ConfigDict(extra="allow")
+
+    end: float | None = Field(
+        default=None,
+        description="Word end offset in seconds from the start of the video.",
+    )
+    start: float | None = Field(
+        default=None,
+        description="Word start offset in seconds from the start of the video.",
+    )
+    text: str | None = Field(default=None, description="The word as spoken.")
 
 
 class InstagramReelsSearchData(BaseModel):
@@ -2421,9 +2476,12 @@ class InstagramNamespace:
         """Instagram Post
 
         Fetch a single Instagram post or reel by URL (media URLs, like count, owner,
-        type) as normalized JSON.
+        type) as normalized JSON. Turn on hostVideo to also get the post's video on
+        a hosted MP4 link that plays without an Instagram session, charged as an
+        extra on top of the price. If you want the spoken words as well,
+        instagram.reel_transcript transcribes the same reel.
 
-        Price: $0.0012 per request.
+        Price: $0.0005 per request.
 
         Example:
             res = client.instagram.post(url="https://www.instagram.com/reel/DWzrfE2kaY8/")
@@ -2509,7 +2567,7 @@ class InstagramNamespace:
         Fetch an Instagram account's public profile (followers, posts, bio,
         verification) by handle.
 
-        Price: $0.0005 per request.
+        Price: $0.0012 per request.
 
         Example:
             res = client.instagram.profile(handle="nasa")
@@ -2549,13 +2607,19 @@ class InstagramNamespace:
     ) -> RunResult[InstagramReelTranscriptData]:
         """Instagram Reel Transcript
 
-        Turn any public Instagram reel or video post into a full speech transcript,
-        with optional word-level timestamps.
+        Transcribe any public Instagram reel or video post: the full speech
+        transcript, speaker labels, and word-level timestamps, from a reel URL or an
+        Instagram CDN media URL you already hold. Transcription runs on
+        MAI-Transcribe-2, chosen for its accuracy and its speaker labels. Turn on
+        hostVideo to also get the MP4 on a hosted link that plays without an
+        Instagram session. If you only want the text, instagram.media_transcript is
+        the cheaper transcript-only option; if you only want the file,
+        instagram.post is where you go.
 
-        Price: $0.0055 per request plus $0.0253 per result (maximum $0.0308).
+        Price: $0.0015 per request plus $0.006 per audio minute (maximum $0.095).
 
         Example:
-            res = client.instagram.reel_transcript(url="https://www.instagram.com/reel/DWzrfE2kaY8/", wordTimestamps=False)
+            res = client.instagram.reel_transcript(hostVideo=True, url="https://www.instagram.com/reel/CfY6jCIgH-P/", wordTimestamps=False)
         """
         raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
             "instagram.reel_transcript", dict(input), options
@@ -3439,9 +3503,12 @@ class AsyncInstagramNamespace:
         """Instagram Post
 
         Fetch a single Instagram post or reel by URL (media URLs, like count, owner,
-        type) as normalized JSON.
+        type) as normalized JSON. Turn on hostVideo to also get the post's video on
+        a hosted MP4 link that plays without an Instagram session, charged as an
+        extra on top of the price. If you want the spoken words as well,
+        instagram.reel_transcript transcribes the same reel.
 
-        Price: $0.0012 per request.
+        Price: $0.0005 per request.
 
         Example:
             res = client.instagram.post(url="https://www.instagram.com/reel/DWzrfE2kaY8/")
@@ -3527,7 +3594,7 @@ class AsyncInstagramNamespace:
         Fetch an Instagram account's public profile (followers, posts, bio,
         verification) by handle.
 
-        Price: $0.0005 per request.
+        Price: $0.0012 per request.
 
         Example:
             res = client.instagram.profile(handle="nasa")
@@ -3567,13 +3634,19 @@ class AsyncInstagramNamespace:
     ) -> RunResult[InstagramReelTranscriptData]:
         """Instagram Reel Transcript
 
-        Turn any public Instagram reel or video post into a full speech transcript,
-        with optional word-level timestamps.
+        Transcribe any public Instagram reel or video post: the full speech
+        transcript, speaker labels, and word-level timestamps, from a reel URL or an
+        Instagram CDN media URL you already hold. Transcription runs on
+        MAI-Transcribe-2, chosen for its accuracy and its speaker labels. Turn on
+        hostVideo to also get the MP4 on a hosted link that plays without an
+        Instagram session. If you only want the text, instagram.media_transcript is
+        the cheaper transcript-only option; if you only want the file,
+        instagram.post is where you go.
 
-        Price: $0.0055 per request plus $0.0253 per result (maximum $0.0308).
+        Price: $0.0015 per request plus $0.006 per audio minute (maximum $0.095).
 
         Example:
-            res = client.instagram.reel_transcript(url="https://www.instagram.com/reel/DWzrfE2kaY8/", wordTimestamps=False)
+            res = client.instagram.reel_transcript(hostVideo=True, url="https://www.instagram.com/reel/CfY6jCIgH-P/", wordTimestamps=False)
         """
         raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
             "instagram.reel_transcript", dict(input), options

{getanyapi-0.43.0 → getanyapi-0.45.0}/src/getanyapi/platforms/linkedin.py

@@ -2817,7 +2817,8 @@ class LinkedinProfileThinData(BaseModel):
         default=None, description="About/summary text of the profile."
     )
     articles: list[LinkedinProfileThinArticle] | None = Field(
-        default=None, description="The profile's published articles."
+        default=None,
+        description="The profile's published articles, or null when the serving source does not publish them.",
     )
     avatar_url: str | None = Field(
         default=None, alias="avatarUrl", description="URL of the profile avatar image."
@@ -2835,7 +2836,9 @@ class LinkedinProfileThinData(BaseModel):
     )
     name: str = Field(description="Full name of the profile owner.")
     recent_posts: list[LinkedinProfileThinRecentPost] | None = Field(
-        default=None, alias="recentPosts", description="The profile's recent posts."
+        default=None,
+        alias="recentPosts",
+        description="The profile's recent posts, or null when the serving source does not publish them.",
     )
 
 

{getanyapi-0.43.0 → getanyapi-0.45.0}/src/getanyapi/platforms/reddit.py

@@ -826,7 +826,10 @@ class RedditUserPostsMedia(BaseModel):
     model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     height: int | None = None
-    type_: str = Field(alias="type", description="One of photo, video, or gif.")
+    type_: str | None = Field(
+        alias="type",
+        description="One of photo, video, or gif, or null when the serving source wraps a thumbnail it cannot classify.",
+    )
     url: str = Field(
         description="Image URL. For a video or GIF this is the poster/thumbnail frame."
     )

{getanyapi-0.43.0 → getanyapi-0.45.0}/src/getanyapi/platforms/twitter.py

@@ -249,7 +249,7 @@ class TwitterUserPostsInput(TypedDict, total=False):
             ]
         ]
     ]
-    """Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `isReply`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a tweet that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge. On a paginated walk it applies to the first page only; later pages stay with the source that page chose, at the price it was quoted."""
+    """Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `isPinned` or `isReply`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a tweet that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge. On a paginated walk it applies to the first page only; later pages stay with the source that page chose, at the price it was quoted."""
 
 
 class TwitterUserTweetsInput(TypedDict, total=False):
@@ -260,7 +260,7 @@ class TwitterUserTweetsInput(TypedDict, total=False):
     handle: Required[str]
     """Twitter/X handle without the leading @."""
     limit: NotRequired[int]
-    """Maximum number of authored tweets and replies to return in the current bulk call (1-1000). The provider may return fewer results. Range: 1 to 1000. Default: 20."""
+    """Maximum number of authored tweets and replies to return in THIS page (1-100). Sources return fewer - most cap at 20 - so read `nextCursor` and pass it back as `cursor` to walk further rather than asking for one large page. Range: 1 to 100. Default: 20."""
     preferLatencyUnderMs: NotRequired[int]
     """Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. Minimum: 1."""
     requireFields: NotRequired[
@@ -280,7 +280,7 @@ class TwitterUserTweetsInput(TypedDict, total=False):
             ]
         ]
     ]
-    """Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `nextCursor` or `media`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a post that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge. On a paginated walk it applies to the first page only; later pages stay with the source that page chose, at the price it was quoted."""
+    """Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `isPinned` or `nextCursor`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a post that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge. On a paginated walk it applies to the first page only; later pages stay with the source that page chose, at the price it was quoted."""
     requireSinglePage: NotRequired[bool]
     """Require a lane that can return the requested limit in one response."""
 
@@ -1030,9 +1030,9 @@ class TwitterUserPostsTweet(BaseModel):
     id: str = Field(
         description="The post's numeric tweet ID, represented as a string. Populated whenever the provider has data for the entity."
     )
-    is_pinned: bool = Field(
+    is_pinned: bool | None = Field(
         alias="isPinned",
-        description="Whether X marks the post as pinned on the profile.",
+        description="Whether X marks the post as pinned on the profile, or null when the serving source does not publish it.",
     )
     is_reply: bool | None = Field(
         default=None,
@@ -1099,7 +1099,10 @@ class TwitterUserTweetsTweet(BaseModel):
     id: str = Field(
         description="Populated whenever the provider has data for the entity."
     )
-    is_pinned: bool = Field(alias="isPinned")
+    is_pinned: bool | None = Field(
+        alias="isPinned",
+        description="Whether X marks the post as pinned on the profile, or null when the serving source does not publish it.",
+    )
     is_reply: bool | None = Field(default=None, alias="isReply")
     lang: str | None = None
     likes: int

{getanyapi-0.43.0 → getanyapi-0.45.0}/src/getanyapi/platforms/youtube.py

@@ -248,6 +248,20 @@ class YoutubeVideoTranscriptFullInput(TypedDict, total=False):
     """Preferred caption language code (e.g. "en", "es"). Defaults to English."""
     preferLatencyUnderMs: NotRequired[int]
     """Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. Minimum: 1."""
+    requireFields: NotRequired[
+        list[
+            Literal[
+                "channel",
+                "durationSeconds",
+                "endSeconds",
+                "isAiGenerated",
+                "startSeconds",
+                "text",
+                "title",
+            ]
+        ]
+    ]
+    """Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `isAiGenerated`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a transcript that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
     url: Required[str]
     """YouTube video or Short URL (e.g. "https://www.youtube.com/watch?v=dQw4w9WgXcQ" or "https://www.youtube.com/shorts/Fir1x9cw2vg")."""
 
@@ -807,7 +821,7 @@ class YoutubeVideoTranscriptFullData(BaseModel):
     is_ai_generated: bool | None = Field(
         default=None,
         alias="isAiGenerated",
-        description="True when the words were recognized from the audio by the serving lane rather than read from any YouTube caption track.",
+        description="True when the words were recognized from the audio by the serving lane rather than read from any YouTube caption track, or null when the serving source does not say.",
     )
     is_auto_generated: bool = Field(
         alias="isAutoGenerated",
@@ -855,7 +869,7 @@ class YoutubeNamespace:
         Fetch a YouTube channel's stats (subscribers, video count, total views,
         description) by handle or channel ID.
 
-        Price: $0.0012 per request.
+        Price: $0.0005 per request.
 
         Example:
             res = client.youtube.channel(handle="@mkbhd")
@@ -1470,7 +1484,7 @@ class AsyncYoutubeNamespace:
         Fetch a YouTube channel's stats (subscribers, video count, total views,
         description) by handle or channel ID.
 
-        Price: $0.0012 per request.
+        Price: $0.0005 per request.
 
         Example:
             res = client.youtube.channel(handle="@mkbhd")

{getanyapi-0.43.0 → getanyapi-0.45.0}/src/getanyapi/platforms/zillow.py

@@ -96,6 +96,30 @@ class ZillowSearchInput(TypedDict, total=False):
     """Listing type: buy (for sale), rent, or sold. Default: buy."""
     preferLatencyUnderMs: NotRequired[int]
     """Optional; omit it and routing is unchanged, with the cheapest source serving. Prefer sources whose typical response time (median over the trailing 30 days, as published on this endpoint's lane health) is under this many milliseconds; among those, the cheapest serves. This can raise your price: when the cheapest source misses the target, a faster and dearer one serves, and you are quoted and charged its price. If no source is that fast the request is still served, by whichever source offers the best speed for its price - it is never refused for being slow. Sources we have not timed are tried last. This is a preference, not a guarantee: the median describes past requests and is not a ceiling on this one, and it excludes any wait this request itself asks for. On a paginated walk it applies to the first page only: later pages stay with the source that page chose, at the price it was quoted. Minimum: 1."""
+    requireFields: NotRequired[
+        list[
+            Literal[
+                "baths",
+                "beds",
+                "city",
+                "currency",
+                "daysOnZillow",
+                "latitude",
+                "livingArea",
+                "longitude",
+                "lotSize",
+                "price",
+                "propertyType",
+                "rentZestimate",
+                "state",
+                "status",
+                "yearBuilt",
+                "zestimate",
+                "zipcode",
+            ]
+        ]
+    ]
+    """Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `yearBuilt`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a listing that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
     showOnlyPriceReductions: NotRequired[bool]
     """Only show listings with a price reduction. Buy searches only; ignored for rentals (e.g. true)."""
     sortBy: NotRequired[
@@ -242,7 +266,11 @@ class ZillowSearchItem(BaseModel):
     url: str = Field(
         description="Absolute Zillow listing URL. Populated whenever the provider has data for the entity."
     )
-    year_built: int | None = Field(default=None, alias="yearBuilt")
+    year_built: int | None = Field(
+        default=None,
+        alias="yearBuilt",
+        description="Year the home was built, or null when the serving source does not publish it.",
+    )
     zestimate: float | None = Field(
         default=None, description="Zillow estimated market value."
     )