python-amazon-sp-api 1.9.56__py3-none-any.whl → 1.9.58__py3-none-any.whl

{python_amazon_sp_api-1.9.56.dist-info → python_amazon_sp_api-1.9.58.dist-info}/METADATA

@@ -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.dist-info → python_amazon_sp_api-1.9.58.dist-info}/RECORD

@@ -1,8 +1,8 @@
-python_amazon_sp_api-1.9.56.data/scripts/make_endpoint,sha256=QWcwG6z4RWFJlzj4-xyHJymjObyKtwkvWFRq8T18iG0,8568
-python_amazon_sp_api-1.9.56.dist-info/licenses/LICENSE,sha256=nbzomPIVo1PVl5bpGAntofsYAF7ZQ2UhzOtKgf7IiNw,1071
+python_amazon_sp_api-1.9.58.data/scripts/make_endpoint,sha256=QWcwG6z4RWFJlzj4-xyHJymjObyKtwkvWFRq8T18iG0,8568
+python_amazon_sp_api-1.9.58.dist-info/licenses/LICENSE,sha256=nbzomPIVo1PVl5bpGAntofsYAF7ZQ2UhzOtKgf7IiNw,1071
 sp_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sp_api/__version__.py,sha256=4N4DiSV_BGLFiPpBUeM-emXg1TiN3nJYJQ9r0Y4tCpM,23
-sp_api/api/__init__.py,sha256=spVkblGMx7S74LLEAE2ztM6aWoX_aww7WJs4iL5a7xs,4663
+sp_api/__version__.py,sha256=VQ9veyZEEEC8UBuZZZgujoj5SJzahVubv24IikKvBX4,23
+sp_api/api/__init__.py,sha256=QTDz2g_fryNGkGszhytqhI8K3x_ttP7fbXLJ5uRvmj0,4747
 sp_api/api/amazon_warehousing_and_distribu/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sp_api/api/amazon_warehousing_and_distribu/amazon_warehousing_and_distribu.py,sha256=bMBIxIj0eu6Gi6WY3XLdHHYDzNCwz0-9X59Jo9DoqfE,5863
 sp_api/api/aplus_content/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -17,6 +17,8 @@ sp_api/api/catalog/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuF
 sp_api/api/catalog/catalog.py,sha256=sDykeEaSmZZHwQ-6aYJvc9xDZqBGs9FlnUvKveE5ZCY,3956
 sp_api/api/catalog_items/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sp_api/api/catalog_items/catalog_items.py,sha256=TtPMh-75lL6HIPwxesEP1i8RGjmCuAPWdUptKdth_sU,4817
+sp_api/api/customer_feedback/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sp_api/api/customer_feedback/customer_feedback.py,sha256=3QJOu7-nHTdHWGricL6hnmX0qKcmqmoVsBLIpo1IJv4,3559
 sp_api/api/data_kiosk/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sp_api/api/data_kiosk/data_kiosk.py,sha256=OyLyXtpAmPhfeDUqU2O7ovZ5e7K_ZAEcfyv3INNecyc,12175
 sp_api/api/easy_ship/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -125,7 +127,7 @@ sp_api/util/key_maker.py,sha256=T4I2rdBZzvWtX32qgrv9DA5EzVK3LEAWtbRffup-_kE,2172
 sp_api/util/load_all_pages.py,sha256=K6Suml4_GWZ5L9-YcnhaM9q-dA7Xr6wNLE-kWP_8MPk,1839
 sp_api/util/load_date_bound.py,sha256=j9gu9WucENqU9xaQ-xG7c4yK4RB-FXK39_r1mLT76z0,1726
 sp_api/util/retry.py,sha256=V8SeSeX3Brdou138hNA5HeQkKlHppZcqbZobIDjmBYw,2407
-python_amazon_sp_api-1.9.56.dist-info/METADATA,sha256=RVjoUK2csLMazAMs11GWPOy5mjP0VJuUpRCmZ-DO0LE,6815
-python_amazon_sp_api-1.9.56.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-python_amazon_sp_api-1.9.56.dist-info/top_level.txt,sha256=mEzPMFyyy0LmJGY4KFXfh5usUka4eeouIr7-2IAzoE0,7
-python_amazon_sp_api-1.9.56.dist-info/RECORD,,
+python_amazon_sp_api-1.9.58.dist-info/METADATA,sha256=TzWy3SQuEfEHNG6lEP4cOciAQZiFZ96dHQkCXbEf3kE,6794
+python_amazon_sp_api-1.9.58.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+python_amazon_sp_api-1.9.58.dist-info/top_level.txt,sha256=mEzPMFyyy0LmJGY4KFXfh5usUka4eeouIr7-2IAzoE0,7
+python_amazon_sp_api-1.9.58.dist-info/RECORD,,

sp_api/__version__.py

@@ -1 +1 @@
-__version__ = '1.9.56'
+__version__ = '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",

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
+        )