Add get_similar_bots to return a list of bots similar to the given bot.

Author: SpEcHiDe

compiler/docs/compiler.py

@@ -366,6 +366,7 @@ def get_title_list(s: str) -> list:
             answer_web_app_query
             send_web_app_custom_request
             get_owned_bots
+            get_similar_bots
         """,
         phone="""
         Phone

docs/source/releases/changes-in-this-fork.rst

@@ -26,6 +26,7 @@ Changes in this Fork
 | Scheme layer used: 198 |
 +------------------------+
 
+- Added the :meth:`~pyrogram.Client.get_similar_bots`.
 - Changed types in :obj:`~pyrogram.types.UpgradedGift`, :obj:`~pyrogram.types.UserGift`.
 - PR from upstream: `701 <https://github.com/pyrogram/pyrogram/pull/701>`_
 - View `new and changed <https://telegramplayground.github.io/TG-APIs/TL/diff/tdlib.html?from=196&to=198>`__ `raw API methods <https://telegramplayground.github.io/TG-APIs/TL/diff/tdesktop.html?from=196&to=198>`__.

pyrogram/methods/bots/__init__.py

@@ -40,6 +40,7 @@
 from .set_chat_menu_button import SetChatMenuButton
 from .set_game_score import SetGameScore
 from .get_owned_bots import GetOwnedBots
+from .get_similar_bots import GetSimilarBots
 
 
 class Bots(
@@ -67,5 +68,6 @@ class Bots(
     SetBotName,
     GetBotName,
     GetOwnedBots,
+    GetSimilarBots,
 ):
     pass

pyrogram/methods/bots/get_similar_bots.py

@@ -0,0 +1,53 @@
+#  Pyrogram - Telegram MTProto API Client Library for Python
+#  Copyright (C) 2017-present <https://github.com/TelegramPlayGround>
+#
+#  This file is part of Pyrogram.
+#
+#  Pyrogram is free software: you can redistribute it and/or modify
+#  it under the terms of the GNU Lesser General Public License as published
+#  by the Free Software Foundation, either version 3 of the License, or
+#  (at your option) any later version.
+#
+#  Pyrogram is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU Lesser General Public License for more details.
+#
+#  You should have received a copy of the GNU Lesser General Public License
+#  along with Pyrogram.  If not, see <http://www.gnu.org/licenses/>.
+
+from typing import Union
+
+import pyrogram
+from pyrogram import raw, types
+
+
+class GetSimilarBots:
+    async def get_similar_bots(
+        self: "pyrogram.Client",
+        user_id: Union[int, str]
+    ) -> list["types.User"]:
+        """Returns a list of bots similar to the given bot.
+
+        .. include:: /_includes/usable-by/users.rst
+
+        Parameters:
+            user_id (``int`` | ``str``):
+                Unique identifier (int) or username (str) of the target bot.
+
+        Returns:
+            List of :obj:`~pyrogram.types.User`: On success.
+
+        Example:
+            .. code-block:: python
+
+                bots = await app.get_similar_bots()
+        """
+
+        botss = await self.invoke(raw.functions.bots.GetBotRecommendations(
+            bot=await self.resolve_peer(user_id)
+        ))
+        return types.List([
+            types.User._parse(self, b)
+            for b in botss.users
+        ])