twitter-openapi-python 0.1.2__tar.gz → 0.1.3__tar.gz

{twitter_openapi_python-0.1.2 → twitter_openapi_python-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: twitter_openapi_python
-Version: 0.1.2
+Version: 0.1.3
 Summary: Twitter OpenAPI
 Keywords: twitter,api,python,scraper
 Author: fa0311
@@ -8,7 +8,7 @@ Author-email: fa0311 <yuki@yuki0311.com>
 License-Expression: LicenseRef-Custom OR AGPL-3.0-or-later
 License-File: LICENSE
 License-File: LICENSE.AGPL
-Requires-Dist: twitter-openapi-python-generated==0.1.2
+Requires-Dist: twitter-openapi-python-generated==0.1.3
 Requires-Dist: pydantic>=2.6
 Requires-Dist: requests>=2.31.0,<3.0.0
 Requires-Dist: urllib3>=2.1.0,<3.0.0

{twitter_openapi_python-0.1.2 → twitter_openapi_python-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "twitter_openapi_python"
-version = "0.1.2"
+version = "0.1.3"
 description = "Twitter OpenAPI"
 readme = "README.md"
 license = "LicenseRef-Custom OR AGPL-3.0-or-later"
@@ -16,7 +16,7 @@ keywords = [
 ]
 requires-python = ">=3.10"
 dependencies = [
-    "twitter_openapi_python_generated==0.1.2",
+    "twitter_openapi_python_generated==0.1.3",
     "pydantic>=2.6",
     "requests>=2.31.0,<3.0.0",
     "urllib3>=2.1.0,<3.0.0",

{twitter_openapi_python-0.1.2 → twitter_openapi_python-0.1.3}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "twitter_openapi_python"
-version = "0.1.2"
+version = "0.1.3"
 description = "Twitter OpenAPI"
 authors = [{ name = "fa0311", email = "yuki@yuki0311.com" }]
 readme = "README.md"
@@ -9,7 +9,7 @@ license-files = ["LICENSE", "LICENSE.AGPL"]
 keywords = ["twitter", "api", "python", "scraper"]
 requires-python = ">=3.10"
 dependencies = [
-    "twitter_openapi_python_generated==0.1.2",
+    "twitter_openapi_python_generated==0.1.3",
     "pydantic>=2.6",
     "requests>=2.31.0,<3.0.0",
     "urllib3>=2.1.0,<3.0.0",

{twitter_openapi_python-0.1.2 → twitter_openapi_python-0.1.3}/twitter_openapi_python/api/default_api.py

@@ -153,3 +153,69 @@ class DefaultApiUtils:
             key="PinnedTimelines",
             param=param,
         )
+
+    def get_broadcast_query(
+        self,
+        id: str,
+        extra_param: Optional[ParamType] = None,
+    ) -> TwitterApiUtilsResponse[models.Broadcast]:
+        """A live video broadcast by id."""
+        param: ParamType = {"id": id}
+        if extra_param is not None:
+            param.update(extra_param)
+        return self.request(
+            apiFn=self.api.get_broadcast_query_with_http_info,
+            convertFn=lambda x: error_check(x.data, x.errors).broadcast,
+            key="BroadcastQuery",
+            param=param,
+        )
+
+    def get_audio_space_by_id(
+        self,
+        id: str,
+        extra_param: Optional[ParamType] = None,
+    ) -> TwitterApiUtilsResponse[models.AudioSpace]:
+        """A Space by id: metadata, participants and the announcing post."""
+        param: ParamType = {"id": id}
+        if extra_param is not None:
+            param.update(extra_param)
+        return self.request(
+            apiFn=self.api.get_audio_space_by_id_with_http_info,
+            convertFn=lambda x: error_check(x.data, x.errors).audio_space,
+            key="AudioSpaceById",
+            param=param,
+        )
+
+    def get_use_story_topic_query(
+        self,
+        rest_id: str = "For You",
+        limit: Optional[int] = None,
+        extra_param: Optional[ParamType] = None,
+    ) -> TwitterApiUtilsResponse[models.StoryTopic]:
+        """AI-written stories of an explore topic."""
+        param: ParamType = {"rest_id": rest_id}
+        if limit is not None:
+            param["limit"] = limit
+        if extra_param is not None:
+            param.update(extra_param)
+        return self.request(
+            apiFn=self.api.get_use_story_topic_query_with_http_info,
+            convertFn=lambda x: error_check(x.data, x.errors).story_topic,
+            key="useStoryTopicQuery",
+            param=param,
+        )
+
+    def get_grok_account_jwt_query(
+        self,
+        extra_param: Optional[ParamType] = None,
+    ) -> TwitterApiUtilsResponse[models.GrokAccountJwt]:
+        """Whether the account is linked to a Grok account."""
+        param: ParamType = {}
+        if extra_param is not None:
+            param.update(extra_param)
+        return self.request(
+            apiFn=self.api.get_grok_account_jwt_query_with_http_info,
+            convertFn=lambda x: error_check(x.data, x.errors).grok_account_jwt,
+            key="grokAccountJwtQuery",
+            param=param,
+        )

{twitter_openapi_python-0.1.2 → twitter_openapi_python-0.1.3}/twitter_openapi_python/api/tweet_api.py

@@ -93,9 +93,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_search_timeline_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.search_by_raw_query, e.errors).search_timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(e.data.search_by_raw_query, e.errors).search_timeline.timeline, e.errors
+                ).instructions
+            ),
             key="SearchTimeline",
             param=param,
         )
