python-amazon-paapi 6.1.0__tar.gz → 6.2.0__tar.gz

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [6.2.0] - 2026-03-12
+
+### Added
+
+- LWA support in the `amazon_creatorsapi.aio` API layer
+
+### Changed
+
+- Bumped `creatorsapi-python-sdk` from `1.1.2` to `1.2.0`
+- Updated bundled SDK support to include LWA endpoints for v3.x
+
 ## [6.1.0] - 2026-02-09
 
 ### Added

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-paapi
-Version: 6.1.0
+Version: 6.2.0
 Summary: Amazon Product Advertising API 5.0 wrapper for Python
 Project-URL: Homepage, https://github.com/sergioteula/python-amazon-paapi
 Project-URL: Repository, https://github.com/sergioteula/python-amazon-paapi

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/amazon_creatorsapi/aio/api.py

@@ -106,7 +106,8 @@ class AsyncAmazonCreatorsApi:
 
     Raises:
         InvalidArgumentError: If neither country nor marketplace is provided.
-        ValueError: If version is not supported (valid versions: 2.1, 2.2, 2.3).
+        ValueError: If version is not supported (valid versions: 2.1, 2.2, 2.3,
+            3.1, 3.2, 3.3).
 
     """
 
@@ -483,7 +484,7 @@ class AsyncAmazonCreatorsApi:
         token = await self._token_manager.get_token()
 
         headers = {
-            "Authorization": f"Bearer {token}, Version {self._version}",
+            "Authorization": self._build_authorization_header(token),
             "Content-Type": "application/json; charset=utf-8",
             "x-marketplace": self.marketplace,
         }
@@ -501,6 +502,12 @@ class AsyncAmazonCreatorsApi:
 
         return response.json()
 
+    def _build_authorization_header(self, token: str) -> str:
+        """Build the version-appropriate Authorization header."""
+        if self._version.startswith("3."):
+            return f"Bearer {token}"
+        return f"Bearer {token}, Version {self._version}"
+
     def _handle_error_response(self, status_code: int, body: str) -> None:
         """Handle API error responses and raise appropriate exceptions.
 

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/amazon_creatorsapi/aio/auth.py

@@ -21,7 +21,10 @@ except ImportError as exc:  # pragma: no cover
 
 
 # OAuth2 constants
-SCOPE = "creatorsapi/default"
+COGNITO_SCOPE = "creatorsapi/default"
+LWA_SCOPE = "creatorsapi::default"
+# Backward-compatible alias for existing v2.x users.
+SCOPE = COGNITO_SCOPE
 GRANT_TYPE = "client_credentials"
 
 # Token expiration buffer in seconds (refresh 30s before actual expiration)
@@ -32,6 +35,9 @@ VERSION_ENDPOINTS = {
     "2.1": "https://creatorsapi.auth.us-east-1.amazoncognito.com/oauth2/token",
     "2.2": "https://creatorsapi.auth.eu-south-2.amazoncognito.com/oauth2/token",
     "2.3": "https://creatorsapi.auth.us-west-2.amazoncognito.com/oauth2/token",
+    "3.1": "https://api.amazon.com/auth/o2/token",
+    "3.2": "https://api.amazon.co.uk/auth/o2/token",
+    "3.3": "https://api.amazon.co.jp/auth/o2/token",
 }
 
 
@@ -97,6 +103,14 @@ class AsyncOAuth2TokenManager:
 
         return VERSION_ENDPOINTS[version]
 
