python-amazon-sp-api 1.9.56__tar.gz → 1.9.58__tar.gz

{python_amazon_sp_api-1.9.56/python_amazon_sp_api.egg-info → python_amazon_sp_api-1.9.58}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-sp-api
-Version: 1.9.56
+Version: 1.9.58
 Summary: Python wrapper for the Amazon Selling-Partner API
 Home-page: https://github.com/saleweaver/python-amazon-sp-api
 Author: Michael
@@ -43,7 +43,7 @@ A wrapper to access **Amazon's Selling Partner API** with an easy-to-use interfa
 With Amazon’s new SP-API pricing model (annual fees plus usage-based charges for GET requests), inefficient integrations will quickly become costly. If your systems rely on `python-amazon-sp-api` and you want to control these expenses, I offer consulting to review and optimize your implementation—such as replacing high-volume Orders API polling with report-based workflows and reducing unnecessary GET traffic wherever possible. If you’d like expert support preparing your SP-API usage for the upcoming pricing changes, feel free to get in touch.
 
 
-[Get in touch](mailto:fees@clairinsights.com)
+<fees@clairinsights.com>
 
 ---
 

{python_amazon_sp_api-1.9.56 → python_amazon_sp_api-1.9.58}/README.md

@@ -16,7 +16,7 @@ A wrapper to access **Amazon's Selling Partner API** with an easy-to-use interfa
 With Amazon’s new SP-API pricing model (annual fees plus usage-based charges for GET requests), inefficient integrations will quickly become costly. If your systems rely on `python-amazon-sp-api` and you want to control these expenses, I offer consulting to review and optimize your implementation—such as replacing high-volume Orders API polling with report-based workflows and reducing unnecessary GET traffic wherever possible. If you’d like expert support preparing your SP-API usage for the upcoming pricing changes, feel free to get in touch.
 
 
-[Get in touch](mailto:fees@clairinsights.com)
+<fees@clairinsights.com>
 
 ---
 

{python_amazon_sp_api-1.9.56 → python_amazon_sp_api-1.9.58/python_amazon_sp_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-sp-api
-Version: 1.9.56
+Version: 1.9.58
 Summary: Python wrapper for the Amazon Selling-Partner API
 Home-page: https://github.com/saleweaver/python-amazon-sp-api
 Author: Michael
@@ -43,7 +43,7 @@ A wrapper to access **Amazon's Selling Partner API** with an easy-to-use interfa
 With Amazon’s new SP-API pricing model (annual fees plus usage-based charges for GET requests), inefficient integrations will quickly become costly. If your systems rely on `python-amazon-sp-api` and you want to control these expenses, I offer consulting to review and optimize your implementation—such as replacing high-volume Orders API polling with report-based workflows and reducing unnecessary GET traffic wherever possible. If you’d like expert support preparing your SP-API usage for the upcoming pricing changes, feel free to get in touch.
 
 
-[Get in touch](mailto:fees@clairinsights.com)
+<fees@clairinsights.com>
 
 ---
 

{python_amazon_sp_api-1.9.56 → python_amazon_sp_api-1.9.58}/python_amazon_sp_api.egg-info/SOURCES.txt

@@ -25,6 +25,8 @@ sp_api/api/catalog/__init__.py
 sp_api/api/catalog/catalog.py
 sp_api/api/catalog_items/__init__.py
 sp_api/api/catalog_items/catalog_items.py
+sp_api/api/customer_feedback/__init__.py
+sp_api/api/customer_feedback/customer_feedback.py
 sp_api/api/data_kiosk/__init__.py
 sp_api/api/data_kiosk/data_kiosk.py
 sp_api/api/easy_ship/__init__.py

{python_amazon_sp_api-1.9.56 → python_amazon_sp_api-1.9.58}/setup.py

@@ -39,6 +39,7 @@ setup(
               'sp_api.util',
               ##### DO NOT DELETE ########## INSERT PACKAGE HERE #######
               'sp_api.api.application_integrations',
+              'sp_api.api.customer_feedback',
               'sp_api.api.external_fulfillment',
               'sp_api.api.easy_ship',
               'sp_api.api.listings_restrictions',

python_amazon_sp_api-1.9.58/sp_api/__version__.py

@@ -0,0 +1 @@
+__version__ = '1.9.58'

{python_amazon_sp_api-1.9.56 → python_amazon_sp_api-1.9.58}/sp_api/api/__init__.py

@@ -26,7 +26,7 @@ from .application_integrations.application_integrations import ApplicationIntegr
 
 from .easy_ship.easy_ship import EasyShip
     
-
+from .customer_feedback.customer_feedback import CustomerFeedback
 
 from .listings_restrictions.listings_restrictions import ListingsRestrictions
 
@@ -119,7 +119,7 @@ __all__ = [
     ##### DO NOT DELETE ########## INSERT TITLE HERE #######
     "ExternalFulfillment",
     "ApplicationIntegrations",
-    
+    "CustomerFeedback",
     "FulfillmentInbound",
     
     "EasyShip",

python_amazon_sp_api-1.9.58/sp_api/api/customer_feedback/customer_feedback.py

@@ -0,0 +1,110 @@
+from sp_api.base import Client, sp_endpoint, ApiResponse, fill_query_params
+
+
+class CustomerFeedback(Client):
+    """
+    The Selling Partner API for CustomerFeedback - 2024-06-01
+
+    The Selling Partner API for Customer Feedback (Customer Feedback API) provides information about customer reviews and returns at both the item and browse node level.
+    """
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/items/{}/reviews/topics", method="GET"
+    )
+    def get_item_review_topics(
+        self, asin, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve an item's ten most positive and ten most negative review topics.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), asin), params=kwargs
+        )
+
+    @sp_endpoint("/customerFeedback/2024-06-01/items/{}/browseNode", method="GET")
+    def get_item_browse_node(self, asin, *args, **kwargs) -> ApiResponse:
+        """
+        This API returns the associated browse node of the requested ASIN. A browse node is a location in a browse tree that is used for navigation, product classification, and website content on the Amazon retail website.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), asin), params=kwargs
+        )
+
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/browseNodes/{}/reviews/topics",
+        method="GET",
+    )
+    def get_browse_node_review_topics(
+        self, browseNodeId, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve a browse node's ten most positive and ten most negative review topics.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), browseNodeId), params=kwargs
+        )
+
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/items/{}/reviews/trends", method="GET"
+    )
+    def get_item_review_trends(
+        self, asin, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve an item's positive and negative review trends for the past six months.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), asin), params=kwargs
+        )
+
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/browseNodes/{}/reviews/trends",
+        method="GET",
+    )
+    def get_browse_node_review_trends(
+        self, browseNodeId, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve the positive and negative review trends of items in a browse node for the past six months.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), browseNodeId), params=kwargs
+        )
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/browseNodes/{}/returns/topics",
+        method="GET",
+    )
+    def get_browse_node_return_topics(
+        self, browseNodeId, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve the topics that customers mention when they return items in a browse node.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), browseNodeId), params=kwargs
+        )
+
+    @sp_endpoint(
+        "/customerFeedback/2024-06-01/browseNodes/{}/returns/trends",
+        method="GET",
+    )
+    def get_browse_node_return_trends(
+        self, browseNodeId, *args, **kwargs
+    ) -> ApiResponse:
+        """
+        Retrieve the trends of topics that customers mention when they return items in a browse node.
+        """
+
+        return self._request(
+            fill_query_params(kwargs.pop('path'), browseNodeId), params=kwargs
+        )

python_amazon_sp_api-1.9.56/sp_api/__version__.py

@@ -1 +0,0 @@
-__version__ = '1.9.56'