def get_products(self,
asins,
serialize=False,
marketplace='www.amazon.com',
resources=None,
**kwargs):
"""
:param asins (string): One or more ItemIds like ASIN that
uniquely identify an item or product URL. (Max 10) Seperated
by comma or as a list.
"""
item_ids = asins if type(asins) is list else [asins]
# Wait before doing the request
wait_time = 1 / self.throttling - (time.time() - self.last_query_time)
if wait_time > 0:
time.sleep(wait_time)
self.last_query_time = time.time()
try:
_resources = (self.RESOURCES[resources]
if resources else self.RESOURCES['import'])
request = GetItemsRequest(partner_tag=self.tag,
partner_type=PartnerType.ASSOCIATES,
marketplace=marketplace,
item_ids=item_ids,
resources=_resources,
**kwargs)
response = self.api.get_items(request)
products = response.items_result.items
return (products if not serialize else
[self.serialize(p) for p in products])
except Exception as exception:
raise exception
def get_products(self,
asins,
serialize=False,
marketplace='www.amazon.com',
resources=None,
**kwargs):
"""
:param asins (string): One or more ItemIds like ASIN that
uniquely identify an item or product URL. (Max 10) Seperated
by comma or as a list.
"""
# Wait before doing the request
wait_time = 1 / self.throttling - (time.time() - self.last_query_time)
if wait_time > 0:
time.sleep(wait_time)
self.last_query_time = time.time()
item_ids = asins if type(asins) is list else [asins]
_resources = self.RESOURCES[resources or 'import']
try:
request = GetItemsRequest(partner_tag=self.tag,
partner_type=PartnerType.ASSOCIATES,
marketplace=marketplace,
item_ids=item_ids,
resources=_resources,
**kwargs)
except ApiException:
logger.error("Amazon fetch failed for: %s" % ', '.join(item_ids),
exc_info=True)
return None
response = self.api.get_items(request)
products = [p for p in response.items_result.items
if p] if response.items_result else []
return (products
if not serialize else [self.serialize(p) for p in products])
def get_products(self,
product_ids: [str, list],
condition='Any',
merchant='All',
async_req=False):
"""Find product information for multiple products on Amazon.
Args:
product_ids (str|list): One or more item IDs like ASIN or product URL.
Use a string separated by comma or as a list.
condition (str, optional): Specify the product condition.
Allowed values: Any, Collectible, New, Refurbished, Used.
Defaults to Any.
merchant (str, optional): Filters search results to return items
having at least one offer sold by target merchant. Allowed values:
All, Amazon. Defaults to All.
async_req (bool, optional): Specify if a thread should be created to
run the request. Defaults to False.
Returns:
list of instances: A list containing 1 instance for each product
or None if no results.
"""
# Clean up input data and remove 10 items limit from Amazon API
if isinstance(product_ids, str):
product_ids = [x.strip() for x in product_ids.split(',')]
elif not isinstance(product_ids, list):
raise AmazonException(
'TypeError', 'Arg product_ids should be a list or string')
asin_full_list = list(set([get_asin(x) for x in product_ids]))
asin_full_list = list(chunks(asin_full_list, 10))
results = []
for asin_list in asin_full_list:
try:
request = GetItemsRequest(partner_tag=self.tag,
partner_type=PartnerType.ASSOCIATES,
marketplace=self.marketplace,
merchant=merchant,
condition=CONDITION[condition],
item_ids=asin_list,
resources=PRODUCT_RESOURCES)
except KeyError:
raise AmazonException('KeyError', 'Invalid condition value')
except Exception as e:
raise AmazonException('GetItemsError', e)
for x in range(3):
try:
# Wait before doing the request
wait_time = 1 / self.throttling - (time.time() -
self.last_query_time)
if wait_time > 0:
time.sleep(wait_time)
self.last_query_time = time.time()
# Send the request and create results
if async_req:
thread = self.api.get_items(request, async_req=True)
response = thread.get()
else:
response = self.api.get_items(request)
break
except ApiException as e:
if x == 2:
raise AmazonException('ApiException', e)
try:
if response.items_result is not None:
if len(response.items_result.items) > 0:
for item in response.items_result.items:
results.append(parse_product(item))
except Exception as e:
raise AmazonException('ResponseError', e)
if results:
return results
else:
return None
def get_items(self, item_ids=[], condition=None, currency_of_preference=None, item_id_type="ASIN",languages_of_preference=None, merchant="All", offer_count=1, http_info=False, async_req=False, get_items_resource=ITEM_RESOURCES):
"""
Get items' information.
Choose resources you want from ITEM_RESOURCES enum
For more details, refer: https://webservices.amazon.com/paapi5/documentation/get-items.html#ItemLookup-rp
args:
*item_ids (list of string)*
list of asin of the products of interest
*condition* (enum, optional)*
filter the products based on the condition
*currency_of_preference (string)*
specify the currency of returned results
*item_id_type (string)*
Type of item identifier used to look up an item. Default: ASIN
*languages_of_preference (list of string)*
Languages in order of preference in which the item information should be returned in response. By default the item information is returned in the default language of the marketplace
*merchant (string)*
Filters search results to return items having at least one offer sold by target merchant. By default the value "All" is passed.
*offer_count (integer)*
The number of offers desired for each item in the search results. Default: 1
*http_info (boolean)*
specify if http header should be returned
*async_req (boolean)*
specify if a thread should be created to run the request
*get_items_resource (list)*
For more details, refer: https://webservices.amazon.com/paapi5/documentation/get-items.html#ItemLookup-rp. By deafult all possible resources are requested
return
Dict with
*data*
Dict of ASIN to AmazonProduct object
*http_info*
contains the http header information if requested. By default None
"""
if len(item_ids) == 0:
raise Exception('No item ids specified')
""" Forming request """
try:
cache_url = self._cache_url(
{'partner_tag':self.partner_tag,
'partner_type':PartnerType.ASSOCIATES,
'item_ids':item_ids,
'condition':condition,
'currency_of_preference': currency_of_preference,
'item_id_type': item_id_type,
'languages_of_preference': languages_of_preference,
'merchant': merchant,
'offer_count': offer_count
}
)
if self.CacheReader:
cached_response_text = self.CacheReader(cache_url)
if cached_response_text is not None:
return {'data': parse_response_item( pickle.loads(cached_response_text['data']) ), 'http_info': pickle.loads(cached_response_text['http_info'])}
get_items_request = GetItemsRequest(
partner_tag=self.partner_tag,
partner_type=PartnerType.ASSOCIATES,
marketplace=self.marketplace,
item_ids=item_ids,
condition=condition,
currency_of_preference=currency_of_preference,
item_id_type=item_id_type,
languages_of_preference=languages_of_preference,
merchant=merchant,
offer_count=offer_count,
resources=get_items_resource
)
except ValueError as exception:
#print("Error in forming GetItemsRequest: ", exception)
raise AmazonException("ValueError", exception)
try:
wait_time = 1 / self.throttling - (time.time() - self.last_query_time)
if wait_time > 0:
time.sleep(wait_time)
self.last_query_time = time.time()
resp_http = None
if http_info:
response_with_http_info = self.default_api.get_items_with_http_info(
get_items_request
)
""" Parse response """
if response_with_http_info is not None:
response = response_with_http_info[0]
resp_http = response_with_http_info[2]
if response.items_result is not None:
resp = [ AmazonProduct(item) for item in response.items_result.items]
if self.CacheWriter:
self.CacheWriter(cache_url, pickle.dumps(resp), pickle.dumps(resp_http))
return {'data': parse_response_item(resp), 'http_info': resp_http}
if response.errors is not None:
#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)
raise AmazonException(response.errors[0].code, response.errors[0].message)
else:
""" Sending request """
if async_req:
thread = self.default_api.get_items(get_items_request, async_req=True)
response = thread.get()
else:
response = self.default_api.get_items(get_items_request)
""" Parse response """
if response.items_result is not None:
resp = [ AmazonProduct(item) for item in response.items_result.items]
if self.CacheWriter:
self.CacheWriter(cache_url, pickle.dumps(resp), pickle.dumps(resp_http))
return {'data': parse_response_item(resp), 'http_info': resp_http}
if response.errors is not None:
#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)
raise AmazonException(response.errors[0].code, response.errors[0].message)
except ApiException as exception:
#print("Error calling PA-API 5.0!")
#print("Status code:", exception.status)
#print("Errors :", exception.body)
#print("Request ID:", exception.headers["x-amzn-RequestId"])
raise AmazonException("ApiException", exception.body)
except TypeError as exception:
#print("TypeError :", exception)
raise AmazonException("TypeError", exception)
except ValueError as exception:
#print("ValueError :", exception)
raise AmazonException(ValueError, exception)
except AmazonException as exception:
raise AmazonException(exception.status, exception.reason)
except Exception as exception:
raise AmazonException("General", exception)
def get_products(self, product_ids: [str, list], condition=Condition.ANY):
"""Find product information for a specific product on Amazon.
Args:
product_ids (string): One or more item ids like ASIN or product URL.
Could be a string separated by comma or as a list.
condition (class, optional): Specify the product condition. Defaults to ANY.
Returns:
list of instances: A list containing 1 instance for each product.
"""
api = DefaultApi(access_key=self.key,
secret_key=self.secret,
host=self.host,
region=self.region)
# Clean up input data into a list stripping any extra white space
asin_or_url_list = [x.strip() for x in product_ids.split(",")
] if isinstance(product_ids, str) else product_ids
# Extract ASIN if supplied input is product URL and remove any duplicate ASIN
asin_full_list = list(set([get_asin(x) for x in asin_or_url_list]))
# Creates lists of 10 items each
asin_full_list = list(_chunks(asin_full_list, 10))
product_resources = [
GetItemsResource.BROWSENODEINFO_BROWSENODES,
GetItemsResource.BROWSENODEINFO_BROWSENODES_ANCESTOR,
GetItemsResource.BROWSENODEINFO_BROWSENODES_SALESRANK,
GetItemsResource.BROWSENODEINFO_WEBSITESALESRANK,
GetItemsResource.IMAGES_PRIMARY_SMALL,
GetItemsResource.IMAGES_PRIMARY_MEDIUM,
GetItemsResource.IMAGES_PRIMARY_LARGE,
GetItemsResource.IMAGES_VARIANTS_SMALL,
GetItemsResource.IMAGES_VARIANTS_MEDIUM,
GetItemsResource.IMAGES_VARIANTS_LARGE,
GetItemsResource.ITEMINFO_BYLINEINFO,
GetItemsResource.ITEMINFO_CONTENTINFO,
GetItemsResource.ITEMINFO_CONTENTRATING,
GetItemsResource.ITEMINFO_CLASSIFICATIONS,
GetItemsResource.ITEMINFO_EXTERNALIDS,
GetItemsResource.ITEMINFO_FEATURES,
GetItemsResource.ITEMINFO_MANUFACTUREINFO,
GetItemsResource.ITEMINFO_PRODUCTINFO,
GetItemsResource.ITEMINFO_TECHNICALINFO,
GetItemsResource.ITEMINFO_TITLE,
GetItemsResource.ITEMINFO_TRADEININFO,
GetItemsResource.OFFERS_LISTINGS_AVAILABILITY_MAXORDERQUANTITY,
GetItemsResource.OFFERS_LISTINGS_AVAILABILITY_MESSAGE,
GetItemsResource.OFFERS_LISTINGS_AVAILABILITY_MINORDERQUANTITY,
GetItemsResource.OFFERS_LISTINGS_AVAILABILITY_TYPE,
GetItemsResource.OFFERS_LISTINGS_CONDITION,
GetItemsResource.OFFERS_LISTINGS_CONDITION_SUBCONDITION,
GetItemsResource.OFFERS_LISTINGS_DELIVERYINFO_ISAMAZONFULFILLED,
GetItemsResource.
OFFERS_LISTINGS_DELIVERYINFO_ISFREESHIPPINGELIGIBLE,
GetItemsResource.OFFERS_LISTINGS_DELIVERYINFO_ISPRIMEELIGIBLE,
GetItemsResource.OFFERS_LISTINGS_DELIVERYINFO_SHIPPINGCHARGES,
GetItemsResource.OFFERS_LISTINGS_ISBUYBOXWINNER,
GetItemsResource.OFFERS_LISTINGS_LOYALTYPOINTS_POINTS,
GetItemsResource.OFFERS_LISTINGS_MERCHANTINFO,
GetItemsResource.OFFERS_LISTINGS_PRICE, GetItemsResource.
OFFERS_LISTINGS_PROGRAMELIGIBILITY_ISPRIMEEXCLUSIVE,
GetItemsResource.OFFERS_LISTINGS_PROGRAMELIGIBILITY_ISPRIMEPANTRY,
GetItemsResource.OFFERS_LISTINGS_PROMOTIONS,
GetItemsResource.OFFERS_LISTINGS_SAVINGBASIS,
GetItemsResource.OFFERS_SUMMARIES_HIGHESTPRICE,
GetItemsResource.OFFERS_SUMMARIES_LOWESTPRICE,
GetItemsResource.OFFERS_SUMMARIES_OFFERCOUNT,
GetItemsResource.PARENTASIN, GetItemsResource.
RENTALOFFERS_LISTINGS_AVAILABILITY_MAXORDERQUANTITY,
GetItemsResource.RENTALOFFERS_LISTINGS_AVAILABILITY_MESSAGE,
GetItemsResource.
RENTALOFFERS_LISTINGS_AVAILABILITY_MINORDERQUANTITY,
GetItemsResource.RENTALOFFERS_LISTINGS_AVAILABILITY_TYPE,
GetItemsResource.RENTALOFFERS_LISTINGS_BASEPRICE,
GetItemsResource.RENTALOFFERS_LISTINGS_CONDITION,
GetItemsResource.RENTALOFFERS_LISTINGS_CONDITION_SUBCONDITION,
GetItemsResource.
RENTALOFFERS_LISTINGS_DELIVERYINFO_ISAMAZONFULFILLED,
GetItemsResource.
RENTALOFFERS_LISTINGS_DELIVERYINFO_ISFREESHIPPINGELIGIBLE,
GetItemsResource.
RENTALOFFERS_LISTINGS_DELIVERYINFO_ISPRIMEELIGIBLE,
GetItemsResource.
RENTALOFFERS_LISTINGS_DELIVERYINFO_SHIPPINGCHARGES,
GetItemsResource.RENTALOFFERS_LISTINGS_MERCHANTINFO
]
results = []
for asin_list in asin_full_list:
try:
request = GetItemsRequest(partner_tag=self.tag,
partner_type=PartnerType.ASSOCIATES,
marketplace=self.marketplace,
condition=condition,
item_ids=asin_list,
resources=product_resources)
except Exception as exception:
raise exception
try:
# Wait before doing the request
wait_time = 1 / self.throttling - (time.time() -
self.last_query_time)
if wait_time > 0:
time.sleep(wait_time)
self.last_query_time = time.time()
response = api.get_items(request)
if response.items_result is not None:
if len(response.items_result.items) > 0:
for item in response.items_result.items:
product = parse_product(item)
results.append(product)
except Exception as exception:
raise exception
if results:
return results
else:
return None
def get_product(self, product_id, condition=Condition.ANY):
"""Find product information for a specific product on Amazon.
Args:
product_id (string): Product ASIN or URL. You can send multiple products separated
by commas.
condition (class, optional): Specify the product condition. Defaults to NEW.
Returns:
class instance: An instance of the class Product containing all the available
information when only 1 product is returned.
list of class instances: A list containing 1 instance of the class Product for
each returned product.
"""
api = DefaultApi(access_key=self.key,
secret_key=self.secret,
host=self.host,
region=self.region)
product_id = product_id.split(',')
asin_list = []
for x in product_id:
asin_list.append(get_asin(x.strip()))
product_resources = [
GetItemsResource.BROWSENODEINFO_BROWSENODES,
GetItemsResource.BROWSENODEINFO_BROWSENODES_ANCESTOR,
GetItemsResource.BROWSENODEINFO_BROWSENODES_SALESRANK,
GetItemsResource.BROWSENODEINFO_WEBSITESALESRANK,
GetItemsResource.IMAGES_PRIMARY_SMALL,
GetItemsResource.IMAGES_PRIMARY_MEDIUM,
GetItemsResource.IMAGES_PRIMARY_LARGE,
GetItemsResource.IMAGES_VARIANTS_SMALL,
GetItemsResource.IMAGES_VARIANTS_MEDIUM,
GetItemsResource.IMAGES_VARIANTS_LARGE,
GetItemsResource.ITEMINFO_BYLINEINFO,
GetItemsResource.ITEMINFO_CONTENTINFO,
GetItemsResource.ITEMINFO_CONTENTRATING,
GetItemsResource.ITEMINFO_CLASSIFICATIONS,
GetItemsResource.ITEMINFO_EXTERNALIDS,
GetItemsResource.ITEMINFO_FEATURES,
GetItemsResource.ITEMINFO_MANUFACTUREINFO,
GetItemsResource.ITEMINFO_PRODUCTINFO,
GetItemsResource.ITEMINFO_TECHNICALINFO,
GetItemsResource.ITEMINFO_TITLE,
GetItemsResource.ITEMINFO_TRADEININFO,
GetItemsResource.OFFERS_LISTINGS_AVAILABILITY_MAXORDERQUANTITY,
GetItemsResource.OFFERS_LISTINGS_AVAILABILITY_MESSAGE,
GetItemsResource.OFFERS_LISTINGS_AVAILABILITY_MINORDERQUANTITY,
GetItemsResource.OFFERS_LISTINGS_AVAILABILITY_TYPE,
GetItemsResource.OFFERS_LISTINGS_CONDITION,
GetItemsResource.OFFERS_LISTINGS_CONDITION_SUBCONDITION,
GetItemsResource.OFFERS_LISTINGS_DELIVERYINFO_ISAMAZONFULFILLED,
GetItemsResource.
OFFERS_LISTINGS_DELIVERYINFO_ISFREESHIPPINGELIGIBLE,
GetItemsResource.OFFERS_LISTINGS_DELIVERYINFO_ISPRIMEELIGIBLE,
GetItemsResource.OFFERS_LISTINGS_DELIVERYINFO_SHIPPINGCHARGES,
GetItemsResource.OFFERS_LISTINGS_ISBUYBOXWINNER,
GetItemsResource.OFFERS_LISTINGS_LOYALTYPOINTS_POINTS,
GetItemsResource.OFFERS_LISTINGS_MERCHANTINFO,
GetItemsResource.OFFERS_LISTINGS_PRICE, GetItemsResource.
OFFERS_LISTINGS_PROGRAMELIGIBILITY_ISPRIMEEXCLUSIVE,
GetItemsResource.OFFERS_LISTINGS_PROGRAMELIGIBILITY_ISPRIMEPANTRY,
GetItemsResource.OFFERS_LISTINGS_PROMOTIONS,
GetItemsResource.OFFERS_LISTINGS_SAVINGBASIS,
GetItemsResource.OFFERS_SUMMARIES_HIGHESTPRICE,
GetItemsResource.OFFERS_SUMMARIES_LOWESTPRICE,
GetItemsResource.OFFERS_SUMMARIES_OFFERCOUNT,
GetItemsResource.PARENTASIN, GetItemsResource.
RENTALOFFERS_LISTINGS_AVAILABILITY_MAXORDERQUANTITY,
GetItemsResource.RENTALOFFERS_LISTINGS_AVAILABILITY_MESSAGE,
GetItemsResource.
RENTALOFFERS_LISTINGS_AVAILABILITY_MINORDERQUANTITY,
GetItemsResource.RENTALOFFERS_LISTINGS_AVAILABILITY_TYPE,
GetItemsResource.RENTALOFFERS_LISTINGS_BASEPRICE,
GetItemsResource.RENTALOFFERS_LISTINGS_CONDITION,
GetItemsResource.RENTALOFFERS_LISTINGS_CONDITION_SUBCONDITION,
GetItemsResource.
RENTALOFFERS_LISTINGS_DELIVERYINFO_ISAMAZONFULFILLED,
GetItemsResource.
RENTALOFFERS_LISTINGS_DELIVERYINFO_ISFREESHIPPINGELIGIBLE,
GetItemsResource.
RENTALOFFERS_LISTINGS_DELIVERYINFO_ISPRIMEELIGIBLE,
GetItemsResource.
RENTALOFFERS_LISTINGS_DELIVERYINFO_SHIPPINGCHARGES,
GetItemsResource.RENTALOFFERS_LISTINGS_MERCHANTINFO
]
try:
request = GetItemsRequest(partner_tag=self.tag,
partner_type=PartnerType.ASSOCIATES,
marketplace=self.marketplace,
condition=condition,
item_ids=asin_list,
resources=product_resources)
except Exception as exception:
raise exception
try:
# Wait before doing the request
wait_time = 1 / self.throttling - (time.time() -
self.last_query_time)
if wait_time > 0:
time.sleep(wait_time)
self.last_query_time = time.time()
response = api.get_items(request)
if response.items_result is not None:
if len(response.items_result.items) > 0:
results = []
for item in response.items_result.items:
product = parse_product(item)
results.append(product)
if len(results) == 0:
return None
elif len(results) == 1:
return results[0]
else:
return results
else:
return None
except Exception as exception:
raise exception
def get_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"""
""" Choose item id(s) """
item_ids = ["059035342X", "B00X4WHP5E", "B00ZV9RDKK"]
""" Choose resources you want from GetItemsResource enum """
""" For more details, refer: https://webservices.amazon.com/paapi5/documentation/get-items.html#resources-parameter """
get_items_resource = [
GetItemsResource.ITEMINFO_TITLE,
GetItemsResource.OFFERS_LISTINGS_PRICE,
]
""" Forming request """
try:
get_items_request = GetItemsRequest(
partner_tag=partner_tag,
partner_type=PartnerType.ASSOCIATES,
marketplace="www.amazon.com",
condition=Condition.NEW,
item_ids=item_ids,
resources=get_items_resource,
)
except ValueError as exception:
print("Error in forming GetItemsRequest: ", exception)
return
try:
""" Sending request """
response = default_api.get_items(get_items_request)
print("API called Successfully")
print("Complete Response:", response)
""" Parse response """
if response.items_result is not None:
print("Printing all item information in ItemsResult:")
response_list = parse_response(response.items_result.items)
for item_id in item_ids:
print("Printing information about the item_id: ", item_id)
if item_id in response_list:
item = response_list[item_id]
if item is not None:
if item.asin is not None:
print("ASIN: ", item.asin)
if item.detail_page_url is not None:
print("DetailPageURL: ", item.detail_page_url)
if (item.item_info is not None
and item.item_info.title is not None
and item.item_info.title.display_value
is not None):
print("Title: ",
item.item_info.title.display_value)
if (item.offers is not None
and item.offers.listings is not None
and item.offers.listings[0].price is not None
and
item.offers.listings[0].price.display_amount
is not None):
print(
"Buying Price: ",
item.offers.listings[0].price.display_amount,
)
else:
print("Item not found, check errors")
if response.errors is not None:
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)
except ApiException as exception:
print("Error calling PA-API 5.0!")
print("Status code:", exception.status)
print("Errors :", exception.body)
print("Request ID:", exception.headers["x-amzn-RequestId"])
except TypeError as exception:
print("TypeError :", exception)
except ValueError as exception:
print("ValueError :", exception)
except Exception as exception:
print("Exception :", exception)