+    def is_lwa(self) -> bool:
+        """Return whether this token manager uses the LWA auth flow."""
+        return self._version.startswith("3.")
+
+    def get_scope(self) -> str:
+        """Return the version-appropriate OAuth2 scope."""
+        return LWA_SCOPE if self.is_lwa() else COGNITO_SCOPE
+
     @property
     def lock(self) -> asyncio.Lock:
         """Lazy initialization of the asyncio.Lock.
@@ -168,20 +182,23 @@ class AsyncOAuth2TokenManager:
             "grant_type": GRANT_TYPE,
             "client_id": self._credential_id,
             "client_secret": self._credential_secret,
-            "scope": SCOPE,
-        }
-
-        headers = {
-            "Content-Type": "application/x-www-form-urlencoded",
+            "scope": self.get_scope(),
         }
 
         try:
             async with httpx.AsyncClient() as client:
-                response = await client.post(
-                    self._auth_endpoint,
-                    data=request_data,
-                    headers=headers,
-                )
+                if self.is_lwa():
+                    response = await client.post(
+                        self._auth_endpoint,
+                        json=request_data,
+                        headers={"Content-Type": "application/json"},
+                    )
+                else:
+                    response = await client.post(
+                        self._auth_endpoint,
+                        data=request_data,
+                        headers={"Content-Type": "application/x-www-form-urlencoded"},
+                    )
 
             if response.status_code != 200:  # noqa: PLR2004
                 self.clear_token()

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/creatorsapi_python_sdk/__init__.py

@@ -123,5 +123,6 @@ from creatorsapi_python_sdk.models.validation_exception_response_content import
 from creatorsapi_python_sdk.models.variation_attribute import VariationAttribute
 from creatorsapi_python_sdk.models.variation_dimension import VariationDimension
 from creatorsapi_python_sdk.models.variation_summary import VariationSummary
+from creatorsapi_python_sdk.models.variation_summary_price import VariationSummaryPrice
 from creatorsapi_python_sdk.models.variations_result import VariationsResult
 from creatorsapi_python_sdk.models.website_sales_rank import WebsiteSalesRank

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/creatorsapi_python_sdk/api/default_api.py

@@ -424,6 +424,7 @@ class DefaultApi:
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
             '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(
@@ -500,6 +501,7 @@ class DefaultApi:
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
             '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(
@@ -576,6 +578,7 @@ class DefaultApi:
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
             '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(
@@ -1026,6 +1029,7 @@ class DefaultApi:
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
             '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(
@@ -1102,6 +1106,7 @@ class DefaultApi:
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
             '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(
@@ -1178,6 +1183,7 @@ class DefaultApi:
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
             '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(
@@ -1627,6 +1633,7 @@ class DefaultApi:
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
             '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(
@@ -1699,6 +1706,7 @@ class DefaultApi:
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
             '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(
@@ -1771,6 +1779,7 @@ class DefaultApi:
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
             '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(
@@ -1899,6 +1908,8 @@ class DefaultApi:
             '400': "ValidationExceptionResponseContent",
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
+            '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(
@@ -1970,6 +1981,8 @@ class DefaultApi:
             '400': "ValidationExceptionResponseContent",
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
+            '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(
@@ -2041,6 +2054,8 @@ class DefaultApi:
             '400': "ValidationExceptionResponseContent",
             '401': "UnauthorizedExceptionResponseContent",
             '403': "AccessDeniedExceptionResponseContent",
+            '404': "ResourceNotFoundExceptionResponseContent",
+            '429': "ThrottleExceptionResponseContent",
             '500': "InternalServerExceptionResponseContent",
         }
         response_data = self.api_client.call_api(

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/creatorsapi_python_sdk/api_client.py

@@ -107,7 +107,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'creatorsapi-python-sdk/1.1.2'
+        self.user_agent = 'creatorsapi-python-sdk/1.2.0'
         self.client_side_validation = configuration.client_side_validation
         
         # OAuth2 properties
@@ -387,8 +387,11 @@ class ApiClient:
                         self._token_manager = OAuth2TokenManager(config)
             # Get token (will use cached token if valid)
             token = self._token_manager.get_token()
-            # Add Authorization headers
-            header_params['Authorization'] = 'Bearer {}, Version {}'.format(token, self.version)
+            # Add Authorization headers - Version only for v2.x
+            if self.version.startswith("3."):
+                header_params['Authorization'] = 'Bearer {}'.format(token)
+            else:
+                header_params['Authorization'] = 'Bearer {}, Version {}'.format(token, self.version)
         except Exception as error:
             raise error
 

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/creatorsapi_python_sdk/auth/oauth2_config.py

@@ -24,7 +24,8 @@ class OAuth2Config:
     """OAuth2 configuration class that manages version-specific cognito endpoints"""
     
     # Constants
-    SCOPE = "creatorsapi/default"
+    COGNITO_SCOPE = "creatorsapi/default"
+    LWA_SCOPE = "creatorsapi::default"
     GRANT_TYPE = "client_credentials"
 
     def __init__(self, credential_id, credential_secret, version, auth_endpoint):
@@ -54,15 +55,30 @@ class OAuth2Config:
         if auth_endpoint and auth_endpoint.strip():
             return auth_endpoint
         
-        # Fall back to version-based defaults
+        # Cognito endpoints (v2.x)
         if version == "2.1":
             return "https://creatorsapi.auth.us-east-1.amazoncognito.com/oauth2/token"
         elif version == "2.2":
             return "https://creatorsapi.auth.eu-south-2.amazoncognito.com/oauth2/token"
         elif version == "2.3":
             return "https://creatorsapi.auth.us-west-2.amazoncognito.com/oauth2/token"
+        # LWA endpoints (v3.x)
+        elif version == "3.1":
+            return "https://api.amazon.com/auth/o2/token"
+        elif version == "3.2":
+            return "https://api.amazon.co.uk/auth/o2/token"
+        elif version == "3.3":
+            return "https://api.amazon.co.jp/auth/o2/token"
         else:
-            raise ValueError("Unsupported version: {}. Supported versions are: 2.1, 2.2, 2.3".format(version))
+            raise ValueError("Unsupported version: {}. Supported versions are: 2.1, 2.2, 2.3, 3.1, 3.2, 3.3".format(version))
+
+    def is_lwa(self):
+        """
+        Checks if this is an LWA (v3.x) configuration
+        
+        :return: True if using LWA authentication
+        """
+        return self.version.startswith("3.")
 
     def get_token_endpoint(self, version):
         """
