Python Amazon Creators API

A Python wrapper for the Amazon Creators API, which lets you search Amazon products, read their details, offers and variations, and list the feeds and reports of your account.

Install it with:

pip install python-amazon-paapi --upgrade

Then create a client with the credentials of the Amazon Associates Creators API portal:

from amazon_creatorsapi import AmazonCreatorsApi, Country

api = AmazonCreatorsApi(
    credential_id="your_credential_id",
    credential_secret="your_credential_secret",
    version="2.2",
    tag="your-affiliate-tag",
    country=Country.US,
)

items = api.get_items(["B01N5IB20Q"])
print(items[0].item_info.title.display_value)

The usage guide covers every option of the client, the asynchronous version and the errors it raises.

Introduction

• Usage guide
  • Installation
  • Credentials
  • Basic usage
  • Get multiple items
  • Search products
  • Get product variations
  • Get browse node information
  • Feeds and reports
  • Get the ASIN from URL
  • Using OffersV2 resources
  • Throttling
  • Timeout
  • Retries
  • Closing the client
  • Custom endpoints
  • Error handling
  • Async support
  • Working with models

API Reference

• API module
  • AmazonCreatorsApi
• Async API module
  • Installation
  • Usage
  • API Reference
• Errors
  • AccessDeniedError
  • AmazonCreatorsApiError
  • AssociateValidationError
  • AuthenticationError
  • InvalidArgumentError
  • ItemsNotFoundError
  • RequestError
  • ResourceNotFoundError
  • TooManyRequestsError
• Core utilities
  • Country
  • get_asin()

• Models

Migration guides

Follow the version 7 guide to upgrade code written for amazon_creatorsapi on version 6. If you are still using the removed amazon_paapi module, start with the Creators API guide instead.

• Version 7 migration guide
• Creators API migration guide

Changelog

See the changelog for a detailed history of changes.

Support

Ask for help in the Telegram group or open an issue on GitHub.