getanyapi 0.72.0__tar.gz → 0.73.0__tar.gz

{getanyapi-0.72.0 → getanyapi-0.73.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: getanyapi
-Version: 0.72.0
+Version: 0.73.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.72.0 → getanyapi-0.73.0}/pyproject.toml

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

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/__init__.py

@@ -55,7 +55,7 @@ from .types import (
     unwrap,
 )
 
-__version__ = "0.72.0"
+__version__ = "0.73.0"
 
 __all__ = [
     # clients + top-level functions

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/alibaba.py

@@ -84,12 +84,12 @@ class AlibabaSearchItem(BaseModel):
     )
     rating: float | None = Field(
         default=None,
-        description="Average buyer review score, 0-5; 0 when the listing has no reviews.",
+        description="Average buyer review score, 0-5; null when Alibaba shows no review score for the supplier.",
     )
     review_count: int | None = Field(
         default=None,
         alias="reviewCount",
-        description="Number of buyer reviews; 0 when none.",
+        description="Number of buyer reviews; null when Alibaba shows no review count for the supplier.",
     )
     supplier_name: str | None = Field(
         default=None, alias="supplierName", description="Supplier / company name."

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/capterra.py

@@ -110,7 +110,7 @@ class CapterraReviewsItem(BaseModel):
     )
     incentivized: bool | None = Field(
         default=None,
-        description="Whether the reviewer received an incentive for the review. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
+        description="Whether the reviewer received an incentive for the review (for example a nominal gift); null when the source does not say. Populated whenever the provider has data for the entity. Present whenever the upstream returns this record.",
     )
     owner_response: str | None = Field(
         default=None,

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/facebook.py

@@ -378,6 +378,8 @@ class FacebookPhotosInput(TypedDict, total=False):
     """Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
     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["imageHeight", "imageWidth", "nextPageId"]]]
+    """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 `imageWidth`, 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 photo that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
     source: NotRequired[list[str]]
     """Optional. Source ids to prefer, in order, taken from this endpoint's `lanes[].source.id` in /catalog or /apis. Omit it and the cheapest source serves, with automatic failover. Listed sources are tried first in the order given, then the others, unless `allowFallbacks` is false. A single source with `allowFallbacks` false is served only by that source at its price, quoted and charged exactly, with no failover. The price is that of the dearest source that may serve. An id that does not serve this endpoint is rejected as invalid input with no charge; a listed source that is not serving right now is refused with no charge, so omit `source` to be served by another. On a paginated walk, later pages must include the source that served page one, or omit `source`."""
     url: Required[str]
@@ -904,8 +906,9 @@ class FacebookAdsSearchAd(BaseModel):
     model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     active: bool
-    ad_count: int = Field(
-        alias="adCount", description="Number of ads in this campaign (collation count)."
+    ad_count: int | None = Field(
+        alias="adCount",
+        description="Number of ads in this campaign (collation count). Null when the source does not report it.",
     )
     caption: str | None = Field(
         default=None,
@@ -1098,8 +1101,9 @@ class FacebookCompanyAdsAd(BaseModel):
     model_config = ConfigDict(extra="allow", populate_by_name=True)
 
     active: bool
-    ad_count: int = Field(
-        alias="adCount", description="Number of ads in this campaign (collation count)."
+    ad_count: int | None = Field(
+        alias="adCount",
+        description="Number of ads in this campaign (collation count). Null when the source does not report it.",
     )
     caption: str | None = Field(
         default=None,
@@ -1578,7 +1582,7 @@ class FacebookMarketplaceListing(BaseModel):
     created_utc: float | None = Field(
         default=None,
         alias="createdUtc",
-        description="UTC epoch timestamp in seconds (Unix time) the listing was created. Multiply by 1000 for a JS Date in milliseconds.",
+        description="UTC epoch timestamp in seconds (Unix time) the listing was created. Multiply by 1000 for a JS Date in milliseconds. Null when the source does not report it.",
     )
     delivery_types: list[str] | None = Field(
         default=None,
@@ -1911,7 +1915,10 @@ class FacebookPhotosData(BaseModel):
         alias="nextCursor",
         description="Opaque cursor for the next page of photos, or null when this lane has no more. Pass it back as cursor to continue.",
     )
-    next_page_id: str = Field(alias="nextPageId")
+    next_page_id: str | None = Field(
+        alias="nextPageId",
+        description="Facebook's own id for the next page of photos. Null when the serving source does not report it; pass nextCursor back as cursor to continue either way.",
+    )
     photos: list[FacebookPhotosPhoto] = Field(
         description="Populated whenever the provider has data for the entity."
     )
@@ -1926,12 +1933,18 @@ class FacebookPhotosPhoto(BaseModel):
     id: str = Field(
         description="Populated whenever the provider has data for the entity."
     )
-    image_height: int = Field(alias="imageHeight")
+    image_height: int | None = Field(
+        alias="imageHeight",
+        description="Height of imageUrl in pixels. Null when the serving source does not report it.",
+    )
     image_url: str = Field(
         alias="imageUrl",
         description="Populated whenever the provider has data for the entity.",
     )
-    image_width: int = Field(alias="imageWidth")
+    image_width: int | None = Field(
+        alias="imageWidth",
+        description="Width of imageUrl in pixels. Null when the serving source does not report it.",
+    )
     photo_id: str = Field(
         alias="photoId",
         description="Populated whenever the provider has data for the entity.",
@@ -2436,7 +2449,7 @@ class FacebookSearchPostsData(BaseModel):
     images_count: int | None = Field(
         default=None,
         alias="imagesCount",
-        description="Number of images attached to the post.",
+        description="Number of images attached to the post. Null when the source does not report it.",
     )
     items: list[FacebookSearchPostsItem] = Field(
         description="Matching public Facebook post records for the query. Populated whenever the provider has data for the entity."

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/google_ads.py

@@ -120,8 +120,14 @@ class GoogleAdsAdDetailsData(BaseModel):
     format: str = Field(
         description="Populated whenever the provider has data for the entity."
     )
-    impressions_max: int = Field(alias="impressionsMax")
-    impressions_min: int = Field(alias="impressionsMin")
+    impressions_max: int | None = Field(
+        alias="impressionsMax",
+        description="Upper bound of the impressions range. Null when Google does not publish one for this creative.",
+    )
+    impressions_min: int | None = Field(
+        alias="impressionsMin",
+        description="Lower bound of the impressions range. Null when Google does not publish one for this creative.",
+    )
     last_shown: str = Field(alias="lastShown", description="ISO 8601 date.")
     url: str | None = Field(
         default=None, description="Google Ads Transparency Center URL for the creative."

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/google_shopping.py

@@ -98,12 +98,12 @@ class GoogleShoppingSearchItem(BaseModel):
         default=None, alias="productId", description="Provider product identifier."
     )
     rating: float | None = Field(
-        default=None, description="Average product rating, 0-5; 0 when unrated."
+        default=None, description="Average product rating, 0-5; null when unrated."
     )
     reviews_count: int | None = Field(
         default=None,
         alias="reviewsCount",
-        description="Number of ratings / reviews; 0 when none reported.",
+        description="Number of ratings / reviews; null when none reported.",
     )
     seller: str | None = Field(
         default=None,

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/instagram.py

@@ -306,7 +306,7 @@ class InstagramProfileInput(TypedDict, total=False):
     """Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
     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["contactMethod"]]]
+    requireFields: NotRequired[list[Literal["contactMethod", "posts"]]]
     """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 `contactMethod`, 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 profile that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
     source: NotRequired[list[str]]
     """Optional. Source ids to prefer, in order, taken from this endpoint's `lanes[].source.id` in /catalog or /apis. Omit it and the cheapest source serves, with automatic failover. Listed sources are tried first in the order given, then the others, unless `allowFallbacks` is false. A single source with `allowFallbacks` false is served only by that source at its price, quoted and charged exactly, with no failover. The price is that of the dearest source that may serve. An id that does not serve this endpoint is rejected as invalid input with no charge; a listed source that is not serving right now is refused with no charge, so omit `source` to be served by another. On a paginated walk, later pages must include the source that served page one, or omit `source`."""
@@ -467,6 +467,8 @@ class InstagramSearchProfilesInput(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."""
     query: Required[str]
     """Bio or caption keyword/phrase to search for."""
+    requireFields: NotRequired[list[Literal["private"]]]
+    """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 `private`, 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 profile that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
     source: NotRequired[list[str]]
     """Optional. Source ids to prefer, in order, taken from this endpoint's `lanes[].source.id` in /catalog or /apis. Omit it and the cheapest source serves, with automatic failover. Listed sources are tried first in the order given, then the others, unless `allowFallbacks` is false. A single source with `allowFallbacks` false is served only by that source at its price, quoted and charged exactly, with no failover. The price is that of the dearest source that may serve. An id that does not serve this endpoint is rejected as invalid input with no charge; a listed source that is not serving right now is refused with no charge, so omit `source` to be served by another. On a paginated walk, later pages must include the source that served page one, or omit `source`."""
 
@@ -1466,7 +1468,9 @@ class InstagramPostCommentsComment(BaseModel):
     id: str = Field(
         description="Populated whenever the provider has data for the entity."
     )
-    likes: int
+    likes: int | None = Field(
+        description="Number of likes on the comment. Null when the source does not report it."
+    )
     text: str = Field(
         description="Populated whenever the provider has data for the entity."
     )
@@ -1553,8 +1557,8 @@ class InstagramProfileData(BaseModel):
         alias="isBusiness",
         description="Whether Instagram flags the account as a business account.",
     )
-    posts: int = Field(
-        description="Always 0: none of the sources behind this API returns the account's total post count."
+    posts: int | None = Field(
+        description="Total number of posts on the account. Null when the serving source does not report it."
     )
     private: bool = Field(description="Whether the account is private.")
     user_id: str | None = Field(
@@ -2080,7 +2084,9 @@ class InstagramSearchProfilesProfile(BaseModel):
         description="Populated whenever the provider has data for the entity."
     )
     posts: int
-    private: bool
+    private: bool | None = Field(
+        description="Whether the account is private. Null when the serving source does not report it."
+    )
     url: str | None = Field(default=None, description="Canonical URL of the profile.")
     verified: bool
 
@@ -2161,7 +2167,9 @@ class InstagramSimilarProfilesProfile(BaseModel):
         description="Profile picture URL, as Instagram's CDN serves it.",
     )
     display_name: str = Field(alias="displayName", description="Account display name.")
-    private: bool = Field(description="Whether the account is private.")
+    private: bool | None = Field(
+        description="Whether the account is private. Null when the source does not report it."
+    )
     user_id: str = Field(
         alias="userId", description="Instagram's numeric account id, as a string."
     )
@@ -2337,7 +2345,9 @@ class InstagramTaggedPostsPost(BaseModel):
     id: str = Field(
         description="The post's numeric Instagram media ID, as a string. Populated whenever the provider has data for the entity."
     )
-    likes: int = Field(description="Number of likes on the post.")
+    likes: int | None = Field(
+        description="Number of likes on the post. Null when the source does not report it, including when the owner hides like counts."
+    )
     url: str = Field(
         description="Canonical URL of the post, with tracking query params stripped. Populated whenever the provider has data for the entity."
     )
@@ -2810,8 +2820,9 @@ class InstagramWebReelsSearchReel(BaseModel):
         alias="createdUtc",
         description="UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.",
     )
-    duration_seconds: float = Field(
-        alias="durationSeconds", description="Reel duration in seconds."
+    duration_seconds: float | None = Field(
+        alias="durationSeconds",
+        description="Reel duration in seconds. Null when the source does not report it.",
     )
     likes: int = Field(description="Number of likes on the reel.")
     paid_partnership: bool = Field(

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/linkedin.py

@@ -1281,10 +1281,12 @@ class LinkedinCompanyEmployeeCountRange(BaseModel):
     model_config = ConfigDict(extra="allow")
 
     end: int | None = Field(
-        default=None, description="Upper bound of the employee-count bucket."
+        default=None,
+        description="Upper bound of the employee-count bucket; null when the source does not report it.",
     )
     start: int | None = Field(
-        default=None, description="Lower bound of the employee-count bucket."
+        default=None,
+        description="Lower bound of the employee-count bucket; null when the source does not report it.",
     )
 
 
@@ -1310,7 +1312,7 @@ class LinkedinCompanyFundingData(BaseModel):
     num_funding_rounds: int | None = Field(
         default=None,
         alias="numFundingRounds",
-        description="Total number of funding rounds.",
+        description="Total number of funding rounds; null when the source does not report it.",
     )
 
 
@@ -2051,8 +2053,12 @@ class LinkedinJobsCompany(BaseModel):
 class LinkedinJobsSalary(BaseModel):
     model_config = ConfigDict(extra="allow")
 
-    max: float | None = Field(default=None, description="Maximum salary.")
-    min: float | None = Field(default=None, description="Minimum salary.")
+    max: float | None = Field(
+        default=None, description="Maximum salary; null when the posting shows none."
+    )
+    min: float | None = Field(
+        default=None, description="Minimum salary; null when the posting shows none."
+    )
     text: str | None = Field(
         default=None, description="Salary as displayed (e.g. '300,000 - 330,000 USD')."
     )
@@ -3948,7 +3954,7 @@ class LinkedinSearchProfilesEmailItem(BaseModel):
     follower_count: int | None = Field(
         default=None,
         alias="followerCount",
-        description="Number of followers of the profile.",
+        description="Number of followers of the profile; null when the source does not report it.",
     )
     handle: str | None = Field(
         default=None,

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/reddit.py

@@ -94,6 +94,8 @@ class RedditProfileInput(TypedDict, total=False):
     """Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
     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["verified"]]]
+    """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 `verified`, 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 profile that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
     source: NotRequired[list[str]]
     """Optional. Source ids to prefer, in order, taken from this endpoint's `lanes[].source.id` in /catalog or /apis. Omit it and the cheapest source serves, with automatic failover. Listed sources are tried first in the order given, then the others, unless `allowFallbacks` is false. A single source with `allowFallbacks` false is served only by that source at its price, quoted and charged exactly, with no failover. The price is that of the dearest source that may serve. An id that does not serve this endpoint is rejected as invalid input with no charge; a listed source that is not serving right now is refused with no charge, so omit `source` to be served by another. On a paginated walk, later pages must include the source that served page one, or omit `source`."""
     username: Required[str]
@@ -382,7 +384,7 @@ class RedditPostCommentsData(BaseModel):
     )
     media: list[RedditPostCommentsMedia] | None = Field(
         default=None,
-        description="Photo, video, and GIF attachments on the post. Empty when the post has none.",
+        description="Photo, video, and GIF attachments on the post. Empty when the post has none; null when the serving source does not report attachments.",
     )
     next_cursor: str | None = Field(
         alias="nextCursor",
@@ -523,7 +525,8 @@ class RedditProfileData(BaseModel):
         description="Account username, without the u/ prefix. Populated whenever the provider has data for the entity."
     )
     verified: bool | None = Field(
-        default=None, description="True when the account is verified by Reddit."
+        default=None,
+        description="True when the account is verified by Reddit. Null when the serving source does not report it.",
     )
 
 

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/threads.py

@@ -122,7 +122,10 @@ class ThreadsPostData(BaseModel):
         alias="profilePicUrl",
         description="Profile picture URL of the author.",
     )
-    quote_count: int = Field(alias="quoteCount", description="Number of quote posts.")
+    quote_count: int | None = Field(
+        alias="quoteCount",
+        description="Number of quote posts. Null when the source does not report it.",
+    )
     reply_count: int = Field(
         alias="replyCount", description="Number of replies to the post."
     )

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/tiktok.py

@@ -442,7 +442,7 @@ class TiktokSearchTopInput(TypedDict, total=False):
     """Keyword to search for (e.g. "funny")."""
     region: NotRequired[str]
     """2-letter country code for the proxy location (e.g. US, GB, FR)."""
-    requireFields: NotRequired[list[Literal["nextCursor"]]]
+    requireFields: NotRequired[list[Literal["contentType", "nextCursor"]]]
     """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`, 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 record that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
     sortBy: NotRequired[Literal["relevance", "most-liked", "date-posted"]]
     """Sort order: relevance, most-liked, date-posted."""
@@ -1906,7 +1906,10 @@ class TiktokSearchTopItem(BaseModel):
         description="Populated whenever the provider has data for the entity."
     )
     comments: int
-    content_type: str = Field(alias="contentType")
+    content_type: str | None = Field(
+        alias="contentType",
+        description="TikTok's own label for the post format, such as video, or null when the serving source does not report it.",
+    )
     created_utc: float | None = Field(
         default=None,
         alias="createdUtc",
@@ -2465,7 +2468,10 @@ class TiktokVideoTranscriptData(BaseModel):
     id: str | None = Field(
         default=None, description="TikTok video id the transcript belongs to."
     )
-    language: str | None = None
+    language: str | None = Field(
+        default=None,
+        description="Language of the caption track, or null when the serving source does not report it.",
+    )
     transcript: str = Field(
         description="Populated whenever the provider has data for the entity."
     )

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/tiktok_shop.py

@@ -64,6 +64,8 @@ class TiktokShopProductInput(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."""
     region: NotRequired[str]
     """Two-letter country code for the proxy location used to access region-specific products (e.g. US, GB, FR). Defaults to US."""
+    requireFields: NotRequired[list[Literal["sellerLocation"]]]
+    """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 `sellerLocation`, 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."""
     source: NotRequired[list[str]]
     """Optional. Source ids to prefer, in order, taken from this endpoint's `lanes[].source.id` in /catalog or /apis. Omit it and the cheapest source serves, with automatic failover. Listed sources are tried first in the order given, then the others, unless `allowFallbacks` is false. A single source with `allowFallbacks` false is served only by that source at its price, quoted and charged exactly, with no failover. The price is that of the dearest source that may serve. An id that does not serve this endpoint is rejected as invalid input with no charge; a listed source that is not serving right now is refused with no charge, so omit `source` to be served by another. On a paginated walk, later pages must include the source that served page one, or omit `source`."""
     url: Required[str]
@@ -160,6 +162,8 @@ class TiktokShopShopProductsInput(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."""
     region: NotRequired[str]
     """Two-letter country code of the store's market (e.g. US)."""
+    requireFields: NotRequired[list[Literal["productCount", "shopRating"]]]
+    """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 `shopRating`, 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 store 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."""
     sortBy: NotRequired[Literal["top", "new_releases"]]
     """Product ordering within the store. Default: top."""
     source: NotRequired[list[str]]
@@ -284,7 +288,7 @@ class TiktokShopCreatorData(BaseModel):
     )
     gpm: float | None = Field(
         default=None,
-        description="Gross merchandise value per thousand views. Zero when upstream does not publish it.",
+        description="Gross merchandise value per thousand views. Null when upstream does not publish it.",
     )
     handle: str = Field(
         description="TikTok handle of the creator, without the @. Populated whenever the provider has data for the entity."
@@ -316,7 +320,7 @@ class TiktokShopCreatorData(BaseModel):
     )
     rating: float | None = Field(
         default=None,
-        description="Creator rating. Zero when upstream does not publish it.",
+        description="Creator rating. Null when upstream does not publish it.",
     )
     region: str | None = Field(
         default=None,
@@ -395,7 +399,10 @@ class TiktokShopProductData(BaseModel):
     )
     rating: float
     review_count: int = Field(alias="reviewCount")
-    seller_location: str = Field(alias="sellerLocation")
+    seller_location: str | None = Field(
+        alias="sellerLocation",
+        description="Where the seller is based, or null when the serving source does not report it.",
+    )
     seller_name: str = Field(
         alias="sellerName",
         description="Populated whenever the provider has data for the entity.",
@@ -413,12 +420,15 @@ class TiktokShopProductReviewsData(BaseModel):
         alias="hasMore",
         description="True when more reviews are available beyond this page.",
     )
-    rating: float = Field(description="Overall product score (1-5).")
+    rating: float | None = Field(
+        description="Overall product score (1-5), or null when the serving source does not report it."
+    )
     reviews: list[TiktokShopProductReviewsReview] = Field(
         description="Product reviews. Populated whenever the provider has data for the entity."
     )
-    total_reviews: int = Field(
-        alias="totalReviews", description="Total number of reviews for the product."
+    total_reviews: int | None = Field(
+        alias="totalReviews",
+        description="Total number of reviews for the product, or null when the serving source does not report it.",
     )
 
 
@@ -533,7 +543,10 @@ class TiktokShopShopProductsData(BaseModel):
         alias="nextCursor",
         description="Opaque cursor for the next page of products, or null when this lane has no more. Pass it back as cursor to continue.",
     )
-    product_count: int = Field(alias="productCount")
+    product_count: int | None = Field(
+        alias="productCount",
+        description="Number of products the store has on sale, or null when the serving source does not report it.",
+    )
     products: list[TiktokShopShopProductsProduct] = Field(
         description="Populated whenever the provider has data for the entity."
     )
@@ -541,8 +554,14 @@ class TiktokShopShopProductsData(BaseModel):
         alias="shopName",
         description="Populated whenever the provider has data for the entity.",
     )
-    shop_rating: float = Field(alias="shopRating")
-    sold_count: int = Field(alias="soldCount")
+    shop_rating: float | None = Field(
+        alias="shopRating",
+        description="The store's rating out of 5, or null when the serving source does not report it.",
+    )
+    sold_count: int | None = Field(
+        alias="soldCount",
+        description="Units the store has sold across all its products, or null when the serving source does not report it.",
+    )
 
 
 class TiktokShopShopProductsProduct(BaseModel):

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/tripadvisor.py

@@ -224,13 +224,13 @@ class TripadvisorSearchItem(BaseModel):
         default=None,
         description='Ranking string within its location (e.g. "#2 of 1,885 hotels in Paris").',
     )
-    rating: float = Field(
-        description="Average traveler rating out of 5. Populated whenever the provider has data for the entity."
+    rating: float | None = Field(
+        description="Average traveler rating out of 5; null for a place Tripadvisor has not rated (such as a city). Populated whenever the provider has data for the entity."
     )
     review_count: float | None = Field(
         default=None,
         alias="reviewCount",
-        description="Total number of traveler reviews.",
+        description="Total number of traveler reviews; null when the source does not report it.",
     )
     title: str = Field(
         description="Place name. Populated whenever the provider has data for the entity."

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/twitter.py

@@ -743,7 +743,9 @@ class TwitterRepliesItem(BaseModel):
         description="Canonical x.com URL of the reply, with tracking query params stripped. Populated whenever the provider has data for the entity."
     )
     view_count: int | None = Field(
-        default=None, alias="viewCount", description="Number of views of this reply."
+        default=None,
+        alias="viewCount",
+        description="Number of views of this reply. Null when the source does not report it, as for posts older than X view counts.",
     )
 
 
@@ -842,7 +844,11 @@ class TwitterSearchItem(BaseModel):
     url: str = Field(
         description="Populated whenever the provider has data for the entity."
     )
-    view_count: int | None = Field(default=None, alias="viewCount")
+    view_count: int | None = Field(
+        default=None,
+        alias="viewCount",
+        description="Number of views. Null when the source does not report it, as for posts older than X view counts.",
+    )
 
 
 class TwitterSearchMedia(BaseModel):

{getanyapi-0.72.0 → getanyapi-0.73.0}/src/getanyapi/platforms/youtube.py

@@ -34,6 +34,8 @@ class YoutubeChannelInput(TypedDict, total=False):
     """Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
     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["views"]]]
+    """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 `views`, 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 record that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge."""
     source: NotRequired[list[str]]
     """Optional. Source ids to prefer, in order, taken from this endpoint's `lanes[].source.id` in /catalog or /apis. Omit it and the cheapest source serves, with automatic failover. Listed sources are tried first in the order given, then the others, unless `allowFallbacks` is false. A single source with `allowFallbacks` false is served only by that source at its price, quoted and charged exactly, with no failover. The price is that of the dearest source that may serve. An id that does not serve this endpoint is rejected as invalid input with no charge; a listed source that is not serving right now is refused with no charge, so omit `source` to be served by another. On a paginated walk, later pages must include the source that served page one, or omit `source`."""
 
@@ -89,6 +91,8 @@ class YoutubeChannelLivesInput(TypedDict, total=False):
     """Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
     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["lengthText"]]]
+    """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 `lengthText`, 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 live stream 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."""
     source: NotRequired[list[str]]
     """Optional. Source ids to prefer, in order, taken from this endpoint's `lanes[].source.id` in /catalog or /apis. Omit it and the cheapest source serves, with automatic failover. Listed sources are tried first in the order given, then the others, unless `allowFallbacks` is false. A single source with `allowFallbacks` false is served only by that source at its price, quoted and charged exactly, with no failover. The price is that of the dearest source that may serve. An id that does not serve this endpoint is rejected as invalid input with no charge; a listed source that is not serving right now is refused with no charge, so omit `source` to be served by another. On a paginated walk, later pages must include the source that served page one, or omit `source`."""
 
@@ -148,7 +152,7 @@ class YoutubeChannelVideosInput(TypedDict, total=False):
     """Optional. Source ids to skip for this request, taken from this endpoint's `lanes[].source.id`. The cheapest remaining source serves and the price is that of the dearest remaining source. An id that does not serve this endpoint, or that is also in `source`, is rejected as invalid input with no charge; skipping every source is rejected the same way."""
     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["views"]]]
+    requireFields: NotRequired[list[Literal["lengthText", "views"]]]
     """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 `views`, 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 video 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. A source that returns only a rounded or shortened value for a field does not count as returning it."""
     sort: NotRequired[Literal["latest", "popular"]]
     """Sort order."""
@@ -401,7 +405,9 @@ class YoutubeChannelData(BaseModel):
         description="Canonical URL of the channel page, tracking query parameters stripped.",
     )
     videos: int
-    views: int
+    views: int | None = Field(
+        description="Lifetime view count across the channel's videos, or null when the serving source does not report it."
+    )
 
 
 class YoutubeChannelCommunityPostsData(BaseModel):
@@ -489,7 +495,10 @@ class YoutubeChannelLivesLive(BaseModel):
         default=None,
         description="URL of the live stream thumbnail image, tracking query parameters stripped.",
     )
-    length_text: str = Field(alias="lengthText")
+    length_text: str | None = Field(
+        alias="lengthText",
+        description="Stream length as YouTube shows it, such as 3:29:31, or LIVE while it is streaming; null when the serving source does not report it.",
+    )
     published_time: str = Field(
         alias="publishedTime",
         description="Populated whenever the provider has data for the entity.",
@@ -500,7 +509,9 @@ class YoutubeChannelLivesLive(BaseModel):
     url: str = Field(
         description="Populated whenever the provider has data for the entity."
     )
-    views: int
+    views: int = Field(
+        description='Views of a past stream, or people watching a stream that is live now. Every source reads it from YouTube\'s rounded label ("60K watching" is 60000), so it is approximate.'
+    )
 
 
 class YoutubeChannelPlaylistsData(BaseModel):
@@ -576,8 +587,8 @@ class YoutubeChannelShortsShort(BaseModel):
         default=None,
         description="URL of the short thumbnail image, tracking query parameters stripped.",
     )
-    likes: int = Field(
-        description="Public like count when supplied by the upstream response. Minimum: 0."
+    likes: int | None = Field(
+        description="Public like count, or null when the serving source does not report it. Minimum: 0."
     )
     title: str | None = Field(
         default=None,
@@ -622,7 +633,10 @@ class YoutubeChannelVideosVideo(BaseModel):
         default=None,
         description="URL of the video thumbnail image, tracking query parameters stripped.",
     )
-    length_text: str = Field(alias="lengthText")
+    length_text: str | None = Field(
+        alias="lengthText",
+        description="Video length as YouTube shows it, such as 11:56, or null when the serving source does not report it.",
+    )
     published_time: str = Field(
         alias="publishedTime",
         description="Populated whenever the provider has data for the entity.",