@@ -112,7 +128,7 @@ class OAuth2Config:
         
         :return: The OAuth2 scope
         """
-        return OAuth2Config.SCOPE
+        return OAuth2Config.LWA_SCOPE if self.is_lwa() else OAuth2Config.COGNITO_SCOPE
 
     def get_grant_type(self):
         """

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/creatorsapi_python_sdk/auth/oauth2_token_manager.py

@@ -67,22 +67,35 @@ class OAuth2TokenManager:
         :raises Exception: If token refresh fails
         """
         try:
-            request_data = {
-                'grant_type': self.config.get_grant_type(),
-                'client_id': self.config.get_credential_id(),
-                'client_secret': self.config.get_credential_secret(),
-                'scope': self.config.get_scope()
-            }
-
-            headers = {
-                'Content-Type': 'application/x-www-form-urlencoded'
-            }
-
-            response = requests.post(
-                self.config.get_cognito_endpoint(),
-                data=request_data,
-                headers=headers
-            )
+            if self.config.is_lwa():
+                # LWA (v3.x) uses JSON body
+                request_data = {
+                    'grant_type': self.config.get_grant_type(),
+                    'client_id': self.config.get_credential_id(),
+                    'client_secret': self.config.get_credential_secret(),
+                    'scope': self.config.get_scope()
+                }
+                headers = {'Content-Type': 'application/json'}
+                response = requests.post(
+                    self.config.get_cognito_endpoint(),
+                    json=request_data,
+                    headers=headers
+                )
+            else:
+                # Cognito (v2.x) uses form-encoded
+                request_data = {
+                    'grant_type': self.config.get_grant_type(),
+                    'client_id': self.config.get_credential_id(),
+                    'client_secret': self.config.get_credential_secret(),
+                    'scope': self.config.get_scope()
+                }
+                headers = {'Content-Type': 'application/x-www-form-urlencoded'}
+                response = requests.post(
+                    self.config.get_cognito_endpoint(),
+                    data=request_data,
+                    headers=headers
+                )
+
             if response.status_code != 200:
                 raise Exception("OAuth2 token request failed with status {}: {}".format(response.status_code, response.text))
 

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/creatorsapi_python_sdk/models/__init__.py

@@ -106,5 +106,6 @@ from creatorsapi_python_sdk.models.validation_exception_response_content import
 from creatorsapi_python_sdk.models.variation_attribute import VariationAttribute
 from creatorsapi_python_sdk.models.variation_dimension import VariationDimension
 from creatorsapi_python_sdk.models.variation_summary import VariationSummary
+from creatorsapi_python_sdk.models.variation_summary_price import VariationSummaryPrice
 from creatorsapi_python_sdk.models.variations_result import VariationsResult
 from creatorsapi_python_sdk.models.website_sales_rank import WebsiteSalesRank

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/creatorsapi_python_sdk/models/variation_summary.py

@@ -26,6 +26,7 @@ import json
 from pydantic import BaseModel, ConfigDict, Field, StrictFloat, StrictInt
 from typing import Any, ClassVar, Dict, List, Optional, Union
 from creatorsapi_python_sdk.models.variation_dimension import VariationDimension
+from creatorsapi_python_sdk.models.variation_summary_price import VariationSummaryPrice
 from typing import Optional, Set
 from typing_extensions import Self
 
@@ -34,9 +35,10 @@ class VariationSummary(BaseModel):
     The container for Variations Summary response. It consists of metadata of variations response like page numbers, number of variations, Price range and Variation Dimensions.
     """ # noqa: E501
     page_count: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="Number of pages in the variation result set.", alias="pageCount")
