getanyapi 0.97.2__tar.gz → 0.98.0__tar.gz

{getanyapi-0.97.2 → getanyapi-0.98.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: getanyapi
-Version: 0.97.2
+Version: 0.98.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.97.2 → getanyapi-0.98.0}/pyproject.toml

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

{getanyapi-0.97.2 → getanyapi-0.98.0}/src/getanyapi/__init__.py

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

{getanyapi-0.97.2 → getanyapi-0.98.0}/src/getanyapi/platforms/facebook.py

@@ -470,7 +470,7 @@ class FacebookProfileEventsInput(TypedDict, total=False):
     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]
-    """The Facebook page URL."""
+    """The Facebook page URL whose events to list, e.g. https://www.facebook.com/brickyardoldtown. A single event link (https://www.facebook.com/events/<id>) is refused as invalid input, with no charge; facebook.event_details reads one event."""
 
 
 class FacebookProfilePostsInput(TypedDict, total=False):
@@ -489,7 +489,7 @@ class FacebookProfilePostsInput(TypedDict, total=False):
     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]
-    """Full Facebook page/profile URL."""
+    """Full Facebook page or profile URL, e.g. https://www.facebook.com/nike. A single event link (https://www.facebook.com/events/<id>) is refused as invalid input, with no charge; facebook.event_details reads one event."""
 
 
 class FacebookProfileReelsInput(TypedDict, total=False):

{getanyapi-0.97.2 → getanyapi-0.98.0}/src/getanyapi/platforms/reddit.py

@@ -48,7 +48,7 @@ class RedditPostInput(TypedDict, total=False):
     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]
-    """Full Reddit post URL in the /r/<subreddit>/comments/<id>/<slug>/ form, e.g. "https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/". The short "reddit.com/comments/<id>" form is not accepted."""
+    """Reddit post URL on reddit.com, e.g. "https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/". The /r/<subreddit>/comments/<id>/, /user/<name>/comments/<id>/, /comments/<id>/ and /gallery/<id> forms are accepted. A link to any other site is refused as invalid input, with no charge."""
 
 
 class RedditPostCommentsInput(TypedDict, total=False):

{getanyapi-0.97.2 → getanyapi-0.98.0}/src/getanyapi/platforms/seo.py

@@ -497,9 +497,11 @@ class SeoRankedKeywordsInput(TypedDict, total=False):
     language: NotRequired[str]
     """Language code for SEO ranking metrics. Default: en."""
     limit: NotRequired[int]
-    """Maximum number of ranked keywords to return. You are billed per returned result, so a lower limit costs less. Range: 1 to 1000. Default: 10."""
+    """Maximum number of ranked keywords to return. 1,000 is the per-call maximum; use offset to fetch more. You are billed per returned result, so a lower limit costs less. Range: 1 to 1000. Default: 10."""
     location: NotRequired[int]
     """Location code for SEO ranking metrics. The default is the United States. Default: 2840."""
+    offset: NotRequired[int]
+    """Number of ranked keywords to skip in the chosen sort order. To fetch the next page, set offset to the previous offset plus limit, and keep the same orderBy, location, and language across pages. You are billed only for the keywords returned. Minimum: 0. Default: 0."""
     orderBy: NotRequired[
         Literal["position_asc", "position_desc", "volume_desc", "etv_desc"]
     ]
@@ -4136,7 +4138,8 @@ class SeoNamespace:
         """SEO Ranked Keywords
 
         Get AnyAPI SEO ranked keywords for a domain with rankings, traffic
-        estimates, volume, CPC, difficulty, and intent as normalized JSON.
+        estimates, volume, CPC, difficulty, and intent as normalized JSON. One call
+        returns up to 1,000 keywords; use offset to page further.
 
         Price: $0.01496 per request plus $0.00016 per result (maximum $0.17496).
 
@@ -4702,7 +4705,8 @@ class AsyncSeoNamespace:
         """SEO Ranked Keywords
 
         Get AnyAPI SEO ranked keywords for a domain with rankings, traffic
-        estimates, volume, CPC, difficulty, and intent as normalized JSON.
+        estimates, volume, CPC, difficulty, and intent as normalized JSON. One call
+        returns up to 1,000 keywords; use offset to page further.
 
         Price: $0.01496 per request plus $0.00016 per result (maximum $0.17496).
 

{getanyapi-0.97.2 → getanyapi-0.98.0}/src/getanyapi/platforms/tiktok.py

@@ -667,7 +667,7 @@ class TiktokVideoCommentsInput(TypedDict, total=False):
     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]
-    """Full TikTok video URL."""
+    """TikTok post URL on tiktok.com: a video or photo post (https://www.tiktok.com/@<user>/video/<id> or /photo/<id>) or a vm.tiktok.com or vt.tiktok.com short link. A profile link (https://www.tiktok.com/@<user>), a video file link (tiktokcdn.com) or a link to any other site is refused as invalid input, with no charge."""
 
 
 class TiktokVideoDownloadInput(TypedDict, total=False):