@@ -162,9 +164,9 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_list_latest_tweets_timeline_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.list, e.errors).tweets_timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(error_check(e.data.list, e.errors).tweets_timeline.timeline, e.errors).instructions
+            ),
             key="ListLatestTweetsTimeline",
             param=param,
         )
@@ -187,9 +189,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_user_tweets_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.user, e.errors).result.timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline, e.errors
+                ).instructions
+            ),
             key="UserTweets",
             param=param,
         )
@@ -212,9 +216,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_user_originals_timeline_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.user, e.errors).result.timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline, e.errors
+                ).instructions
+            ),
             key="UserOriginalsTimeline",
             param=param,
         )
@@ -237,9 +243,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_user_replies_timeline_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.user, e.errors).result.timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline, e.errors
+                ).instructions
+            ),
             key="UserRepliesTimeline",
             param=param,
         )
@@ -262,9 +270,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_user_video_timeline_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.user, e.errors).result.timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline, e.errors
+                ).instructions
+            ),
             key="UserVideoTimeline",
             param=param,
         )
@@ -287,9 +297,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_user_tweets_and_replies_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.user, e.errors).result.timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline, e.errors
+                ).instructions
+            ),
             key="UserTweetsAndReplies",
             param=param,
         )
@@ -312,9 +324,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_user_media_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.user, e.errors).result.timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline, e.errors
+                ).instructions
+            ),
             key="UserMedia",
             param=param,
         )
@@ -337,9 +351,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_likes_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.user, e.errors).result.timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline, e.errors
+                ).instructions
+            ),
             key="Likes",
             param=param,
         )
@@ -361,9 +377,9 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_bookmarks_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data, e.errors).bookmark_timeline_v2.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(error_check(e.data, e.errors).bookmark_timeline_v2.timeline, e.errors).instructions
+            ),
             key="Bookmarks",
             param=param,
         )
@@ -389,9 +405,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_community_tweets_timeline_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data, e.errors).community_results.result.ranked_community_timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(e.data, e.errors).community_results.result.ranked_community_timeline.timeline, e.errors
+                ).instructions
+            ),
             key="CommunityTweetsTimeline",
             param=param,
         )
@@ -414,9 +432,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_community_media_timeline_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data, e.errors).community_results.result.community_media_timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(e.data, e.errors).community_results.result.community_media_timeline.timeline, e.errors
+                ).instructions
+            ),
             key="CommunityMediaTimeline",
             param=param,
         )