+    price: Optional[VariationSummaryPrice] = None
     variation_count: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="Total number of variations available for the product. This represents the complete count of all child ASINs across all pages. Use this value along with pageCount to understand the full scope of available variations.", alias="variationCount")
     variation_dimensions: Optional[List[VariationDimension]] = Field(default=None, description="List of variation dimensions associated with the product. Variation dimensions define the attributes on which products vary (e.g., size, color). Each dimension includes: - Display name and locale for presentation - Dimension name (internal identifier) - List of all possible values for that dimension  For example, a clothing item might have two dimensions: 'Size' with values ['S', 'M', 'L'] and 'Color' with values ['Red', 'Blue', 'Green']. These dimensions help users understand how variations differ from each other.", alias="variationDimensions")
-    __properties: ClassVar[List[str]] = ["pageCount", "variationCount", "variationDimensions"]
+    __properties: ClassVar[List[str]] = ["pageCount", "price", "variationCount", "variationDimensions"]
 
     model_config = ConfigDict(
         populate_by_name=True,
@@ -76,6 +78,9 @@ class VariationSummary(BaseModel):
             exclude=excluded_fields,
             exclude_none=True,
         )
+        # override the default output from pydantic by calling `to_dict()` of price
+        if self.price:
+            _dict['price'] = self.price.to_dict()
         # override the default output from pydantic by calling `to_dict()` of each item in variation_dimensions (list)
         _items = []
         if self.variation_dimensions:
@@ -96,6 +101,7 @@ class VariationSummary(BaseModel):
 
         _obj = cls.model_validate({
             "pageCount": obj.get("pageCount"),
+            "price": VariationSummaryPrice.from_dict(obj["price"]) if obj.get("price") is not None else None,
             "variationCount": obj.get("variationCount"),
             "variationDimensions": [VariationDimension.from_dict(_item) for _item in obj["variationDimensions"]] if obj.get("variationDimensions") is not None else None
         })

python_amazon_paapi-6.2.0/creatorsapi_python_sdk/models/variation_summary_price.py

@@ -0,0 +1,101 @@
+# coding: utf-8
+
+"""
+Copyright 2025 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License").
+You may not use this file except in compliance with the License.
+A copy of the License is located at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+or in the "license" file accompanying this file. This file is distributed
+on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+express or implied. See the License for the specific language governing
+permissions and limitations under the License.
+
+"""  # noqa: E501
+
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, Field
+from typing import Any, ClassVar, Dict, List, Optional
+from creatorsapi_python_sdk.models.money import Money
+from typing import Optional, Set
+from typing_extensions import Self
+
+class VariationSummaryPrice(BaseModel):
+    """
+    The container for highest and lowest price for variations.
+    """ # noqa: E501
+    highest_price: Optional[Money] = Field(default=None, alias="highestPrice")
+    lowest_price: Optional[Money] = Field(default=None, alias="lowestPrice")
+    __properties: ClassVar[List[str]] = ["highestPrice", "lowestPrice"]
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        return self.model_dump_json(by_alias=True, exclude_unset=True)
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of VariationSummaryPrice from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        # override the default output from pydantic by calling `to_dict()` of highest_price
+        if self.highest_price:
+            _dict['highestPrice'] = self.highest_price.to_dict()
+        # override the default output from pydantic by calling `to_dict()` of lowest_price
+        if self.lowest_price:
+            _dict['lowestPrice'] = self.lowest_price.to_dict()
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of VariationSummaryPrice from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "highestPrice": Money.from_dict(obj["highestPrice"]) if obj.get("highestPrice") is not None else None,
+            "lowestPrice": Money.from_dict(obj["lowestPrice"]) if obj.get("lowestPrice") is not None else None
+        })
+        return _obj
+
+

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/docs/conf.py

@@ -23,7 +23,7 @@ copyright = "2026, Sergio Abad"
 author = "Sergio Abad"
 
 # The full version, including alpha/beta/rc tags
