rocketapi 1.0.6__tar.gz → 1.0.8__tar.gz

{rocketapi-1.0.6 → rocketapi-1.0.8}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.1
 Name: rocketapi
-Version: 1.0.6
+Version: 1.0.8
 Summary: RocketAPI Python SDK
 Home-page: https://github.com/rocketapi-io/rocketapi-python
-Download-URL: https://github.com/rocketapi-io/rocketapi-python/archive/refs/tags/v1.0.6.tar.gz
+Download-URL: https://github.com/rocketapi-io/rocketapi-python/archive/refs/tags/v1.0.8.tar.gz
 Author: RocketAPI
 Author-email: developer@rocketapi.io

{rocketapi-1.0.6 → rocketapi-1.0.8}/rocketapi/instagramapi.py

@@ -34,13 +34,22 @@ class InstagramAPI(RocketAPI):
             elif response["response"]["status_code"] == 404:
                 raise NotFoundException("Instagram resource not found")
             else:
-                raise BadResponseException("Bad response from Instagram")
-        raise BadResponseException("Bad response from RocketAPI")
+                raise BadResponseException(
+                    f"Bad response from Instagram ({method}: {response['response']['status_code']})"
+                )
+        raise BadResponseException(f"Bad response from RocketAPI ({method})")
 
     def search(self, query):
         """
         Search for a specific user, hashtag or place.
 
+        As of September 2024, we no longer recommend using this method, as it now only returns a maximum of 5 users and leaves the places and hashtags arrays empty. Instead, please use the separate methods:
+        - `search_users`
+        - `search_hashtags`
+        - `search_locations`
+        - `search_audios`
+        - `search_clips`
+
         Args:
             query (str): The search query
 
@@ -76,7 +85,7 @@ class InstagramAPI(RocketAPI):
 
         Args:
             user_id (int): User id
-            count (int): Number of media to retrieve (max: 50)
+            count (int): Number of media to retrieve (max: 12)
             max_id (str): Use for pagination
 
         You can use the `max_id` parameter to paginate through the media (take from the `next_max_id` field of the response).
@@ -94,7 +103,7 @@ class InstagramAPI(RocketAPI):
 
         Args:
             user_id (int): User id
-            count (int): Number of media to retrieve (max: 50)
+            count (int): Number of media to retrieve (max: 12)
             max_id (str): Use for pagination
 
         You can use the `max_id` parameter to paginate through the media (take from the `max_id` (!) field of the response).
@@ -179,7 +188,7 @@ class InstagramAPI(RocketAPI):
 
         Args:
             user_id (int): User id
-            count (int): Number of users to return (max: 100)
+            count (int): Number of users to return (max: 50)
             max_id (str): Use for pagination
 
         You can use the `max_id` parameter to paginate through followers (take from the `next_max_id` field of the response).
@@ -287,14 +296,14 @@ class InstagramAPI(RocketAPI):
 
     def get_media_likes(self, shortcode, count=12, max_id=None):
         """
-        Retrieve media likes by media shortcode.
+        Retrieve up to 1000 media likes by media shortcode.
 
         Args:
             shortcode (str): Media shortcode
-            count (int): Number of likers to return (max: 50)
-            max_id (str): Use for pagination
+            count (int): Not supported right now
+            max_id (str): Not supported right now
 
-        You can use the `max_id` parameter to paginate through likers (take from the `next_max_id` field of the response).
+        Pagination is not supported for this endpoint.
 
         For more information, see documentation: https://docs.rocketapi.io/api/instagram/media/get_likes
         """
@@ -367,7 +376,7 @@ class InstagramAPI(RocketAPI):
         """
         return self.request("instagram/location/get_info", {"id": location_id})
 
-    def get_location_media(self, location_id, page=None, max_id=None):
+    def get_location_media(self, location_id, page=None, max_id=None, tab=None):
         """
         Retrieve location media by location id.
 
@@ -375,6 +384,7 @@ class InstagramAPI(RocketAPI):
             location_id (int): Location id
             page (int): Page number
             max_id (str): Use for pagination
+            tab (str): Tab name: recent, ranked (default: recent)
 
         In order to use pagination, you need to use both the `max_id` and `page` parameters. You can obtain these values from the response's `next_page` and `next_max_id` fields.
 
@@ -385,6 +395,8 @@ class InstagramAPI(RocketAPI):
             payload["page"] = page
         if max_id is not None:
             payload["max_id"] = max_id
+        if tab is not None:
+            payload["tab"] = tab
         return self.request("instagram/location/get_media", payload)
 
     def get_hashtag_info(self, name):
@@ -492,6 +504,23 @@ class InstagramAPI(RocketAPI):
             payload["max_id"] = max_id
         return self.request("instagram/audio/get_media", payload)
 
+    def get_audio_media_by_canonical_id(self, audio_canonical_id, max_id=None):
+        """
+        Retrieve audio media by audio canonical id.
+
+        Args:
+            audio_canonical_id (int): Audio canonical id
+            max_id (str): Use for pagination
+
+        You can use the `max_id` parameter to paginate through media (take from the `next_max_id` field of the response).
+
+        For more information, see documentation: https://docs.rocketapi.io/api/instagram/audio/get_media_by_canonical_id
+        """
+        payload = {"id": audio_canonical_id}
+        if max_id is not None:
+            payload["max_id"] = max_id
+        return self.request("instagram/audio/get_media_by_canonical_id", payload)
+
     def get_user_about(self, user_id):
         """
         Obtain user details from «About this Account» section.
