feat: “About this account” support to fetch account-based-in location from X

README.md

@@ -129,6 +129,12 @@ for tweet in tweets:
     print(tweet.text)
 ```
 
+**Check "About this account" info**
+```python
+about = await client.get_user_about('sama')
+print(about.account_based_in, about.username_changes)
+```
+
 **Send a dm**
 ```python
 await client.send_dm('123456789', 'Hello')

examples/about_account.py

@@ -0,0 +1,24 @@
+import asyncio
+from twikit.guest import Client
+
+
+AUTH_INFO_1 = '...'
+AUTH_INFO_2 = '...'
+PASSWORD = '...'
+
+client = Client('en-US')
+
+
+async def main():
+    client.load_cookies('cookies.json')
+    client_user = await client.user()
+
+    about = await client.get_user_about('sama')
+    print(about)
+    print(f'Based in: {about.account_based_in}')
+    print(f'Username changes: {about.username_changes}')
+    print(f'Identity verified: {about.is_identity_verified}')
+
+
+if __name__ == '__main__':
+    asyncio.run(main())

twikit/__init__.py

@@ -28,4 +28,4 @@
 from .notification import Notification
 from .trend import Trend
 from .tweet import CommunityNote, Poll, ScheduledTweet, Tweet
-from .user import User
+from .user import AccountAbout, User

twikit/client/client.py

@@ -46,7 +46,7 @@
 from ..trend import Location, PlaceTrend, PlaceTrends, Trend
 from ..tweet import CommunityNote, Poll, ScheduledTweet, Tweet, tweet_from_data
 from ..ui_metrics import solve_ui_metrics
