{"id":28113,"library":"python-amazon-paapi","title":"python-amazon-paapi","description":"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.","status":"active","version":"6.2.0","language":"python","source_language":"en","source_url":"https://github.com/sergioteula/python-amazon-paapi","tags":["amazon-api","paapi","product-advertising-api","creators-api","wrapper"],"install":[{"cmd":"pip install python-amazon-paapi","lang":"bash","label":"Standard"},{"cmd":"pip install python-amazon-paapi[async]","lang":"bash","label":"With async support"}],"dependencies":[{"reason":"Data validation for models","package":"pydantic","optional":false},{"reason":"HTTP client for synchronous API calls","package":"requests","optional":false},{"reason":"Async HTTP client (required for async)","package":"httpx","optional":true}],"imports":[{"note":"Incorrect path from older versions or custom modules","wrong":"from amazon_paapi.amazon_paapi import AmazonApi","symbol":"AmazonApi","correct":"from amazon_paapi import AmazonApi"},{"note":"Models must be imported from models submodule","wrong":"from amazon_paapi import AmazonProduct","symbol":"AmazonProduct","correct":"from amazon_paapi.models import AmazonProduct"}],"quickstart":{"code":"from amazon_paapi import AmazonApi\nfrom dotenv import load_dotenv\nimport os\nload_dotenv()\napi = AmazonApi(\n    access_key=os.environ.get('AMAZON_ACCESS_KEY', ''),\n    secret_key=os.environ.get('AMAZON_SECRET_KEY', ''),\n    associate_tag=os.environ.get('AMAZON_ASSOCIATE_TAG', ''),\n    country='US'\n)\nproducts = api.search_items(keywords='Python programming')\nif products and products.items:\n    for item in products.items:\n        print(item.item_info.title.display_value)","lang":"python","description":"Minimal usage: set environment variables AMAZON_ACCESS_KEY, AMAZON_SECRET_KEY, AMAZON_ASSOCIATE_TAG, then run."},"warnings":[{"fix":"Use amazon_creatorsapi module for new integrations, but amazon_paapi remains functional.","message":"Version 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.","severity":"breaking","affected_versions":">=6.0.0"},{"fix":"Catch new exception names: e.g., except NoResultsError.","message":"Exceptions renamed in 5.0.0. For example, NoResultsException was renamed to NoResultsError.","severity":"breaking","affected_versions":">=5.0.0"},{"fix":"Use from amazon_paapi import AmazonApi and from amazon_paapi.models import ...","message":"The old amazon module (before amazon_paapi) was removed in 5.0.0. Code relying on from amazon import ... will break.","severity":"gotcha","affected_versions":">=5.0.0"},{"fix":"Install async extra and import from amazon_creatorsapi.aio.","message":"Async support requires installing with [async] extra (pip install python-amazon-paapi[async]) and using amazon_creatorsapi.aio subpackage.","severity":"gotcha","affected_versions":">=6.1.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Ensure AMAZON_ACCESS_KEY, AMAZON_SECRET_KEY, AMAZON_ASSOCIATE_TAG are set correctly in environment or passed to AmazonApi.","cause":"Missing or incorrectly set environment variables / parameters for access_key/secret_key/associate_tag.","error":"NoCredentialsError: No valid credentials provided."},{"fix":"Check keywords, category, or availability parameters. Use broader terms or verify API resource permissions.","cause":"API call succeeded but no items matched the search query.","error":"NoResultsError: No results found."},{"fix":"Correct import: from amazon_paapi import AmazonApi","cause":"Mistakenly trying to import from a submodule or old module path.","error":"ImportError: cannot import name 'AmazonApi' from 'amazon_paapi'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}