tweepy-self 1.10.0b8__py3-none-any.whl → 1.11.0__py3-none-any.whl

{tweepy_self-1.10.0b8.dist-info → tweepy_self-1.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tweepy-self
-Version: 1.10.0b8
+Version: 1.11.0
 Summary: Twitter (selfbot) for Python!
 Home-page: https://github.com/alenkimov/tweepy-self
 Author: Alen
@@ -32,12 +32,19 @@ Description-Content-Type: text/markdown
 
 A modern, easy to use, feature-rich, and async ready API wrapper for Twitter's user API written in Python.
 
+_NEW!_ Менеджер аккаунтов с базой данных:
+- [tweepy-manager](https://github.com/alenkimov/tweepy-manager)
+
 More libraries of the family:
 - [better-proxy](https://github.com/alenkimov/better_proxy)
 - [better-web3](https://github.com/alenkimov/better_web3)
 
 Отдельное спасибо [Кузнице Ботов](https://t.me/bots_forge) за код для авторизации и разморозки! Подписывайтесь на их Telegram :)
 
+Похожие библиотеки:
+- [twikit (sync and async)](https://github.com/d60/twikit)
+- [twitter-api-client (sync)](https://github.com/trevorhobenshield/twitter-api-client)
+
 ## Key Features
 - Modern Pythonic API using async and await.
 - Prevents user account automation detection.
@@ -84,7 +91,9 @@ logger.enable("twitter")
 `level="DEBUG"` позволяет увидеть информацию обо всех запросах.
 
 ### Аккаунт
-После любого взаимодействия с Twitter устанавливается статус аккаунта:
+`twitter.Account`
+
+#### Статусы аккаунта
 - `UNKNOWN` - Статус аккаунта не установлен. Это статус по умолчанию.
 - `BAD_TOKEN` - Неверный или мертвый токен.
 - `SUSPENDED` - Действие учетной записи приостановлено. Тем не менее возможен запрос данных, а также авторизация через OAuth и OAuth2.
@@ -92,18 +101,23 @@ logger.enable("twitter")
 - `CONSENT_LOCKED` - Учетная запись заморожена (лок). Условия для разморозки неизвестны.
 - `GOOD` - Аккаунт в порядке.
 
+Метод `Client.establish_status()` устанавливает статус аккаунта.
+Также статус аккаунта может изменить любое взаимодействие с Twitter.
+Поэтому, во время работы может внезапно быть вызвано исключение семейства `twitter.errors.BadAccount`.
+
 Не каждое взаимодействие с Twitter достоверно определяет статус аккаунта.
-Например, простой запрос данных об аккаунте честно вернет данные, даже если действие вашей учетной записи приостановлено.
+Например, простой запрос данных об аккаунте честно вернет данные и не изменит статус, даже если действие вашей учетной записи приостановлено (`SUSPENDED`).
 
-Для достоверной установки статуса аккаунта используйте метод `Client.establish_status()`
+### Клиент
+`twitter.Client`
 
-### Настройка клиента
-Класс `twitter.Client` может быть сконфигурирован перед работой. Он принимает в себя следующие параметры:
+#### Настройка
+Клиент может быть сконфигурирован перед работой. Он принимает в себя следующие параметры:
 - `wait_on_rate_limit` Если включено, то при достижении Rate Limit будет ждать, вместо того, чтобы выбрасывать исключение. Включено по умолчанию.
 - `capsolver_api_key` API ключ сервиса [CapSolver](https://dashboard.capsolver.com/passport/register?inviteCode=m-aE3NeBGZLU). Нужен для автоматической разморозки аккаунта.
 - `max_unlock_attempts` Максимальное количество попыток разморозки аккаунта. По умолчанию: 5.
 - `auto_relogin` Если включено, то при невалидном токене (`BAD_TOKEN`) и предоставленных данных для авторизации (имя пользователя, пароль и totp_secret) будет произведен автоматический релогин (замена токена). Включено по умолчанию.
-- `update_account_info_on_startup` Если включено, то на старте будет автоматически запрошена информация об аккаунте. Включено по умолчанию.
+- `update_account_info_on_startup` Если включено, то на старте будет автоматически запрошена информация об аккаунте, а также установлен его статус. Включено по умолчанию.
 - `**session_kwargs` Любые параметры, которые может принимать сессия `curl_cffi.requests.AsyncSession`. Например, можно передать параметр `proxy`.
 
 Пример настройки клиента:

{tweepy_self-1.10.0b8.dist-info → tweepy_self-1.11.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-twitter/__init__.py,sha256=-CmcPdm1z-OkG8LkJVe75PwdYKBqBfMpD9WdoXcnGuc,732
+twitter/__init__.py,sha256=yqTUBTKJca19jJBtmv9CML9Lfgvw1yjNew7i0f5v80Y,745
 twitter/_capsolver/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 twitter/_capsolver/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 twitter/_capsolver/core/base.py,sha256=In3qDLgRh1z1UZLaLFgYcDEdnqW3d62PVzgEjU2S4BU,8883
@@ -10,14 +10,14 @@ twitter/account.py,sha256=joAB5Zw-Le5E3kOZ-1nb4DPGlTqWYv2Vs6gJ3cwu7is,3175
 twitter/base/__init__.py,sha256=Q2ko0HeOS5tiBnDVKxxaZYetwRR3YXJ67ujL3oThGd4,141
 twitter/base/client.py,sha256=J_iL4ZGfwTbZ2gpjtFCbBxNgt7weJ55EeMGzYsLtjf4,500
 twitter/base/session.py,sha256=JFPS-9Qae1iY3NfNcywxvWWmRDijaU_Rjs3WaQ00iFA,2071
-twitter/client.py,sha256=3eCld11wiZPOKF561RlTcJ_Re-lupvGSPz7MPKrJl1k,75103
-twitter/enums.py,sha256=-OH6Ibxarq5qt4E2AhkProVawcEyIf5YG_h_G5xiV9Y,270
-twitter/errors.py,sha256=oNa0Neos80ZK4-0FBzqgxXonH564qFnoN-kavHalfR4,5274
-twitter/models.py,sha256=CrGb3dvA0U4PfPTkUtuprPKXpqkLpM8AR_-De4D3efM,5677
+twitter/client.py,sha256=WQFcwt9RA4LSgF0iRFLOy5-bJepyb2vLWLMX1iS2k9s,82317
+twitter/enums.py,sha256=RzQnvxEmMwGVTHZ7e3P3kAE6U9btvNZ3cqVMi7y9ItI,299
+twitter/errors.py,sha256=xYuwU8F-_XDGWOLvLUAT_U3sO1ZJOPQ7uOhe-SBo6vY,5610
+twitter/models.py,sha256=HuiZItosr1FibjkHNWZeIsEe9K52o7OBiBuvoNu0Rxc,5905
 twitter/utils/__init__.py,sha256=usxpfcRQ7zxTTgZ-i425tT7hIz73Pwh9FDj4t6O3dYg,663
 twitter/utils/file.py,sha256=Sz2KEF9DnL04aOP1XabuMYMMF4VR8dJ_KWMEVvQ666Y,1120
 twitter/utils/html.py,sha256=nrOJw0vUKfBaHgFaQSQIdXfvfZ8mdu84MU_s46kJTJ4,2087
 twitter/utils/other.py,sha256=9RIYF2AMdmNKIwClG3jBP7zlvxZPEgYfuHaIiOhURzM,1061
-tweepy_self-1.10.0b8.dist-info/METADATA,sha256=gghI1xBSOt1w8QajiIFg6H93LAydql3haQ3tk0YghoU,13153
-tweepy_self-1.10.0b8.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-tweepy_self-1.10.0b8.dist-info/RECORD,,
+tweepy_self-1.11.0.dist-info/METADATA,sha256=WKDAyHV76Ewun0b94z7dRHet4iLp8O5YWXWP31euv28,13754
+tweepy_self-1.11.0.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+tweepy_self-1.11.0.dist-info/RECORD,,

twitter/__init__.py

@@ -2,7 +2,7 @@
 Twitter API Wrapper
 ~~~~~~~~~~~~~~~~~~~
 
-A basic wrapper for the Twitter user API.
+A Python library for interacting with the Twitter API.
 """
 
 from .client import Client

twitter/client.py

@@ -22,12 +22,12 @@ from .errors import (
     RateLimited,
     ServerError,
     BadAccount,
-    BadToken,
-    Locked,
-    ConsentLocked,
-    Suspended,
+    BadAccountToken,
+    AccountLocked,
+    AccountConsentLocked,
+    AccountSuspended,
+    AccountNotFound,
 )
-from .utils import to_json
 from .base import BaseHTTPClient
 from .account import Account, AccountStatus
 from .models import User, Tweet, Media, Subtask
@@ -95,6 +95,8 @@ class Client(BaseHTTPClient):
         self.auto_relogin = auto_relogin
         self._update_account_info_on_startup = update_account_info_on_startup
 
+        self.gql = GQLClient(self)
+
     async def __aenter__(self):
         await self.on_startup()
         return await super().__aenter__()
@@ -114,16 +116,21 @@ class Client(BaseHTTPClient):
 
         if bearer:
             headers["authorization"] = f"Bearer {self._BEARER_TOKEN}"
-            # headers["x-twitter-auth-type"] = "OAuth2Session"
 
         if auth:
             if not self.account.auth_token:
                 raise ValueError("No auth_token. Login before")
 
             cookies["auth_token"] = self.account.auth_token
+            headers["x-twitter-auth-type"] = "OAuth2Session"
             if self.account.ct0:
                 cookies["ct0"] = self.account.ct0
                 headers["x-csrf-token"] = self.account.ct0
+        else:
+            if "auth_token" in cookies:
+                del cookies["auth_token"]
+            if "x-twitter-auth-type" in headers:
+                del headers["x-twitter-auth-type"]
 
         # fmt: off
         log_message = (f"(auth_token={self.account.hidden_auth_token}, id={self.account.id}, username={self.account.username})"
@@ -172,9 +179,9 @@ class Client(BaseHTTPClient):
             if isinstance(data, dict) and "errors" in data:
                 exc = HTTPException(response, data)
 
-                if 141 in exc.api_codes:
+                if 141 in exc.api_codes or 37 in exc.api_codes:
                     self.account.status = AccountStatus.SUSPENDED
-                    raise Suspended(exc, self.account)
+                    raise AccountSuspended(exc, self.account)
 
                 if 326 in exc.api_codes:
                     for error_data in exc.api_errors:
@@ -184,23 +191,29 @@ class Client(BaseHTTPClient):
                             == "/i/flow/consent_flow"
                         ):
                             self.account.status = AccountStatus.CONSENT_LOCKED
-                            raise ConsentLocked(exc, self.account)
+                            raise AccountConsentLocked(exc, self.account)
 
                     self.account.status = AccountStatus.LOCKED
-                    raise Locked(exc, self.account)
+                    raise AccountLocked(exc, self.account)
                 raise exc
 
             return response, data
 
         if response.status_code == 400:
-            raise BadRequest(response, data)
+            exc = BadRequest(response, data)
+
+            if 399 in exc.api_codes:
+                self.account.status = AccountStatus.NOT_FOUND
+                raise AccountNotFound(exc, self.account)
+
+            raise exc
 
         if response.status_code == 401:
             exc = Unauthorized(response, data)
 
             if 32 in exc.api_codes:
                 self.account.status = AccountStatus.BAD_TOKEN
-                raise BadToken(exc, self.account)
+                raise BadAccountToken(exc, self.account)
 
             raise exc
 
@@ -209,7 +222,7 @@ class Client(BaseHTTPClient):
 
             if 64 in exc.api_codes:
                 self.account.status = AccountStatus.SUSPENDED
-                raise Suspended(exc, self.account)
+                raise AccountSuspended(exc, self.account)
 
             if 326 in exc.api_codes:
                 for error_data in exc.api_errors:
@@ -218,10 +231,10 @@ class Client(BaseHTTPClient):
                         and error_data.get("bounce_location") == "/i/flow/consent_flow"
                     ):
                         self.account.status = AccountStatus.CONSENT_LOCKED
-                        raise ConsentLocked(exc, self.account)
+                        raise AccountConsentLocked(exc, self.account)
 
                 self.account.status = AccountStatus.LOCKED
-                raise Locked(exc, self.account)
+                raise AccountLocked(exc, self.account)
 
             raise exc
 
@@ -261,19 +274,20 @@ class Client(BaseHTTPClient):
         *,
         auto_unlock: bool = True,
         auto_relogin: bool = None,
+        rerequest_on_bad_ct0: bool = True,
         **kwargs,
     ) -> tuple[requests.Response, Any]:
         try:
             return await self._request(method, url, **kwargs)
 
-        except Locked:
+        except AccountLocked:
             if not self.capsolver_api_key or not auto_unlock:
                 raise
 
             await self.unlock()
             return await self._request(method, url, **kwargs)
 
-        except BadToken:
+        except BadAccountToken:
             if auto_relogin is None:
                 auto_relogin = self.auto_relogin
             if (
@@ -284,11 +298,17 @@ class Client(BaseHTTPClient):
                 raise
 
             await self.relogin()
-            return await self._request(method, url, **kwargs)
+            return await self.request(method, url, auto_relogin=False, **kwargs)
 
         except Forbidden as exc:
-            if 353 in exc.api_codes and "ct0" in exc.response.cookies:
-                return await self.request(method, url, **kwargs)
+            if (
+                rerequest_on_bad_ct0
+                and 353 in exc.api_codes
+                and "ct0" in exc.response.cookies
+            ):
+                return await self.request(
+                    method, url, rerequest_on_bad_ct0=False, **kwargs
+                )
             else:
                 raise
 
@@ -447,9 +467,9 @@ class Client(BaseHTTPClient):
             "withAuxiliaryUserLabels": False,
         }
         params = {
-            "variables": to_json(variables),
-            "features": to_json(features),
-            "fieldToggles": to_json(field_toggles),
+            "variables": variables,
+            "features": features,
+            "fieldToggles": field_toggles,
         }
         response, data = await self.request("GET", url, params=params)
         if not data["data"]:
@@ -915,8 +935,8 @@ class Client(BaseHTTPClient):
             "responsive_web_enhance_cards_enabled": False,
         }
         params = {
-            "variables": to_json(variables),
-            "features": to_json(features),
+            "variables": variables,
+            "features": features,
         }
         response, response_json = await self.request("GET", url, params=params)
 
@@ -1008,8 +1028,8 @@ class Client(BaseHTTPClient):
             "responsive_web_enhance_cards_enabled": False,
         }
         query = {
-            "variables": to_json(variables),
-            "features": to_json(features),
+            "variables": variables,
+            "features": features,
         }
         response, data = await self.request("GET", url, params=query)
         instructions = data["data"]["threaded_conversation_with_injections_v2"]["instructions"]  # type: ignore
@@ -1053,7 +1073,7 @@ class Client(BaseHTTPClient):
             "responsive_web_media_download_video_enabled": False,
             "responsive_web_enhance_cards_enabled": False,
         }
-        params = {"variables": to_json(variables), "features": to_json(features)}
+        params = {"variables": variables, "features": features}
         response, data = await self.request("GET", url, params=params)
 
         instructions = data["data"]["user"]["result"]["timeline_v2"]["timeline"][
@@ -1633,12 +1653,12 @@ class Client(BaseHTTPClient):
 
         :return: guest_token
         """
-        url = "https://twitter.com"
-        response = await self._session.request("GET", url)
-        # TODO Если в сессии есть рабочий auth_token, то не вернет нужную страницу.
-        #   Поэтому нужно очищать сессию перед вызовом этого метода.
-        guest_token = re.search(r"gt\s?=\s?\d+", response.text)[0].split("=")[1]
-        return guest_token
+        response, data = await self._request(
+            "POST",
+            "https://api.twitter.com/1.1/guest/activate.json",
+            auth=False,
+        )
+        return data["guest_token"]
 
     async def _login(self) -> bool:
         update_backup_code = False
@@ -1658,28 +1678,37 @@ class Client(BaseHTTPClient):
         flow_token, subtasks = await self._login_enter_password(flow_token)
         flow_token, subtasks = await self._account_duplication_check(flow_token)
 
-        subtask_ids = {subtask.id for subtask in subtasks}
-        if "LoginAcid" in subtask_ids:
-            if not self.account.email:
-                raise TwitterException(
-                    f"Failed to login. Task id: LoginAcid. No email!"
-                )
-
-            try:
-                # fmt: off
-                flow_token, subtasks = await self._login_acid(flow_token, self.account.email)
-                # fmt: on
-            except HTTPException as exc:
-                if 399 in exc.api_codes:
-                    logger.warning(
-                        f"(auth_token={self.account.hidden_auth_token}, id={self.account.id}, username={self.account.username})"
-                        f" Bad email!"
+        for subtask in subtasks:
+            if subtask.id == "LoginAcid":
+                if not self.account.email:
+                    raise TwitterException(
+                        f"Failed to login. Task id: LoginAcid." f" No email!"
                     )
+
+                if subtask.primary_text == "Check your email":
                     raise TwitterException(
-                        f"Failed to login. Task id: LoginAcid. Bad email!"
+                        f"Failed to login. Task id: LoginAcid."
+                        f" Email verification required!"
+                        f" No IMAP handler for this version of library :<"
                     )
-                else:
-                    raise
+
+                try:
+                    # fmt: off
+                    flow_token, subtasks = await self._login_acid(flow_token, self.account.email)
+                    # fmt: on
+                except HTTPException as exc:
+                    if 399 in exc.api_codes:
+                        logger.warning(
+                            f"(auth_token={self.account.hidden_auth_token}, id={self.account.id}, username={self.account.username})"
+                            f" Bad email!"
+                        )
+                        raise TwitterException(
+                            f"Failed to login. Task id: LoginAcid. Bad email!"
+                        )
+                    else:
+                        raise
+
+        subtask_ids = {subtask.id for subtask in subtasks}
 
         if "LoginTwoFactorAuthChallenge" in subtask_ids:
             if not self.account.totp_secret:
@@ -1917,3 +1946,148 @@ class Client(BaseHTTPClient):
             raise ValueError("Password required to enable TOTP")
 
         await self._enable_totp()
+
+
+class GQLClient:
+    _GRAPHQL_URL = "https://twitter.com/i/api/graphql"
+    _OPERATION_TO_QUERY_ID = {
+        "CreateRetweet": "ojPdsZsimiJrUGLR1sjUtA",
+        "FavoriteTweet": "lI07N6Otwv1PhnEgXILM7A",
+        "UnfavoriteTweet": "ZYKSe-w7KEslx3JhSIk5LA",
+        "CreateTweet": "v0en1yVV-Ybeek8ClmXwYw",
+        "TweetResultByRestId": "V3vfsYzNEyD9tsf4xoFRgw",
+        "ModerateTweet": "p'jF:GVqCjTcZol0xcBJjw",
+        "DeleteTweet": "VaenaVgh5q5ih7kvyVjgtg",
+        "UserTweets": "V1ze5q3ijDS1VeLwLY0m7g",
+        "TweetDetail": "VWFGPVAGkZMGRKGe3GFFnA",
+        "ProfileSpotlightsQuery": "9zwVLJ48lmVUk8u_Gh9DmA",
+        "Following": "t-BPOrMIduGUJWO_LxcvNQ",
+        "Followers": "3yX7xr2hKjcZYnXt6cU6lQ",
+        "UserByScreenName": "G3KGOASz96M-Qu0nwmGXNg",
+        "UsersByRestIds": "itEhGywpgX9b3GJCzOtSrA",
+        "Viewer": "W62NnYgkgziw9bwyoVht0g",
+    }
+    _DEFAULT_VARIABLES = {
+        "count": 1000,
+        "withSafetyModeUserFields": True,
+        "includePromotedContent": True,
+        "withQuickPromoteEligibilityTweetFields": True,
+        "withVoice": True,
+        "withV2Timeline": True,
+        "withDownvotePerspective": False,
+        "withBirdwatchNotes": True,
+        "withCommunity": True,
+        "withSuperFollowsUserFields": True,
+        "withReactionsMetadata": False,
+        "withReactionsPerspective": False,
+        "withSuperFollowsTweetFields": True,
+        "isMetatagsQuery": False,
+        "withReplays": True,
+        "withClientEventToken": False,
+        "withAttachments": True,
+        "withConversationQueryHighlights": True,
+        "withMessageQueryHighlights": True,
+        "withMessages": True,
+    }
+    _DEFAULT_FEATURES = {
+        "c9s_tweet_anatomy_moderator_badge_enabled": True,
+        "responsive_web_home_pinned_timelines_enabled": True,
+        "blue_business_profile_image_shape_enabled": True,
+        "creator_subscriptions_tweet_preview_api_enabled": True,
+        "freedom_of_speech_not_reach_fetch_enabled": True,
+        "graphql_is_translatable_rweb_tweet_is_translatable_enabled": True,
+        "graphql_timeline_v2_bookmark_timeline": True,
+        "hidden_profile_likes_enabled": True,
+        "highlights_tweets_tab_ui_enabled": True,
+        "interactive_text_enabled": True,
+        "longform_notetweets_consumption_enabled": True,
+        "longform_notetweets_inline_media_enabled": True,
+        "longform_notetweets_rich_text_read_enabled": True,
+        "longform_notetweets_richtext_consumption_enabled": True,
+        "profile_foundations_tweet_stats_enabled": True,
+        "profile_foundations_tweet_stats_tweet_frequency": True,
+        "responsive_web_birdwatch_note_limit_enabled": True,
+        "responsive_web_edit_tweet_api_enabled": True,
+        "responsive_web_enhance_cards_enabled": False,
+        "responsive_web_graphql_exclude_directive_enabled": True,
+        "responsive_web_graphql_skip_user_profile_image_extensions_enabled": False,
+        "responsive_web_graphql_timeline_navigation_enabled": True,
+        "responsive_web_media_download_video_enabled": False,
+        "responsive_web_text_conversations_enabled": False,
+        "responsive_web_twitter_article_data_v2_enabled": True,
+        "responsive_web_twitter_article_tweet_consumption_enabled": False,
+        "responsive_web_twitter_blue_verified_badge_is_enabled": True,
+        "rweb_lists_timeline_redesign_enabled": True,
+        "spaces_2022_h2_clipping": True,
+        "spaces_2022_h2_spaces_communities": True,
+        "standardized_nudges_misinfo": True,
+        "subscriptions_verification_info_verified_since_enabled": True,
+        "tweet_awards_web_tipping_enabled": False,
+        "tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled": True,
+        "tweetypie_unmention_optimization_enabled": True,
+        "verified_phone_label_enabled": False,
+        "vibe_api_enabled": True,
+        "view_counts_everywhere_api_enabled": True,
+        "hidden_profile_subscriptions_enabled": True,
+        "subscriptions_verification_info_is_identity_verified_enabled": True,
+    }
+
+    @classmethod
+    def _operation_to_url(cls, operation: str) -> tuple[str, str]:
+        """
+        :return: URL and Query ID
+        """
+        query_id = cls._OPERATION_TO_QUERY_ID[operation]
+        url = f"{cls._GRAPHQL_URL}/{query_id}/{operation}"
+        return url, query_id
+
+    def __init__(self, client: Client):
+        self._client = client
+
+    async def gql_request(
+        self, method, operation, **kwargs
+    ) -> tuple[requests.Response, dict]:
+        url, query_id = self._operation_to_url(operation)
+
+        if method == "POST":
+            payload = kwargs["json"] = kwargs.get("json") or {}
+            payload["queryId"] = query_id
+        else:
+            params = kwargs["params"] = kwargs.get("params") or {}
+            ...
+
+        response, data = await self._client.request(method, url, **kwargs)
+        return response, data["data"]
+
+    async def user_by_username(self, username: str) -> User | None:
+        features = self._DEFAULT_FEATURES
+        variables = self._DEFAULT_VARIABLES
+        variables["screen_name"] = username
+        params = {
+            "variables": variables,
+            "features": features,
+        }
+        response, data = await self.gql_request(
+            "GET", "UserByScreenName", params=params
+        )
+        return User.from_raw_data(data["user"]["result"]) if data else None
+
+    async def users_by_ids(
+        self, user_ids: Iterable[str | int]
+    ) -> dict[int : User | Account]:
+        features = self._DEFAULT_FEATURES
+        variables = self._DEFAULT_VARIABLES
+        variables["userIds"] = list({str(user_id) for user_id in user_ids})
+        params = {
+            "variables": variables,
+            "features": features,
+        }
+        response, data = await self.gql_request("GET", "UsersByRestIds", params=params)
+
+        users = {}
+        for user_data in data["users"]:
+            user = User.from_raw_data(user_data["result"])
+            users[user.id] = user
+            if user.id == self._client.account.id:
+                users[self._client.account.id] = self._client.account
+        return users

twitter/enums.py

@@ -8,6 +8,7 @@ class AccountStatus(enum.StrEnum):
     LOCKED = "LOCKED"
     CONSENT_LOCKED = "CONSENT_LOCKED"
     GOOD = "GOOD"
+    NOT_FOUND = "NOT_FOUND"
 
     def __str__(self):
         return self.value

twitter/errors.py

@@ -13,10 +13,11 @@ __all__ = [
     "RateLimited",
     "ServerError",
     "BadAccount",
-    "BadToken",
-    "Locked",
-    "ConsentLocked",
-    "Suspended",
+    "BadAccountToken",
+    "AccountLocked",
+    "AccountConsentLocked",
+    "AccountSuspended",
+    "AccountNotFound",
 ]
 
 
@@ -149,7 +150,7 @@ class BadAccount(TwitterException):
         super().__init__(exception_message)
 
 
-class BadToken(BadAccount):
+class BadAccountToken(BadAccount):
     def __init__(self, http_exception: "HTTPException", account: Account):
         exception_message = (
             "Bad Twitter account's auth_token. Relogin to get new token."
@@ -157,7 +158,7 @@ class BadToken(BadAccount):
         super().__init__(http_exception, account, exception_message)
 
 
-class Locked(BadAccount):
+class AccountLocked(BadAccount):
     def __init__(self, http_exception: "HTTPException", account: Account):
         exception_message = (
             f"Twitter account is locked."
@@ -166,13 +167,19 @@ class Locked(BadAccount):
         super().__init__(http_exception, account, exception_message)
 
 
-class ConsentLocked(BadAccount):
+class AccountConsentLocked(BadAccount):
     def __init__(self, http_exception: "HTTPException", account: Account):
         exception_message = f"Twitter account is locked."
         super().__init__(http_exception, account, exception_message)
 
 
-class Suspended(BadAccount):
+class AccountSuspended(BadAccount):
     def __init__(self, http_exception: "HTTPException", account: Account):
         exception_message = f"Twitter account is suspended."
         super().__init__(http_exception, account, exception_message)
+
+
+class AccountNotFound(BadAccount):
+    def __init__(self, http_exception: "HTTPException", account: Account):
+        exception_message = f"Twitter account not found or deleted."
+        super().__init__(http_exception, account, exception_message)

twitter/models.py

@@ -26,6 +26,9 @@ class Media(BaseModel):
     def __str__(self):
         return str(self.id)
 
+    def __hash__(self):
+        return hash(self.id)
+
 
 class User(BaseModel):
     # fmt: off
@@ -46,6 +49,9 @@ class User(BaseModel):
     def __repr__(self):
         return f"{self.__class__.__name__}(id={self.id}, username={self.username})"
 
+    def __hash__(self):
+        return hash(self.id)
+
     @classmethod
     def from_raw_data(cls, data: dict):
         legacy = data["legacy"]
@@ -105,6 +111,9 @@ class Tweet(BaseModel):
     def __repr__(self):
         return f"{self.__class__.__name__}(id={self.id}, user_id={self.user.id})"
 
+    def __hash__(self):
+        return hash(self.id)
+
     @property
     def short_text(self) -> str:
         return f"{self.text[:32]}..." if len(self.text) > 16 else self.text
@@ -162,6 +171,9 @@ class Subtask(BaseModel):
     detail_text: Optional[str] = None
     raw_data: dict
 
+    def __hash__(self):
+        return hash(self.id)
+
     @classmethod
     def from_raw_data(cls, data: dict) -> "Subtask":
         task = {"id": data["subtask_id"]}