Add methods for Walmart and Target reviews (#38)

Author: DataUrbanEconGeek

outscraper/client.py

@@ -1386,3 +1386,77 @@ def yellowpages_search(self, query: Union[list, str], location: str = 'New York,
         }
 
         return self._request('GET', '/yellowpages-search', wait_async=wait_async, async_request=async_request, params=params)
+
+    def wallmart_reviews(self, query: Union[list, str], limit: int = 100, sort: str = 'relevancy', cutoff: int = None,
+            fields: Union[list, str] = None, async_request: bool = False, ui: bool = None, webhook: str = None
+        ) -> Union[list, dict]:
+            '''
+                Returns reviews from a list of products.
+    
+                        Parameters:
+                                query (list | str): Links to Walmart products (e.g., https://www.walmart.com/ip/Blackstone-Original-4-Burner-36-Propane-Omnivore-Griddle-with-Hard-Cover/1347629739). Using a lists allows multiple queries (up to 1000) to be sent in one request and save on network latency time.
+                                limit (int): parameter specifies the limit of reviews to get from one query.
+                                sort (str): parameter specifies one of the sorting types. Available values: "relevancy", "helpful", "submission-desc", "submission-asc", "rating-desc", "rating-asc".
+                                cutoff (int): parameter specifies the oldest timestamp value for items. Using the cutoff parameter overwrites sort parameter to most recent.
+                                fields (list | str): parameter defines which fields you want to include with each item returned in the response. By default, it returns all fields.
+                                async_request (bool): parameter defines the way you want to submit your task to Outscraper. It can be set to `False` (default) to send a task and wait until you got your results, or `True` to submit your task and retrieve the results later using a request ID with `get_request_archive`. Each response is available for `2` hours after a request has been completed.
+                                ui (bool): parameter defines whether a task will be executed as a UI task. This is commonly used when you want to create a regular platform task with API. Using this parameter overwrites the async_request parameter to `True`.
+                                webhook (str): parameter defines the URL address (callback) to which Outscraper will create a POST request with a JSON body once a task/request is finished. Using this parameter overwrites the webhook from integrations.
+    
+                        Returns:
+                                list|dict: JSON result
+    
+                See: https://app.outscraper.cloud/api-docs#tag/reviews--comments/GET/walmart-reviews
+            '''
+    
+            queries = as_list(query)
+            wait_async = async_request or limit > 499 or len(queries) > 10
+            params = {
+                'query': queries,
+                'limit': limit,
+                'sort': sort,
+                'cutoff': cutoff,
+                'async': wait_async,
+                'fields': parse_fields(fields),
+                'ui': ui,
+                'webhook': webhook,
+            }
+    
+            return self._request('GET', '/walmart-reviews', wait_async=wait_async, async_request=async_request, params=params)
+
+    def target_reviews(self, query: Union[list, str], limit: int = 100, sort: str = 'most_recent', cutoff: int = None,
+            fields: Union[list, str] = None, async_request: bool = False, ui: bool = None, webhook: str = None
+        ) -> Union[list, dict]:
+            '''
+                Returns reviews from a list of products.
+    
+                        Parameters:
+                                query (list | str): Links to Target products (e.g., https://www.target.com/p/apple-iphone-15-pro-max/-/A-89957794). Using a lists allows multiple queries (up to 1000) to be sent in one request and save on network latency time.
+                                limit (int): parameter specifies the limit of reviews to get from one query.
+                                sort (str): parameter specifies one of the sorting types. Available values: "most_recent", "highest_rating", "lowest_rating", "helpfulness_desc".
+                                cutoff (int): parameter specifies the oldest timestamp value for items. Using the cutoff parameter overwrites sort parameter to most recent.
+                                fields (list | str): parameter defines which fields you want to include with each item returned in the response. By default, it returns all fields.
+                                async_request (bool): parameter defines the way you want to submit your task to Outscraper. It can be set to `False` (default) to send a task and wait until you got your results, or `True` to submit your task and retrieve the results later using a request ID with `get_request_archive`. Each response is available for `2` hours after a request has been completed.
+                                ui (bool): parameter defines whether a task will be executed as a UI task. This is commonly used when you want to create a regular platform task with API. Using this parameter overwrites the async_request parameter to `True`.
+                                webhook (str): parameter defines the URL address (callback) to which Outscraper will create a POST request with a JSON body once a task/request is finished. Using this parameter overwrites the webhook from integrations.
+    
+                        Returns:
+                                list|dict: JSON result
+    
+                See: https://app.outscraper.cloud/api-docs#tag/reviews--comments/GET/target-reviews
+            '''
+    
+            queries = as_list(query)
+            wait_async = async_request or limit > 499 or len(queries) > 10
+            params = {
+                'query': queries,
+                'limit': limit,
+                'sort': sort,
+                'cutoff': cutoff,
+                'async': wait_async,
+                'fields': parse_fields(fields),
+                'ui': ui,
+                'webhook': webhook,
+            }
+    
+            return self._request('GET', '/target-reviews', wait_async=wait_async, async_request=async_request, params=params)