getanyapi 0.71.0__tar.gz → 0.73.0__tar.gz

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

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "getanyapi"
-version = "0.71.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.71.0 → getanyapi-0.73.0}/src/getanyapi/__init__.py

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

{getanyapi-0.71.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.71.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.71.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.71.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.71.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.71.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.71.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.71.0 → getanyapi-0.73.0}/src/getanyapi/platforms/realtor.py

@@ -217,7 +217,7 @@ class RealtorSearchItem(BaseModel):
     tax_assessed_value: float | None = Field(
         default=None,
         alias="taxAssessedValue",
-        description="Most recent assessed value from the county tax authority, in US dollars.",
+        description="Most recent assessed value from the county tax authority, in US dollars, or null when none is published (common on new construction).",
     )
     title: str | None = Field(
         default=None,

{getanyapi-0.71.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.71.0 → getanyapi-0.73.0}/src/getanyapi/platforms/redfin.py

@@ -221,7 +221,9 @@ class RedfinSearchItem(BaseModel):
         default=None, description="Longitude of the home in decimal degrees."
     )
     lot_size: float | None = Field(
-        default=None, alias="lotSize", description="Lot size in square feet."
+        default=None,
+        alias="lotSize",
+        description="Lot size in square feet, or null when the listing has no lot size (common on condos).",
     )
     mls_id: str | None = Field(
         default=None, alias="mlsId", description="MLS number for the listing."

{getanyapi-0.71.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.71.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."""
@@ -639,6 +639,8 @@ class TiktokVideoInput(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["comments", "likes", "shares", "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. A source that returns only a rounded or shortened value for a field does not count as returning it."""
     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: NotRequired[str]
@@ -1904,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",
@@ -2318,7 +2323,9 @@ class TiktokVideoData(BaseModel):
     caption: str = Field(
         description="Populated whenever the provider has data for the entity."
     )
-    comments: int
+    comments: int = Field(
+        description="Number of comments. Some sources round large counts (48.5K instead of 48,536); name `comments` in requireFields to be served only by a source that returns the exact count."
+    )
     created_utc: float | None = Field(
         default=None,
         alias="createdUtc",
@@ -2334,10 +2341,14 @@ class TiktokVideoData(BaseModel):
         default=None,
         description="URL of the video's cover/thumbnail image. A signed, short-lived TikTok CDN URL (typically expires within about a day; query params are load-bearing and kept intact), often served as HEIC rather than JPEG, so fetch it promptly and transcode if you need broad browser support. Absent when the upstream provides no cover.",
     )
-    likes: int
+    likes: int = Field(
+        description="Number of likes. Some sources round large counts (2.9M instead of 2,884,604); name `likes` in requireFields to be served only by a source that returns the exact count."
+    )
     region: str
     saves: int
-    shares: int
+    shares: int = Field(
+        description="Number of shares. Some sources round large counts (35.9K instead of 35,923); name `shares` in requireFields to be served only by a source that returns the exact count."
+    )
     url: str | None = Field(
         default=None, description="Canonical TikTok URL of the video."
     )
@@ -2346,7 +2357,9 @@ class TiktokVideoData(BaseModel):
         alias="videoUrl",
         description="Playable video URL. Signed and short-lived, so the query string is load-bearing and kept intact.",
     )
-    views: int
+    views: int = Field(
+        description="Number of plays. Some sources round large counts (32.7M instead of 32,736,400); name `views` in requireFields to be served only by a source that returns the exact count."
+    )
 
 
 class TiktokVideoCommentsData(BaseModel):
@@ -2455,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.71.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):
@@ -550,13 +569,18 @@ class TiktokShopShopProductsProduct(BaseModel):
 
     currency: str
     image: str | None = Field(default=None, description="Product image URL.")
