rocketapi 1.0.5__tar.gz → 1.0.7__tar.gz

{rocketapi-1.0.5 → rocketapi-1.0.7}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.1
 Name: rocketapi
-Version: 1.0.5
+Version: 1.0.7
 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.5.tar.gz
+Download-URL: https://github.com/rocketapi-io/rocketapi-python/archive/refs/tags/v1.0.7.tar.gz
 Author: RocketAPI
 Author-email: developer@rocketapi.io

{rocketapi-1.0.5 → rocketapi-1.0.7}/rocketapi/instagramapi.py

@@ -34,13 +34,21 @@ 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`
+
         Args:
             query (str): The search query
 
@@ -76,7 +84,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).
@@ -88,19 +96,20 @@ class InstagramAPI(RocketAPI):
             payload["max_id"] = max_id
         return self.request("instagram/user/get_media", payload)
 
-    def get_user_clips(self, user_id, max_id=None):
+    def get_user_clips(self, user_id, count=12, max_id=None):
         """
         Retrieve user clips (videos from "Reels" section) by id.
 
         Args:
             user_id (int): User id
+            count (int): Number of media to retrieve (max: 50)
             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).
 
         For more information, see documentation: https://docs.rocketapi.io/api/instagram/user/get_clips
         """
-        payload = {"id": user_id}
+        payload = {"id": user_id, "count": count}
         if max_id is not None:
             payload["max_id"] = max_id
         return self.request("instagram/user/get_clips", payload)
@@ -178,7 +187,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).
@@ -286,14 +295,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
         """
@@ -504,3 +513,47 @@ 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})

{rocketapi-1.0.5 → rocketapi-1.0.7}/rocketapi/threadsapi.py

@@ -183,4 +183,3 @@ class ThreadsAPI(RocketAPI):
         """
         payload = {"id": thread_id}
         return self.request("threads/thread/get_likes", payload)
-

{rocketapi-1.0.5 → rocketapi-1.0.7}/rocketapi.egg-info/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.1
 Name: rocketapi
-Version: 1.0.5
+Version: 1.0.7
 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.5.tar.gz
+Download-URL: https://github.com/rocketapi-io/rocketapi-python/archive/refs/tags/v1.0.7.tar.gz
 Author: RocketAPI
 Author-email: developer@rocketapi.io

{rocketapi-1.0.5 → rocketapi-1.0.7}/setup.py

@@ -3,12 +3,12 @@ import setuptools
 
 setuptools.setup(
     name="rocketapi",
-    version="1.0.5",
+    version="1.0.7",
     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.5.tar.gz",
+    download_url="https://github.com/rocketapi-io/rocketapi-python/archive/refs/tags/v1.0.7.tar.gz",
     install_requires=["requests"],
 )