Package: amightygirl.paapi5-python-sdk
Product Advertising API 5.0 SDK for Python (v1)About This PackageThis repository contains the official Product Advertising API 5.0 Python SDK calledpaapi5-python-sdkthat allows you to access theProduct Advertising API.The code in this package was written entirely by Amazon.com. Based on the original documentation, it appears that Amazon originally intended to make this package available viapip; however, it appears that either (a) that never happened or (b) they removed it. We created this package to correct that.The only changes we made to Amazon's original package were:Modifying this README file to reflect the correct pip package informationModifying the setup.py fileDocumentation and Original SDKAmazon's documentation for the Product Advertising API can be found at:https://webservices.amazon.com/paapi5/documentation/index.htmlYou can download the original SDK from Amazon.com at:https://webservices.amazon.com/paapi5/documentation/quick-start/using-sdk.htmlRequirementsPython 2.7 and 3.4+Installation & Usagepip installYou can directly install it from pip using:pipinstallamightygirl.paapi5-python-sdkThen import the package:importpaapi5_python_sdkGetting StartedPlease follow theinstallation procedureand then run the following:Simple example forSearchItemsto discover Amazon products with the keyword 'Harry Potter' in All categories:from__future__importprint_functionfrompaapi5_python_sdk.api.default_apiimportDefaultApifrompaapi5_python_sdk.search_items_requestimportSearchItemsRequestfrompaapi5_python_sdk.search_items_resourceimportSearchItemsResourcefrompaapi5_python_sdk.partner_typeimportPartnerTypefrompaapi5_python_sdk.restimportApiExceptiondefsearch_items():""" Following are your credentials """""" Please add your access key here """access_key="<YOUR ACCESS KEY>"""" Please add your secret key here """secret_key="<YOUR SECRET KEY>"""" Please add your partner tag (store/tracking id) here """partner_tag="<YOUR PARTNER TAG>"""" PAAPI Host and Region to which you want to send request """""" For more details refer: https://webservices.amazon.com/paapi5/documentation/common-request-parameters.html#host-and-region"""host="webservices.amazon.com"region="us-east-1"""" API declaration """default_api=DefaultApi(access_key=access_key,secret_key=secret_key,host=host,region=region)""" Request initialization"""""" Specify keywords """keywords="Harry Potter"""" Specify the category in which search request is to be made """""" For more details, refer: https://webservices.amazon.com/paapi5/documentation/use-cases/organization-of-items-on-amazon/search-index.html """search_index="All"""" Specify item count to be returned in search result """item_count=1""" Choose resources you want from SearchItemsResource enum """""" For more details, refer: https://webservices.amazon.com/paapi5/documentation/search-items.html#resources-parameter """search_items_resource=[SearchItemsResource.IMAGES_PRIMARY_LARGE,SearchItemsResource.ITEMINFO_TITLE,SearchItemsResource.OFFERS_LISTINGS_PRICE,]""" Forming request """try:search_items_request=SearchItemsRequest(partner_tag=partner_tag,partner_type=PartnerType.ASSOCIATES,keywords=keywords,search_index=search_index,item_count=item_count,resources=search_items_resource,)exceptValueErrorasexception:print("Error in forming SearchItemsRequest: ",exception)returntry:""" Sending request """response=default_api.search_items(search_items_request)print("API called Successfully")print("Complete Response:",response)""" Parse response """ifresponse.search_resultisnotNone:print("Printing first item information in SearchResult:")item_0=response.search_result.items[0]ifitem_0isnotNone:ifitem_0.asinisnotNone:print("ASIN: ",item_0.asin)ifitem_0.detail_page_urlisnotNone:print("DetailPageURL: ",item_0.detail_page_url)if(item_0.item_infoisnotNoneanditem_0.item_info.titleisnotNoneanditem_0.item_info.title.display_valueisnotNone):print("Title: ",item_0.item_info.title.display_value)if(item_0.offersisnotNoneanditem_0.offers.listingsisnotNoneanditem_0.offers.listings[0].priceisnotNoneanditem_0.offers.listings[0].price.display_amountisnotNone):print("Buying Price: ",item_0.offers.listings[0].price.display_amount)ifresponse.errorsisnotNone:print("\nPrinting Errors:\nPrinting First Error Object from list of Errors")print("Error code",response.errors[0].code)print("Error message",response.errors[0].message)exceptApiExceptionasexception:print("Error calling PA-API 5.0!")print("Status code:",exception.status)print("Errors :",exception.body)print("Request ID:",exception.headers["x-amzn-RequestId"])exceptTypeErrorasexception:print("TypeError :",exception)exceptValueErrorasexception:print("ValueError :",exception)exceptExceptionasexception:print("Exception :",exception)search_items()Complete documentation, installation instructions, and examples are availablehere.LicenseThis SDK is distributed under theApache License, Version 2.0,
see LICENSE.txt and NOTICE.txt for more information.