Skip to content

Releases: RajpurohitHitesh/amazon-creatorsapi-python-sdk

v1.0.0 - Initial Release

04 Feb 18:29
@RajpurohitHitesh RajpurohitHitesh
v1.0.0
9054f76

Choose a tag to compare

View all tags
v1.0.0 - Initial Release Latest
Latest

Amazon Creators API Python SDK - Version 1.0.0

Overview

Amazon Creators API Python SDK is an official Python library designed to integrate with Amazon's Creators API (Product Advertising API). This SDK helps developers access comprehensive information about Amazon products and retrieve product data for affiliate/creator programs.

Version 1.0.0 Features

Core API Operations

1. GetItems - Product Details

  • Retrieve complete product information using ASIN (Amazon Standard Identification Number)
  • Product title, description, price, images, availability and ratings
  • Multiple ASINs can be queried together
  • Customizable resource parameters for specific data fields

2. SearchItems - Product Search

  • Search for products using keywords
  • Advanced filtering options (price range, brand, category)
  • Sort options (price, relevance, rating, newest)
  • Pagination support for large result sets
  • Category and browse node filtering

3. GetBrowseNodes - Category Navigation

  • Explore Amazon's category hierarchy
  • Browse node information (name, ID, children, ancestors)
  • For traversing category structure
  • Sales rank information by category

4. GetVariations - Product Variations

  • Retrieve product's different variations (size, color, style)
  • Parent-child product relationships
  • Variation dimensions and attributes
  • Variant-specific pricing and availability

5. GetFeed - Curated Product Feeds

  • Access pre-curated product feeds
  • Deal feeds, best seller feeds
  • Category-specific product collections
  • Time-based product listings

6. ListFeeds - Available Feeds Discovery

  • List available product feeds
  • Feed metadata and descriptions
  • Marketplace-specific feed availability

7. GetReport - Analytics & Reports

  • Product performance reports
  • Sales and traffic analytics
  • Custom reporting data

8. ListReports - Report Discovery

  • List available reports
  • Report types and parameters
  • Historical report access

Technical Features

Authentication & Security

  • OAuth 2.0 Support - Secure authentication mechanism
  • Token management with automatic refresh
  • Credential versioning (2.1, 2.2, 2.3 for different regions)
  • Environment-based configuration

Multi-Marketplace Support

All global Amazon marketplaces supported:

  • North America: US (amazon.com), Canada (amazon.ca), Mexico (amazon.com.mx)
  • Europe: UK, Germany, France, Italy, Spain, Netherlands, Poland, Turkey
  • Asia Pacific: Japan, India, China, Singapore, Australia, UAE, Saudi Arabia, Egypt
  • Brazil: amazon.com.br

Data Models

  • Pydantic-based models for type safety
  • Comprehensive data validation
  • Auto-generated from OpenAPI specs
  • Rich response objects with nested data structures

Developer-Friendly

  • Type hints throughout the codebase
  • Detailed docstrings and documentation
  • Sample code for all operations (8 example files included)
  • Error handling with custom exceptions
  • HTTP response details access

SDK Architecture

creatorsapi_python_sdk/
├── api/                    # API client implementations
│   └── default_api.py      # All 8 API operations
├── auth/                   # Authentication modules
│   ├── oauth2_config.py    # OAuth configuration
│   └── oauth2_token_manager.py
├── models/                 # 80+ data models
│   ├── Item, Offer, Image models
│   ├── BrowseNode, Search models
│   └── Request/Response models
└── Core modules
    ├── api_client.py       # HTTP client wrapper
    ├── configuration.py    # SDK configuration
    ├── exceptions.py       # Custom exceptions
    └── rest.py            # REST utilities

Requirements

  • Python: 3.7 or higher
  • Dependencies:
    • pydantic >= 2 - Data validation
    • requests >= 2.25.0 - HTTP requests
    • urllib3 >= 1.25.3, < 2.1.0 - URL handling
    • python_dateutil >= 2.5.3 - Date utilities
    • typing-extensions >= 4.7.1 - Type support

Installation

pip install amazon-creatorsapi-python-sdk

Quick Start Example

from creatorsapi_python_sdk import ApiClient, Configuration, DefaultApi
from creatorsapi_python_sdk.auth.oauth2_config import OAuth2Config

# Configuration
config = Configuration()
oauth_config = OAuth2Config(
    credential_id="YOUR_CREDENTIAL_ID",
    credential_secret="YOUR_CREDENTIAL_SECRET",
    credential_version="2.1"
)

# API Client
client = ApiClient(configuration=config, oauth2_config=oauth_config)
api = DefaultApi(api_client=client)

# GetItems Example
from creatorsapi_python_sdk.models import GetItemsRequestContent

request = GetItemsRequestContent(
    item_ids=["B08N5WRWNW"],
    resources=["Images.Primary.Large", "ItemInfo.Title", "Offers.Listings.Price"]
)

response = api.get_items(
    x_marketplace="www.amazon.com",
    get_items_request_content=request
)

print(response.items_result.items[0].item_info.title.display_value)

Use Cases

  • Content Creators: For product recommendations and reviews
  • Affiliate Marketers: Product links to earn commissions
  • Price Comparison Sites: Real-time pricing data
  • E-commerce Tools: Product catalog integration
  • Analytics Platforms: Market research and trends analysis
  • Mobile Apps: Shopping and deals applications
  • Browser Extensions: Price tracking and deal alerts

License

Apache License 2.0 - Amazon.com, Inc. or its affiliates

Support & Resources

  • Examples: 8 comprehensive sample files included
  • Documentation: Detailed API documentation
  • Type Safety: Full type hints for IDE autocomplete
  • Error Handling: Clear exception messages

Version 1.0.0 - Production-ready stable release
Release Date: 2025
Publisher: Amazon

Assets 2
Loading