Registry / aws / python-amazon-paapi

python-amazon-paapi

JSON →
library6.2.0pypypi✓ verified 86d ago

Wrapper for Amazon Product Advertising API 5.0 and Amazon Creators API. Current version 6.2.0, supports Python >=3.9. Active development with regular releases.

awshttp-networking
pip install python-amazon-paapi
github ↗package ↗
INSTALL
IMPORT
SIG · PYTHON-AMAZON-PAAP
P
python-amazon-paapi
awspythonv6.2.0
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

AmazonApi
✓ from amazon_paapi import AmazonApi
✗ from amazon_paapi.amazon_paapi import AmazonApi
Incorrect path from older versions or custom modules
AmazonProduct
✓ from amazon_paapi.models import AmazonProduct
✗ from amazon_paapi import AmazonProduct
Models must be imported from models submodule

Minimal usage: set environment variables AMAZON_ACCESS_KEY, AMAZON_SECRET_KEY, AMAZON_ASSOCIATE_TAG, then run.

from amazon_paapi import AmazonApi from dotenv import load_dotenv import os load_dotenv() api = AmazonApi( access_key=os.environ.get('AMAZON_ACCESS_KEY', ''), secret_key=os.environ.get('AMAZON_SECRET_KEY', ''), associate_tag=os.environ.get('AMAZON_ASSOCIATE_TAG', ''), country='US' ) products = api.search_items(keywords='Python programming') if products and products.items: for item in products.items: print(item.item_info.title.display_value)
Debug
Known issues
breakingVersion 6.0.0 deprecated the amazon_paapi module in favor of amazon_creatorsapi for new projects. Old Amazon Product Advertising API 5.0 still works but is deprecated.
fix
Use amazon_creatorsapi module for new integrations, but amazon_paapi remains functional.
affects: >=6.0.0
breakingExceptions renamed in 5.0.0. For example, NoResultsException was renamed to NoResultsError.
fix
Catch new exception names: e.g., except NoResultsError.
affects: >=5.0.0
gotchaThe old amazon module (before amazon_paapi) was removed in 5.0.0. Code relying on from amazon import ... will break.
fix
Use from amazon_paapi import AmazonApi and from amazon_paapi.models import ...
affects: >=5.0.0
gotchaAsync support requires installing with [async] extra (pip install python-amazon-paapi[async]) and using amazon_creatorsapi.aio subpackage.
fix
Install async extra and import from amazon_creatorsapi.aio.
affects: >=6.1.0
Errors
Common errors & fixes
NoCredentialsError: No valid credentials provided.
Missing or incorrectly set environment variables / parameters for access_key/secret_key/associate_tag.
fix
Ensure AMAZON_ACCESS_KEY, AMAZON_SECRET_KEY, AMAZON_ASSOCIATE_TAG are set correctly in environment or passed to AmazonApi.
NoResultsError: No results found.
API call succeeded but no items matched the search query.
fix
Check keywords, category, or availability parameters. Use broader terms or verify API resource permissions.
ImportError: cannot import name 'AmazonApi' from 'amazon_paapi'
Mistakenly trying to import from a submodule or old module path.
fix
Correct import: from amazon_paapi import AmazonApi
Upgrade
Version history
6.2.0latest on PyPI · released Mar 12, 2026
Audit
Dependencies
pydanticrequiredData validation for models
requestsrequiredHTTP client for synchronous API calls
httpxoptionalAsync HTTP client (required for async)
Agent activity
18 hits · last 30 days
node
8
Resources
githubhttps://github.com/sergioteula/python-amazon-paapi ↗
packagehttps://pypi.org/project/python-amazon-paapi/ ↗
python-amazon-paapi — pip install python-amazon-paapi · libregistry