@@ -439,7 +459,9 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_user_highlights_tweets_with_http_info,
-            convertFn=lambda e: error_check(e.data.user, e.errors).result.timeline.timeline.instructions,
+            convertFn=lambda e: (
+                error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline.instructions
+            ),
             key="UserHighlightsTweets",
             param=param,
         )
@@ -462,9 +484,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_user_reposts_timeline_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.user, e.errors).result.timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline, e.errors
+                ).instructions
+            ),
             key="UserRepostsTimeline",
             param=param,
         )
@@ -488,9 +512,11 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_user_super_follow_tweets_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.user, e.errors).result.timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(
+                    error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline, e.errors
+                ).instructions
+            ),
             key="UserSuperFollowTweets",
             param=param,
         )
@@ -564,9 +590,9 @@ class TweetApiUtils:
             self.api.get_notifications_timeline_with_http_info,
             self.flag["NotificationsTimeline"],
             self.ct,
-            lambda e: error_check(
-                e.data.viewer_v2.user_results.result.notification_timeline.timeline, e.errors
-            ).instructions,
+            lambda e: (
+                error_check(e.data.viewer_v2.user_results.result.notification_timeline.timeline, e.errors).instructions
+            ),
             param,
             notification_entries_converter,
         )
@@ -655,9 +681,9 @@ class TweetApiUtils:
 
         response = self.request(
             apiFn=self.api.get_bookmark_search_timeline_with_http_info,
-            convertFn=lambda e: error_check(
-                e.data.search_by_raw_query.bookmarks_search_timeline.timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(e.data.search_by_raw_query.bookmarks_search_timeline.timeline, e.errors).instructions
+            ),
             key="BookmarkSearchTimeline",
             param=param,
         )

{twitter_openapi_python-0.1.2 → twitter_openapi_python-0.1.3}/twitter_openapi_python/api/user_api.py

@@ -80,6 +80,23 @@ class UserApiUtils:
             param=param,
         )
 
+    def get_about_account_query(
+        self,
+        screen_name: str,
+        extra_param: Optional[ParamType] = None,
+    ) -> TwitterApiUtilsResponse[models.AboutAccountUser]:
+        """The "About this account" panel: join date, where the account is based, username changes, verification."""
+        param: ParamType = {"screenName": screen_name}
+        if extra_param is not None:
+            param.update(extra_param)
+        return data_request(
+            self.api.get_about_account_query_with_http_info,
+            self.flag["AboutAccountQuery"],
+            self.ct,
+            lambda e: error_check(e.data, e.errors).user_result_by_screen_name.result,
+            param,
+        )
+
     def get_viewer_badge_counts(
         self,
         extra_param: Optional[ParamType] = None,

{twitter_openapi_python-0.1.2 → twitter_openapi_python-0.1.3}/twitter_openapi_python/api/user_list_api.py

@@ -66,7 +66,9 @@ class UserListApiUtils:
             param.update(extra_param)
         return self.request(
             apiFn=self.api.get_followers_with_http_info,
-            convertFn=lambda e: error_check(e.data.user, e.errors).result.timeline.timeline.instructions,
+            convertFn=lambda e: (
+                error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline.instructions
+            ),
             key="Followers",
             param=param,
         )
@@ -87,7 +89,9 @@ class UserListApiUtils:
             param.update(extra_param)
         return self.request(
             apiFn=self.api.get_following_with_http_info,
-            convertFn=lambda e: error_check(e.data.user, e.errors).result.timeline.timeline.instructions,
+            convertFn=lambda e: (
+                error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline.instructions
+            ),
             key="Following",
             param=param,
         )
@@ -108,7 +112,9 @@ class UserListApiUtils:
             param.update(extra_param)
         return self.request(
             apiFn=self.api.get_followers_you_know_with_http_info,
-            convertFn=lambda e: error_check(e.data.user, e.errors).result.timeline.timeline.instructions,
+            convertFn=lambda e: (
+                error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline.instructions
+            ),
             key="FollowersYouKnow",
             param=param,
         )
@@ -129,9 +135,9 @@ class UserListApiUtils:
             param.update(extra_param)
         return self.request(
             apiFn=self.api.get_favoriters_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.favoriters_timeline, e.errors).timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(error_check(e.data.favoriters_timeline, e.errors).timeline, e.errors).instructions
+            ),
             key="Favoriters",
             param=param,
         )