-    original_price: float = Field(alias="originalPrice")
+    original_price: float | None = Field(
+        alias="originalPrice",
+        description="Pre-discount list price, or null when the product is not on sale.",
+    )
     price: float
     product_id: str = Field(
         alias="productId",
         description="Populated whenever the provider has data for the entity.",
     )
-    rating: float
+    rating: float | None = Field(
+        description="Average review score out of 5, or null when the product has no rating yet."
+    )
     review_count: int = Field(alias="reviewCount")
     sold_count: int = Field(alias="soldCount")
     title: str = Field(
@@ -587,13 +611,18 @@ class TiktokShopUserShowcaseProduct(BaseModel):
         alias="imageUrl",
         description="Populated whenever the provider has data for the entity.",
     )
-    original_price: str = Field(alias="originalPrice")
+    original_price: str | None = Field(
+        alias="originalPrice",
+        description="Pre-discount list price, or null when the product is not on sale.",
+    )
     price: str
     product_id: str = Field(
         alias="productId",
         description="Populated whenever the provider has data for the entity.",
     )
-    rating: float
+    rating: float | None = Field(
+        description="Average review score out of 5, or null when the product has no rating yet."
+    )
     review_count: int = Field(alias="reviewCount")
     seller_id: str | None = Field(
         default=None,

{getanyapi-0.71.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.71.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.71.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,6 +152,8 @@ 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["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."""
     source: NotRequired[list[str]]
@@ -399,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):
@@ -487,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.",
@@ -498,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):
@@ -574,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,
@@ -620,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.",
@@ -631,7 +647,9 @@ class YoutubeChannelVideosVideo(BaseModel):
     url: str = Field(
         description="Populated whenever the provider has data for the entity."
     )
-    views: int
+    views: int = Field(
+        description="Number of views. Some sources round large counts (6.4M instead of 6,474,059); name `views` in requireFields to be served only by a source that returns the exact count."
+    )
 
 
 class YoutubeCommentRepliesData(BaseModel):
@@ -933,7 +951,7 @@ class YoutubeSearchShortsShort(BaseModel):
         description="Watch URL for the Short. Populated whenever the provider has data for the entity."
     )
     views: int = Field(
-        description="View count, or 0 when the source did not publish one. Read viewsAvailable before trusting a 0."
+        description="View count, or 0 when the source did not publish one. Read viewsAvailable before trusting a 0. Rounded as YouTube shows it on Shorts (8.9M, 875K), so counts of 1,000 or more are approximate."
     )
     views_available: bool = Field(
         alias="viewsAvailable",
@@ -973,7 +991,8 @@ class YoutubeTrendingShortsShort(BaseModel):
         description="Populated whenever the provider has data for the entity.",
     )
     comments: int | None = Field(
-        default=None, description="Number of comments on the short."
+        default=None,
+        description="Number of comments on the short. Rounded as YouTube shows it on Shorts (1.2K, 15K), so counts of 1,000 or more are approximate.",
     )
     created_utc: float | None = Field(
         default=None,

{getanyapi-0.71.0 → getanyapi-0.73.0}/src/getanyapi/platforms/zillow.py

@@ -279,7 +279,7 @@ class ZillowPropertyItem(BaseModel):
     rent_zestimate: float | None = Field(
         default=None,
         alias="rentZestimate",
-        description="Zillow estimated monthly rent.",
+        description="Zillow estimated monthly rent, or null when Zillow shows no rent Zestimate for the property.",
     )
     sqft: float | None = Field(
         default=None, description="Interior living area in square feet."
@@ -294,7 +294,8 @@ class ZillowPropertyItem(BaseModel):
         description="Canonical Zillow property detail page URL. Populated whenever the provider has data for the entity."
     )
     zestimate: float | None = Field(
-        default=None, description="Zillow estimated market value."
+        default=None,
+        description="Zillow estimated market value, or null when Zillow shows no Zestimate for the property.",
     )
     zpid: str = Field(
         description="Zillow property id (zpid), the stable identifier for the property. Populated whenever the provider has data for the entity."