@@ -505,3 +534,58 @@ class InstagramAPI(RocketAPI):
         For more information, see documentation: https://docs.rocketapi.io/api/instagram/user/get_about
         """
         return self.request("instagram/user/get_about", {"id": user_id})
+
+    def search_users(self, query):
+        """
+        Search for a specific user (max 50 results)
+
+        Args:
+            query (str): The search query
+
+        For more information, see documentation: https://docs.rocketapi.io/api/instagram/user/search
+        """
+        return self.request("instagram/user/search", {"query": query})
+
+    def search_hashtags(self, query):
+        """
+        Search for a specific hashtag (max 20 results)
+
+        Args:
+            query (str): The search query
+
+        For more information, see documentation: https://docs.rocketapi.io/api/instagram/hashtag/search
+        """
+        return self.request("instagram/hashtag/search", {"query": query})
+
+    def search_locations(self, query):
+        """
+        Search for a specific location (max 20 results)
+
+        Args:
+            query (str): The search query
+
+        For more information, see documentation: https://docs.rocketapi.io/api/instagram/location/search
+        """
+        return self.request("instagram/location/search", {"query": query})
+
+    def search_audios(self, query):
+        """
+        Search for a specific audio (max 10 results)
+
+        Args:
+            query (str): The search query
+
+        For more information, see documentation: https://docs.rocketapi.io/api/instagram/audio/search
+        """
+        return self.request("instagram/audio/search", {"query": query})
+
+    def search_clips(self, query):
+        """
+        Search for a specific clip with a caption that includes the query (max 12 results)
+
+        Args:
+            query (str): The search query
+
+        For more information, see documentation: https://docs.rocketapi.io/api/instagram/media/search_clips
+        """
+        return self.request("instagram/media/search_clips", {"query": query})

{rocketapi-1.0.6 → rocketapi-1.0.8}/rocketapi/rocketapi.py

@@ -11,6 +11,7 @@ class RocketAPI:
         For more information, see documentation: https://docs.rocketapi.io/api/
         """
         self.base_url = "https://v1.rocketapi.io/"
+        self.version = "1.0.8"
         self.token = token
         self.max_timeout = max_timeout
 
@@ -18,6 +19,9 @@ class RocketAPI:
         return requests.post(
             url=self.base_url + method,
             json=data,
-            headers={"Authorization": f"Token {self.token}"},
+            headers={
+                "Authorization": f"Token {self.token}",
+                "User-Agent": f"RocketAPI Python SDK/{self.version}",
+            },
             timeout=self.max_timeout,
         ).json()

{rocketapi-1.0.6 → rocketapi-1.0.8}/rocketapi.egg-info/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.1
 Name: rocketapi
-Version: 1.0.6
+Version: 1.0.8
 Summary: RocketAPI Python SDK
 Home-page: https://github.com/rocketapi-io/rocketapi-python
-Download-URL: https://github.com/rocketapi-io/rocketapi-python/archive/refs/tags/v1.0.6.tar.gz
+Download-URL: https://github.com/rocketapi-io/rocketapi-python/archive/refs/tags/v1.0.8.tar.gz
 Author: RocketAPI
 Author-email: developer@rocketapi.io

{rocketapi-1.0.6 → rocketapi-1.0.8}/setup.py

@@ -3,12 +3,12 @@ import setuptools
 
 setuptools.setup(
     name="rocketapi",
-    version="1.0.6",
+    version="1.0.8",
     author="RocketAPI",
     author_email="developer@rocketapi.io",
     description="RocketAPI Python SDK",
     packages=["rocketapi"],
     url="https://github.com/rocketapi-io/rocketapi-python",
-    download_url="https://github.com/rocketapi-io/rocketapi-python/archive/refs/tags/v1.0.6.tar.gz",
+    download_url="https://github.com/rocketapi-io/rocketapi-python/archive/refs/tags/v1.0.8.tar.gz",
     install_requires=["requests"],
 )