-release = "6.1.0"
+release = "6.2.0"
 
 
 # -- General configuration ---------------------------------------------------

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-amazon-paapi"
-version = "6.1.0"
+version = "6.2.0"
 description = "Amazon Product Advertising API 5.0 wrapper for Python"
 readme = "README.md"
 requires-python = ">=3.9"

{python_amazon_paapi-6.1.0 → python_amazon_paapi-6.2.0}/tests/amazon_creatorsapi/aio/api_test.py

@@ -68,6 +68,19 @@ class TestAsyncAmazonCreatorsApiInit(unittest.TestCase):
 
         self.assertEqual(api.throttling, 2.5)
 
+    @patch("amazon_creatorsapi.aio.api.AsyncOAuth2TokenManager")
+    def test_accepts_lwa_version(self, mock_token_manager: MagicMock) -> None:
+        """Test initialization accepts an LWA-backed 3.x version."""
+        api = AsyncAmazonCreatorsApi(
+            credential_id="test_id",
+            credential_secret="test_secret",
+            version="3.1",
+            tag="test-tag",
+            country="US",
+        )
+
+        self.assertEqual(api.marketplace, "www.amazon.com")
+
     @patch("amazon_creatorsapi.aio.api.AsyncOAuth2TokenManager")
     def test_raises_error_when_no_country_or_marketplace(
         self, mock_token_manager: MagicMock
@@ -1204,6 +1217,80 @@ class TestAsyncAmazonCreatorsApiWithoutContextManager(unittest.IsolatedAsyncioTe
 
         self.assertEqual(len(items), 1)
 
+    @patch("amazon_creatorsapi.aio.api.AsyncOAuth2TokenManager")
+    @patch("amazon_creatorsapi.aio.api.AsyncHttpClient")
+    async def test_request_uses_v2_authorization_header(
+        self,
+        mock_http_client_class: MagicMock,
+        mock_token_manager_class: MagicMock,
+    ) -> None:
+        """Test v2 requests include the version suffix in Authorization."""
+        mock_response = MagicMock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {
+            "itemsResult": {"items": [{"ASIN": "B0DLFMFBJW"}]}
+        }
+
+        mock_client = AsyncMock()
+        mock_client.post.return_value = mock_response
+        mock_client.__aenter__.return_value = mock_client
+        mock_http_client_class.return_value = mock_client
+
+        mock_token_manager = AsyncMock()
+        mock_token_manager.get_token.return_value = "test_token"
+        mock_token_manager_class.return_value = mock_token_manager
+
+        api = AsyncAmazonCreatorsApi(
+            credential_id="test_id",
+            credential_secret="test_secret",
+            version="2.2",
+            tag="test-tag",
+            country="ES",
+            throttling=0,
+        )
+
+        await api.get_items(["B0DLFMFBJW"])
+
+        headers = mock_client.post.call_args.args[1]
+        self.assertEqual(headers["Authorization"], "Bearer test_token, Version 2.2")
+
+    @patch("amazon_creatorsapi.aio.api.AsyncOAuth2TokenManager")
+    @patch("amazon_creatorsapi.aio.api.AsyncHttpClient")
+    async def test_request_uses_lwa_authorization_header(
+        self,
+        mock_http_client_class: MagicMock,
+        mock_token_manager_class: MagicMock,
+    ) -> None:
+        """Test v3 requests omit the version suffix in Authorization."""
+        mock_response = MagicMock()
+        mock_response.status_code = 200
+        mock_response.json.return_value = {
+            "itemsResult": {"items": [{"ASIN": "B0DLFMFBJW"}]}
+        }
+
+        mock_client = AsyncMock()
+        mock_client.post.return_value = mock_response
+        mock_client.__aenter__.return_value = mock_client
+        mock_http_client_class.return_value = mock_client
+
+        mock_token_manager = AsyncMock()
+        mock_token_manager.get_token.return_value = "test_token"
+        mock_token_manager_class.return_value = mock_token_manager
+
+        api = AsyncAmazonCreatorsApi(
+            credential_id="test_id",
+            credential_secret="test_secret",
+            version="3.1",
+            tag="test-tag",
+            country="US",
+            throttling=0,
+        )
+
+        await api.get_items(["B0DLFMFBJW"])
+
+        headers = mock_client.post.call_args.args[1]
+        self.assertEqual(headers["Authorization"], "Bearer test_token")
+
 
 if __name__ == "__main__":
     unittest.main()