docs: Update and expand usage examples in documentation, including API client variable renaming and new examples for browse nodes and ASIN extraction.

Author: sergioteula

README.md

@@ -53,6 +53,14 @@ items = api.get_items(["https://www.amazon.com/dp/B01N5IB20Q"])
 
 ## Usage Examples
 
+### Get Multiple Items
+
+```python
+items = api.get_items(["B01N5IB20Q", "B01F9G43WU"])
+for item in items:
+    print(item.images.primary.large.url)
+```
+
 ### Search Products
 
 ```python
@@ -82,6 +90,14 @@ for node in nodes:
     print(node.display_name)
 ```
 
+### Get the ASIN from URL
+
+```python
+from amazon_creatorsapi import get_asin
+
+asin = get_asin("https://www.amazon.com/dp/B01N5IB20Q")
+```
+
 ### Using OffersV2 Resources
 
 ```python

docs/pages/usage-guide.md

@@ -2,75 +2,107 @@
 
 You can install or upgrade the module with:
 
-    pip install python-amazon-paapi --upgrade
+```bash
+pip install python-amazon-paapi --upgrade
+```
 
 # Usage Guide
 
-The new `amazon_creatorsapi` module provides access to Amazon's Creators API.
+The `amazon_creatorsapi` module provides access to Amazon's Creators API.
 
 > **Note:** The `amazon_paapi` module is deprecated. New projects should use the Creators API.
 
-**Basic usage:**
+## Basic Usage
 
 ```python
 from amazon_creatorsapi import AmazonCreatorsApi, Country
 
-amazon = AmazonCreatorsApi(
-    credential_id='YOUR_CREDENTIAL_ID',
-    credential_secret='YOUR_CREDENTIAL_SECRET',
-    version='2.2',
-    tag='YOUR_TAG',
-    country=Country.US
+api = AmazonCreatorsApi(
+    credential_id="your_credential_id",
+    credential_secret="your_credential_secret",
+    version="2.2",
+    tag="your-affiliate-tag",
+    country=Country.US,
 )
 
-item = amazon.get_items('B01N5IB20Q')[0]
-print(item.item_info.title.display_value)  # Item title
+# Get product information by ASIN
+items = api.get_items(["B01N5IB20Q"])
+print(items[0].item_info.title.display_value)
+
+# Or use Amazon URLs directly
+items = api.get_items(["https://www.amazon.com/dp/B01N5IB20Q"])
 ```
 
-**Get multiple items information:**
+## Get Multiple Items
 
 ```python
-items = amazon.get_items(['B01N5IB20Q', 'B01F9G43WU'])
+items = api.get_items(["B01N5IB20Q", "B01F9G43WU"])
 for item in items:
-    print(item.images.primary.large.url)  # Primary image url
+    print(item.images.primary.large.url)
 ```
 
-**Search items:**
+## Search Products
 
 ```python
-search_result = amazon.search_items(keywords='nintendo')
-for item in search_result.items:
-    print(item.asin)  # Item ASIN
+results = api.search_items(keywords="nintendo switch")
+for item in results.items:
+    print(item.item_info.title.display_value)
 ```
 
-**Get item variations:**
+## Get Product Variations
 
 ```python
-variations = amazon.get_variations('B01N5IB20Q')
+# Using ASIN
+variations = api.get_variations("B01N5IB20Q")
+
+# Or using Amazon URL
+variations = api.get_variations("https://www.amazon.com/dp/B01N5IB20Q")
+
 for item in variations.items:
-    print(item.detail_page_url)  # Affiliate url
+    print(item.detail_page_url)
 ```
 
-**Get the ASIN from URL:**
+## Get Browse Node Information
 
 ```python
-from amazon_creatorsapi.core import get_asin
+nodes = api.get_browse_nodes(["667049031"])
+for node in nodes:
+    print(node.display_name)
+```
+
+## Get the ASIN from URL
 
-asin = get_asin('https://www.amazon.com/dp/B01N5IB20Q')
+```python
+from amazon_creatorsapi import get_asin
+
+asin = get_asin("https://www.amazon.com/dp/B01N5IB20Q")
 ```
 
-**Throttling:**
+## Using OffersV2 Resources
+
+OffersV2 provides enhanced pricing and offer details. All resources are included by default:
+
+```python
+items = api.get_items(["B01N5IB20Q"])
+item = items[0]
+if item.offers_v2 and item.offers_v2.listings:
+    listing = item.offers_v2.listings[0]
+    print(listing.price.money.amount)
+    print(listing.merchant_info.name)
+```
+
+## Throttling
 
 Throttling value represents the wait time in seconds between API calls, being the default value 1 second. Use it to avoid reaching Amazon request limits.
 
 ```python
-amazon = AmazonCreatorsApi(ID, SECRET, VERSION, TAG, COUNTRY, throttling=4)  # Makes 1 request every 4 seconds
-amazon = AmazonCreatorsApi(ID, SECRET, VERSION, TAG, COUNTRY, throttling=0)  # No wait time between requests
+api = AmazonCreatorsApi(ID, SECRET, VERSION, TAG, COUNTRY, throttling=4)  # Makes 1 request every 4 seconds
+api = AmazonCreatorsApi(ID, SECRET, VERSION, TAG, COUNTRY, throttling=0)  # No wait time between requests
 ```
 
-**Working with Models:**
+## Working with Models
 
-All SDK models are available through the `models` module for convenient access:
+All SDK models are re-exported through `amazon_creatorsapi.models` for convenient access:
 
 ```python
 from amazon_creatorsapi.models import (
@@ -82,27 +114,13 @@ from amazon_creatorsapi.models import (
 )
 
 # Use Condition enum for filtering
-items = amazon.get_items(['B01N5IB20Q'], condition=Condition.NEW)
+items = api.get_items(["B01N5IB20Q"], condition=Condition.NEW)
 
 # Use SortBy enum for search ordering
-results = amazon.search_items(keywords='laptop', sort_by=SortBy.PRICE_LOW_TO_HIGH)
+results = api.search_items(keywords="laptop", sort_by=SortBy.PRICE_LOW_TO_HIGH)
 
 # Specify which resources to retrieve
+from amazon_creatorsapi.models import GetItemsResource
 resources = [GetItemsResource.ITEMINFO_TITLE, GetItemsResource.OFFERS_LISTINGS_PRICE]
-items = amazon.get_items(['B01N5IB20Q'], resources=resources)
-```
-
-**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
+items = api.get_items(["B01N5IB20Q"], resources=resources)
 ```