getanyapi 0.7.0__tar.gz → 0.8.0__tar.gz

{getanyapi-0.7.0 → getanyapi-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: getanyapi
-Version: 0.7.0
+Version: 0.8.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.7.0 → getanyapi-0.8.0}/pyproject.toml

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

{getanyapi-0.7.0 → getanyapi-0.8.0}/src/getanyapi/__init__.py

@@ -49,7 +49,7 @@ from .types import (
     unwrap,
 )
 
-__version__ = "0.7.0"
+__version__ = "0.8.0"
 
 __all__ = [
     # clients + top-level functions

{getanyapi-0.7.0 → getanyapi-0.8.0}/src/getanyapi/platforms/twitter.py

@@ -108,17 +108,26 @@ class TwitterTweetTranscriptInput(TypedDict, total=False):
     """Tweet URL of the video to transcribe (e.g. https://x.com/TheoVon/status/1916982720317821050)."""
 
 
+class TwitterUserPostsInput(TypedDict, total=False):
+    """Input for X / Twitter User Posts."""
+
+    cursor: NotRequired[str]
+    """Opaque pagination cursor from a previous response's nextCursor. Omit for the first page."""
+    handle: Required[str]
+    """Twitter/X handle without the leading @."""
+
+
 class TwitterUserTweetsInput(TypedDict, total=False):
-    """Input for Twitter User Tweets."""
+    """Input for X / Twitter User Tweets and Replies."""
 
     cursor: NotRequired[str]
-    """Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of tweets."""
+    """Reserved for cursor-capable lanes. The current bulk lane returns nextCursor as null, so omit this field."""
     handle: Required[str]
     """Twitter/X handle without the leading @."""
     limit: NotRequired[int]
-    """Per-page maximum number of tweets to return (1-1000), newest first. A provider may return a smaller native page of approximately 20; follow nextCursor for more. With requireSinglePage true, up to this many are returned in one (pricier) call. Range: 1 to 1000. Default: 20."""
+    """Maximum number of authored tweets and replies to return in the current bulk call (1-1000). The provider may return fewer results. Range: 1 to 1000. Default: 20."""
     requireSinglePage: NotRequired[bool]
-    """Set true to get up to limit tweets in a single response instead of cheap pages, served by a bulk provider at a higher price."""
+    """Compatibility flag for requiring one response. The current lane already returns up to limit results in one bulk call, whether this is omitted or true."""
 
 
 class TwitterCommunityData(BaseModel):
@@ -408,13 +417,61 @@ class TwitterTweetTranscriptData(BaseModel):
     transcript: str
 
 
+class TwitterUserPostsData(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    next_cursor: str = Field(
+        alias="nextCursor",
+        description="Opaque cursor for the next native Posts-tab page, or null when no more pages are available.",
+    )
+    tweets: list[TwitterUserPostsTweet] = Field(
+        description="Posts in profile order. A pinned post may appear before otherwise reverse-chronological results. Populated whenever the provider has data for the entity."
+    )
+
+
+class TwitterUserPostsTweet(BaseModel):
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    bookmarks: int = Field(description="Number of bookmarks.")
+    created_utc: float = Field(
+        alias="createdUtc",
+        description="UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.",
+    )
+    id: str = Field(
+        description="The post's numeric tweet ID, represented as a string. Populated whenever the provider has data for the entity."
+    )
+    is_pinned: bool = Field(
+        alias="isPinned",
+        description="Whether X marks the post as pinned on the profile.",
+    )
+    is_reply: bool | None = Field(
+        default=None,
+        alias="isReply",
+        description="Whether X marks the record as a reply. Certified Posts-tab captures use this for self-thread continuations.",
+    )
+    lang: str | None = Field(
+        default=None, description="Language code reported for the post, when available."
+    )
+    likes: int = Field(description="Number of likes.")
+    quotes: int | None = Field(default=None, description="Number of quote posts.")
+    replies: int = Field(description="Number of replies.")
+    retweets: int = Field(description="Number of reposts or retweets.")
+    text: str = Field(
+        description="The post text. Empty for media-only posts. Populated whenever the provider has data for the entity."
+    )
+    url: str = Field(
+        description="Canonical x.com URL of the post. Populated whenever the provider has data for the entity."
+    )
+    views: int = Field(description="Number of views.")
+
+
 class TwitterUserTweetsData(BaseModel):
     model_config = ConfigDict(populate_by_name=True)
 
     next_cursor: str | None = Field(
         default=None,
         alias="nextCursor",
-        description="Opaque cursor for the next page of tweets, or null when this lane has no more. Pass it back as cursor to continue.",
+        description="Reserved pagination cursor. The current bulk lane returns null; cursor-capable lanes may return an opaque continuation value in the future.",
     )
     tweets: list[TwitterUserTweetsTweet] = Field(
         description="Populated whenever the provider has data for the entity."
@@ -720,20 +777,66 @@ class TwitterNamespace:
         )
         return RunResult[TwitterTweetTranscriptData].model_validate(raw)
 
+    def user_posts(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TwitterUserPostsInput],
+    ) -> RunResult[TwitterUserPostsData]:
+        """X / Twitter User Posts
+
+        Get an X (Twitter) account's profile Posts-tab timeline by handle. Results
+        follow profile order: a pinned post may appear first, followed by otherwise
+        reverse-chronological authored posts, reposts, quotes, and self-thread
+        continuations.
+
+        Price: $0.00075 per request.
+
+        Example:
+            res = client.twitter.user_posts(handle="levelsio")
+        """
+        raw = self._client._run_raw(  # pyright: ignore[reportPrivateUsage]
+            "twitter.user_posts", dict(input), options
+        )
+        return RunResult[TwitterUserPostsData].model_validate(raw)
+
+    def iter_user_posts(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TwitterUserPostsInput],
+    ) -> Paginator[TwitterUserPostsTweet, TwitterUserPostsData]:
+        """Iterate X / Twitter User Posts results, following pagination cursors.
+
+        Yields validated `TwitterUserPostsTweet` items from the `tweets` field of
+        each page. Use `.pages()` on the returned paginator to walk whole
+        `RunResult` pages.
+        """
+        return paginate(
+            self._client,
+            "twitter.user_posts",
+            dict(input),
+            "tweets",
+            item_model=TwitterUserPostsTweet,
+            data_model=TwitterUserPostsData,
+            bare=False,
+            options=options,
+        )
+
     def user_tweets(
         self,
         *,
         options: RequestOptions | None = None,
         **input: Unpack[TwitterUserTweetsInput],
     ) -> RunResult[TwitterUserTweetsData]:
-        """Twitter User Tweets
+        """X / Twitter User Tweets and Replies
 
-        Get an X (Twitter) account's latest tweets by handle, newest first
-        (reverse-chronological, replies included), with engagement, views, language,
-        and cursor pagination. Limit is a per-page maximum; native pages contain
-        approximately 20 tweets unless requireSinglePage selects a bulk lane.
+        Get up to the requested limit of tweets and replies authored by an X
+        (Twitter) account in one bulk call, with engagement, views, and language.
+        The current lane returns nextCursor as null; cursor is reserved for future
+        cursor-capable lanes.
 
-        Price: $0.00075 per request.
+        Price: $0 per request plus $0.0002 per result (maximum $0.2).
 
         Example:
             res = client.twitter.user_tweets(handle="levelsio", limit=20)
@@ -749,7 +852,7 @@ class TwitterNamespace:
         options: RequestOptions | None = None,
         **input: Unpack[TwitterUserTweetsInput],
     ) -> Paginator[TwitterUserTweetsTweet, TwitterUserTweetsData]:
-        """Iterate Twitter User Tweets results, following pagination cursors.
+        """Iterate X / Twitter User Tweets and Replies results, following pagination cursors.
 
         Yields validated `TwitterUserTweetsTweet` items from the `tweets` field of
         each page. Use `.pages()` on the returned paginator to walk whole
@@ -1039,20 +1142,66 @@ class AsyncTwitterNamespace:
         )
         return RunResult[TwitterTweetTranscriptData].model_validate(raw)
 
+    async def user_posts(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TwitterUserPostsInput],
+    ) -> RunResult[TwitterUserPostsData]:
+        """X / Twitter User Posts
+
+        Get an X (Twitter) account's profile Posts-tab timeline by handle. Results
+        follow profile order: a pinned post may appear first, followed by otherwise
+        reverse-chronological authored posts, reposts, quotes, and self-thread
+        continuations.
+
+        Price: $0.00075 per request.
+
+        Example:
+            res = client.twitter.user_posts(handle="levelsio")
+        """
+        raw = await self._client._arun_raw(  # pyright: ignore[reportPrivateUsage]
+            "twitter.user_posts", dict(input), options
+        )
+        return RunResult[TwitterUserPostsData].model_validate(raw)
+
+    def iter_user_posts(
+        self,
+        *,
+        options: RequestOptions | None = None,
+        **input: Unpack[TwitterUserPostsInput],
+    ) -> AsyncPaginator[TwitterUserPostsTweet, TwitterUserPostsData]:
+        """Iterate X / Twitter User Posts results, following pagination cursors.
+
+        Yields validated `TwitterUserPostsTweet` items from the `tweets` field of
+        each page. Use `.pages()` on the returned paginator to walk whole
+        `RunResult` pages.
+        """
+        return apaginate(
+            self._client,
+            "twitter.user_posts",
+            dict(input),
+            "tweets",
+            item_model=TwitterUserPostsTweet,
+            data_model=TwitterUserPostsData,
+            bare=False,
+            options=options,
+        )
+
     async def user_tweets(
         self,
         *,
         options: RequestOptions | None = None,
         **input: Unpack[TwitterUserTweetsInput],
     ) -> RunResult[TwitterUserTweetsData]:
-        """Twitter User Tweets
+        """X / Twitter User Tweets and Replies
 
-        Get an X (Twitter) account's latest tweets by handle, newest first
-        (reverse-chronological, replies included), with engagement, views, language,
-        and cursor pagination. Limit is a per-page maximum; native pages contain
-        approximately 20 tweets unless requireSinglePage selects a bulk lane.
+        Get up to the requested limit of tweets and replies authored by an X
+        (Twitter) account in one bulk call, with engagement, views, and language.
+        The current lane returns nextCursor as null; cursor is reserved for future
+        cursor-capable lanes.
 
-        Price: $0.00075 per request.
+        Price: $0 per request plus $0.0002 per result (maximum $0.2).
 
         Example:
             res = client.twitter.user_tweets(handle="levelsio", limit=20)
@@ -1068,7 +1217,7 @@ class AsyncTwitterNamespace:
         options: RequestOptions | None = None,
         **input: Unpack[TwitterUserTweetsInput],
     ) -> AsyncPaginator[TwitterUserTweetsTweet, TwitterUserTweetsData]:
-        """Iterate Twitter User Tweets results, following pagination cursors.
+        """Iterate X / Twitter User Tweets and Replies results, following pagination cursors.
 
         Yields validated `TwitterUserTweetsTweet` items from the `tweets` field of
         each page. Use `.pages()` on the returned paginator to walk whole