updated changelog and documentation

Author: sergioteula

CHANGELOG.md

@@ -5,6 +5,12 @@ 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).
 
+## [5.2.0] - 2026-01-11
+
+### Added
+
+- Support for OffersV2 resources with new model classes ([#141](https://github.com/sergioteula/python-amazon-paapi/pull/141))
+
 ## [5.1.0] - 2026-01-11
 
 ### Added

README.md

@@ -14,6 +14,7 @@ A simple Python wrapper for the [Amazon Product Advertising API 5.0](https://web
 - 🔍 **Product search** by keywords, categories, or browse nodes
 - 📦 **Product details** via ASIN or Amazon URL
 - 🔄 **Item variations** support (size, color, etc.)
+- 💰 **OffersV2 support** for enhanced pricing and offer details
 - 🌍 **20+ countries** supported ([full list](https://github.com/sergioteula/python-amazon-paapi/blob/master/amazon_paapi/models/regions.py))
 - ⚡ **Batch requests** to get multiple items without the 10-item limit
 - 🛡️ **Built-in throttling** to avoid API rate limits
@@ -40,6 +41,18 @@ print(item.item_info.title.display_value)
 
 ## Usage Examples
 
+### Using OffersV2 resources
+
+OffersV2 provides enhanced pricing and offer details. All resources are included by default, so OffersV2 data is available without any additional configuration:
+
+```python
+item = amazon.get_items('B01N5IB20Q')[0]
+if item.offers_v2 and item.offers_v2.listings:
+    listing = item.offers_v2.listings[0]
+    print(listing.price.money.amount)  # Price amount
+    print(listing.merchant_info.name)  # Merchant name
+```
+
 ### Get Multiple Products
 
 ```python

docs/conf.py

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

docs/pages/usage-guide.md

@@ -69,3 +69,18 @@ Throttling value represents the wait time in seconds between API calls, being th
 amazon = AmazonApi(KEY, SECRET, TAG, COUNTRY, throttling=4)  # Makes 1 request every 4 seconds
 amazon = AmazonApi(KEY, SECRET, TAG, COUNTRY, throttling=0)  # No wait time between requests
 ```
+
+**Using OffersV2 resources:**
+
+OffersV2 provides enhanced pricing and offer details. All resources are included by default, so OffersV2 data is available without any additional configuration:
+
+```python
+items = amazon.get_items('B01N5IB20Q')
+
+# Access OffersV2 data
+item = items[0]
+if item.offers_v2 and item.offers_v2.listings:
+    listing = item.offers_v2.listings[0]
+    print(listing.price.money.amount)  # Price amount
+    print(listing.merchant_info.name)  # Merchant name
+```

pyproject.toml

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