-from ..user import User
+from ..user import AccountAbout, User
 from ..utils import (
     Flow,
     Result,
@@ -1401,6 +1401,29 @@ async def get_user_by_screen_name(self, screen_name: str) -> User:
 
         return User(self, user_data)
 
+    async def get_user_about(self, screen_name: str) -> AccountAbout:
+        """
+        Fetches "About this account" information by screen name.
+
+        Parameter
+        ---------
+        screen_name : :class:`str`
+            The screen name of the Twitter user.
+
+        Returns
+        -------
+        :class:`AccountAbout`
+            A data object containing profile provenance details.
+        """
+        response, _ = await self.gql.about_account(screen_name)
+        user_result = response.get('data', {}).get('user_result_by_screen_name')
+        if not user_result or 'result' not in user_result:
+            raise UserNotFound('The user does not exist.')
+        user_data = user_result['result']
+        if user_data.get('__typename') == 'UserUnavailable':
+            raise UserUnavailable(user_data.get('message'))
+        return AccountAbout(user_data)
+
     async def get_user_by_id(self, user_id: str) -> User:
         """
         Fetches a user by ID

twikit/client/gql.py

@@ -3,6 +3,7 @@
 from typing import TYPE_CHECKING
 
 from ..constants import (
+    ABOUT_ACCOUNT_FEATURES,
     DOMAIN,
     BOOKMARK_FOLDER_TIMELINE_FEATURES,
     COMMUNITY_NOTE_FEATURES,
@@ -39,6 +40,7 @@ def url(path):
     DELETE_TWEET = url('VaenaVgh5q5ih7kvyVjgtg/DeleteTweet')
     USER_BY_SCREEN_NAME = url('NimuplG1OB7Fd2btCLdBOw/UserByScreenName')
     USER_BY_REST_ID = url('tD8zKvQzwY3kdx5yz6YmOw/UserByRestId')
+    ABOUT_ACCOUNT = url('zs_jFPFT78rBpXv9Z3U2YQ/AboutAccountQuery')
     TWEET_DETAIL = url('U0HTv-bAWTBYylwEMT7x5A/TweetDetail')
     TWEET_RESULT_BY_REST_ID = url('Xl5pC_lBk_gcO2ItU39DQw/TweetResultByRestId')
     FETCH_SCHEDULED_TWEETS = url('ITtjAzvlZni2wWXwf295Qg/FetchScheduledTweets')
@@ -259,6 +261,12 @@ async def user_by_rest_id(self, user_id):
         }
         return await self.gql_get(Endpoint.USER_BY_REST_ID, variables, USER_FEATURES)
 
+    async def about_account(self, screen_name):
+        variables = {
+            'screenName': screen_name
+        }
+        return await self.gql_get(Endpoint.ABOUT_ACCOUNT, variables, ABOUT_ACCOUNT_FEATURES)
+
     async def tweet_detail(self, tweet_id, cursor):
         variables = {
             'focalTweetId': tweet_id,

twikit/constants.py

@@ -41,6 +41,10 @@
     'responsive_web_graphql_timeline_navigation_enabled': True
 }
 
+ABOUT_ACCOUNT_FEATURES = {
+    'responsive_web_graphql_timeline_navigation_enabled': True
+}
+
 LIST_FEATURES = {
     'responsive_web_graphql_exclude_directive_enabled': True,
     'verified_phone_label_enabled': False,

twikit/guest/client.py

@@ -19,9 +19,12 @@
     RequestTimeout,
     ServerError,
     TooManyRequests,
+    UserNotFound,
+    UserUnavailable,
     TwitterException,
     Unauthorized
 )
+from ..user import AccountAbout
 from ..utils import Result, find_dict, find_entry_by_type, httpx_transport_to_url
 from ..x_client_transaction import ClientTransaction
 from .tweet import Tweet
@@ -228,6 +231,29 @@ async def get_user_by_screen_name(self, screen_name: str) -> User:
         response, _ = await self.gql.user_by_screen_name(screen_name)
         return User(self, response['data']['user']['result'])
 
+    async def get_user_about(self, screen_name: str) -> AccountAbout:
+        """
+        Retrieves "About this account" information for the specified username.
+
+        Parameters
+        ----------
+        screen_name : :class:`str`
+            The screen name of the user to retrieve.
+
+        Returns
+        -------
+        :class:`AccountAbout`
+            A data object containing profile provenance details.
+        """
+        response, _ = await self.gql.about_account(screen_name)
+        user_result = response.get('data', {}).get('user_result_by_screen_name')
+        if not user_result or 'result' not in user_result:
+            raise UserNotFound('The user does not exist.')
+        user_data = user_result['result']
+        if user_data.get('__typename') == 'UserUnavailable':
+            raise UserUnavailable(user_data.get('message'))
+        return AccountAbout(user_data)
+
     async def get_user_by_id(self, user_id: str) -> User:
         """
         Retrieves a user object based on the provided user ID.

twikit/guest/user.py

@@ -3,6 +3,7 @@
 from datetime import datetime
 from typing import TYPE_CHECKING, Literal
 
+from ..user import AccountAbout
 from ..utils import Result, timestamp_to_datetime
 
 if TYPE_CHECKING:
@@ -119,6 +120,17 @@ def __init__(self, client: GuestClient, data: dict) -> None:
     def created_at_datetime(self) -> datetime:
         return timestamp_to_datetime(self.created_at)
 
+    async def get_about(self) -> AccountAbout:
+        """
+        Retrieves the "About this account" information for the user.
+
+        Returns
+        -------
+        :class:`AccountAbout`
+            Account about profile data.
+        """
+        return await self._client.get_user_about(self.screen_name)
+
     async def get_tweets(self, tweet_type: Literal['Tweets'] = 'Tweets', count: int = 40) -> list[Tweet]:
         """
         Retrieves the user's tweets.

twikit/user.py

@@ -14,6 +14,72 @@
     from .utils import Result
 
 
+class AccountAbout:
+    """
+    Represents data returned from Twitter's "About this account" panel.
+
+    Attributes
+    ----------
+    id : :class:`str` | None
+        User rest id.
+    screen_name : :class:`str` | None
+        The username of the account.
+    name : :class:`str` | None
+        The display name of the account.
+    account_based_in : :class:`str` | None
+        Region Twitter believes the account is based in.
+    location_accurate : :class:`bool` | None
+        Whether the location is considered accurate.
+    affiliate_username : :class:`str` | None
+        Linked affiliate username, if present.
+    source : :class:`str` | None
+        How the account source was determined.
+    username_changes : :class:`int` | None
+        Number of username changes Twitter recorded.
+    username_last_changed_at : :class:`int` | None
+        Timestamp in milliseconds of the last username change.
+    is_identity_verified : :class:`bool` | None
+        Whether the account has identity verification.
+    verified_since_msec : :class:`int` | None
+        Timestamp in milliseconds since verification.
+    """
+
+    def __init__(self, data: dict) -> None:
+        about = data.get('about_profile') or {}
+        core = data.get('core') or {}
+        verification = data.get('verification_info') or {}
+        reason = verification.get('reason') or {}
+        username_changes = about.get('username_changes') or {}
+
+        rest_id = data.get('rest_id')
+        self.id: str | None = rest_id
+        self.rest_id: str | None = rest_id
+        self.screen_name: str | None = core.get('screen_name')
+        self.name: str | None = core.get('name')
+        self.account_based_in: str | None = about.get('account_based_in')
+        self.location_accurate: bool | None = about.get('location_accurate')
+        self.affiliate_username: str | None = about.get('affiliate_username')
+        self.source: str | None = about.get('source')
+        self.username_changes: int | None = self._to_int(username_changes.get('count'))
+        self.username_last_changed_at: int | None = self._to_int(
+            username_changes.get('last_changed_at_msec')
+        )
+        self.is_identity_verified: bool | None = verification.get('is_identity_verified')
+        self.verified_since_msec: int | None = self._to_int(reason.get('verified_since_msec'))
+
+    @staticmethod
+    def _to_int(value) -> int | None:
+        if value is None:
+            return None
+        try:
+            return int(value)
+        except (TypeError, ValueError):
+            return None
+
+    def __repr__(self) -> str:
+        return f'<AccountAbout id="{self.id}" screen_name="{self.screen_name}">'
+
+
 class User:
     """
     Attributes
@@ -169,6 +235,17 @@ async def get_tweets(
         """
         return await self._client.get_user_tweets(self.id, tweet_type, count)
 
+    async def get_about(self) -> AccountAbout:
+        """
+        Retrieves the "About this account" information for the user.
+
+        Returns
+        -------
+        :class:`AccountAbout`
+            Account about profile data.
+        """
+        return await self._client.get_user_about(self.screen_name)
+
     async def follow(self) -> Response:
         """
         Follows the user.