From: Harmon <Harmon758@gmail.com>
Date: Fri, 9 Apr 2021 18:52:19 +0000 (-0500)
Subject: Add API.get_profile_banner
X-Git-Url: https://vcs.fsf.org/?a=commitdiff_plain;h=58ac8bb8083044f37c1999b61ecb763918d7a703;p=tweepy.git

Add API.get_profile_banner
---

diff --git a/docs/api.rst b/docs/api.rst
index 495333e..6faa869 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -152,6 +152,8 @@ Manage account settings and profile
 
 .. automethod:: API.get_saved_search
 
+.. automethod:: API.get_profile_banner
+
 
 Direct Message Methods
 ----------------------
diff --git a/tweepy/api.py b/tweepy/api.py
index 936d549..3e495eb 100644
--- a/tweepy/api.py
+++ b/tweepy/api.py
@@ -1804,6 +1804,30 @@ class API:
         """
         return self.request('GET', f'saved_searches/show/{id}', **kwargs)
 
+    @payload('json')
+    def get_profile_banner(self, **kwargs):
+        """get_profile_banner(*, user_id, screen_name)
+
+        Returns a map of the available size variations of the specified user's
+        profile banner. If the user has not uploaded a profile banner, a HTTP
+        404 will be served instead.
+
+        The profile banner data available at each size variant's URL is in PNG
+        format.
+
+        :param user_id: |user_id|
+        :param screen_name: |screen_name|
+
+        :rtype: :class:`JSON` object
+
+        :reference: https://developer.twitter.com/en/docs/twitter-api/v1/accounts-and-users/manage-account-settings/api-reference/get-users-profile_banner
+        """
+        return self.request(
+            'GET', 'users/profile_banner', endpoint_parameters=(
+                'user_id', 'screen_name'
+            ), **kwargs
+        )
+
     def media_upload(self, filename, *, file=None, chunked=False,
                      media_category=None, additional_owners=None, **kwargs):
         """ :reference: https://developer.twitter.com/en/docs/twitter-api/v1/media/upload-media/overview