@@ -152,9 +158,9 @@ class UserListApiUtils:
             param.update(extra_param)
         return self.request(
             apiFn=self.api.get_retweeters_with_http_info,
-            convertFn=lambda e: error_check(
-                error_check(e.data.retweeters_timeline, e.errors).timeline, e.errors
-            ).instructions,
+            convertFn=lambda e: (
+                error_check(error_check(e.data.retweeters_timeline, e.errors).timeline, e.errors).instructions
+            ),
             key="Retweeters",
             param=param,
         )
@@ -175,7 +181,9 @@ class UserListApiUtils:
             param.update(extra_param)
         return self.request(
             apiFn=self.api.get_blue_verified_followers_with_http_info,
-            convertFn=lambda e: error_check(e.data.user, e.errors).result.timeline.timeline.instructions,
+            convertFn=lambda e: (
+                error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline.instructions
+            ),
             key="BlueVerifiedFollowers",
             param=param,
         )
@@ -282,7 +290,11 @@ class UserListApiUtils:
             self.api.get_list_ownerships_with_http_info,
             self.flag["ListOwnerships"],
             self.ct,
-            lambda e: error_check(error_check(e.data.user, e.errors).result.timeline.timeline, e.errors).instructions,
+            lambda e: (
+                error_check(
+                    error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline, e.errors
+                ).instructions
+            ),
             param,
             list_entries_converter,
         )
@@ -345,7 +357,11 @@ class UserListApiUtils:
             self.api.get_combined_lists_with_http_info,
             self.flag["CombinedLists"],
             self.ct,
-            lambda e: error_check(error_check(e.data.user, e.errors).result.timeline.timeline, e.errors).instructions,
+            lambda e: (
+                error_check(
+                    error_check(error_check(e.data.user, e.errors).result.timeline, e.errors).timeline, e.errors
+                ).instructions
+            ),
             param,
             list_entries_converter,
         )

{twitter_openapi_python-0.1.2 → twitter_openapi_python-0.1.3}/twitter_openapi_python/api/users_api.py

@@ -72,3 +72,20 @@ class UsersApiUtils:
             lambda e: [x.result for x in error_check(e.data, e.errors).users_results],
             param,
         )
+
+    def get_sidebar_user_recommendations(
+        self,
+        profile_user_id: str,
+        extra_param: Optional[ParamType] = None,
+    ) -> TwitterApiUtilsResponse[list[models.SidebarUserRecommendation]]:
+        """Who to follow, shown in the sidebar of a profile, each with its recommendation token."""
+        param: ParamType = {"profileUserId": profile_user_id}
+        if extra_param is not None:
+            param.update(extra_param)
+        return data_request(
+            self.api.get_sidebar_user_recommendations_with_http_info,
+            self.flag["SidebarUserRecommendations"],
+            self.ct,
+            lambda e: error_check(e.data, e.errors).sidebar_user_recommendations,
+            param,
+        )

{twitter_openapi_python-0.1.2 → twitter_openapi_python-0.1.3}/twitter_openapi_python/client.py

@@ -69,7 +69,7 @@ class TwitterOpenapiPythonClient:
 
 
 class TwitterOpenapiPython:
-    hash: str = "127fa210d7f9b0252276c86a1860a7db816d9d69"
+    hash: str = "82d12f1e93e93cd283534f6abb4102bf7dc31c74"
     placeholder_url = "https://raw.githubusercontent.com/fa0311/twitter-openapi/{hash}/src/config/placeholder.json"
     header = "https://raw.githubusercontent.com/fa0311/latest-user-agent/refs/heads/main/header.json"
     access_token: str = (