def get_variations(self,
asin,
item_count=10,
item_page=1,
items_per_page=10,
condition='Any',
merchant='All',
async_req=False):
"""Returns a set of items that are the same product, but differ according to a
consistent theme, for example size and color.
Args:
asin (str): One item ID like ASIN or product URL.
item_count (int, optional): The total number of products to get. Should be between
1 and 100. Defaults to 10.
item_page (int, optional): The page where the results start from. Should be between
1 and 10. Defaults to 1.
items_per_page (int, optional): Products on each page. Should be between
1 and 10. Defaults to 10.
condition (str, optional): The condition parameter filters offers by
condition type. 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.
"""
if items_per_page > 10 or items_per_page < 1:
raise AmazonException(
'ValueError', 'Arg items_per_page should be between 1 and 10')
if item_count > 100 or item_count < 1:
raise AmazonException(
'ValueError', 'Arg item_count should be between 1 and 100')
if item_page < 1:
raise AmazonException('ValueError',
'Arg item_page should be 1 or higher')
results = []
while len(results) < item_count:
try:
request = GetVariationsRequest(
partner_tag=self.tag,
partner_type=PartnerType.ASSOCIATES,
marketplace=self.marketplace,
asin=get_asin(asin),
condition=CONDITION[condition],
merchant=merchant,
offer_count=1,
variation_count=items_per_page,
variation_page=item_page,
resources=VARIATION_RESOURCES)
except KeyError:
raise AmazonException('KeyError', 'Invalid condition value')
except Exception as e:
raise AmazonException('GetVariationsError', e)
for x in range(3):
try:
# Send the request and create results
self._throttle()
if async_req:
thread = self.api.get_variations(request,
async_req=True)
response = thread.get()
else:
response = self.api.get_variations(request)
break
except ApiException as e:
if x == 2:
raise AmazonException('ApiException', e)
try:
if response.variations_result is not None:
if response.variations_result.items is not None:
for item in response.variations_result.items:
results.append(parse_product(item))
if len(results) >= item_count:
break
if len(response.variations_result.items
) < items_per_page:
break
else:
break
if response.errors is not None:
raise AmazonException(response.errors[0].code,
response.errors[0].message)
except Exception as e:
raise AmazonException('ResponseError', e)
item_page += 1
if results:
return results
else:
return None
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:
# Send the request and create results
self._throttle()
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 search_products(self,
item_count=10,
item_page=1,
items_per_page=10,
keywords=None,
actor=None,
artist=None,
author=None,
brand=None,
title=None,
availability='Available',
browse_node=None,
condition='Any',
delivery=None,
max_price=None,
min_price=None,
min_rating=None,
min_discount=None,
merchant='All',
search_index='All',
sort_by=None,
async_req=False):
"""Search products on Amazon using different parameters. At least one of the
following parameters should be used: keywords, actor, artist, author, brand,
title.
Args:
item_count (int, optional): The total number of products to get. Should be between
1 and 100. Defaults to 10.
item_page (int, optional): The page where the results start from. Should be between
1 and 10. Defaults to 1.
items_per_page (int, optional): Products on each page. Should be between
1 and 10. Defaults to 10.
keywords (str, optional): A word or phrase that describes an item.
actor (str, optional): Actor name associated with the item.
artist (str, optional): Artist name associated with the item.
author (str, optional): Author name associated with the item.
brand (str, optional): Brand name associated with the item.
title (str, optional): Title associated with the item.
availability (str, optional): Filters available items on Amazon. Allowed values:
Available, IncludeOutOfStock. Defaults to Available.
browse_node (str, optional): A unique ID assigned by Amazon that
identifies a product category or subcategory.
condition (str, optional): The condition parameter filters offers by
condition type. Allowed values: Any, Collectible, New, Refurbished, Used.
Defaults to Any.
delivery (list, optional): The delivery flag filters items which
satisfy a certain delivery program promoted by the specific
Amazon Marketplace. Allowed values: AmazonGlobal, FreeShipping,
FulfilledByAmazon, Prime.
max_price (int, optional): Filters search results to items with at
least one offer price below the specified value.
min_price (int, optional): Filters search results to items with at
least one offer price above the specified value.
min_rating (int, optional): Filters search results to items with
customer review ratings above specified value.
min_discount (int, optional): Filters search results to items with
at least one offer having saving percentage above the specified
value.
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.
search_index (str, optional): Indicates the product category to
search. Defaults to All.
sort_by (str, optional): The way in which items in the response
are sorted. Allowed values: AvgCustomerReviews, Featured,
NewestArrivals, Price:HighToLow, Price:LowToHigh, Relevance.
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.
"""
if items_per_page > 10 or items_per_page < 1:
raise AmazonException(
'ValueError', 'Arg items_per_page should be between 1 and 10')
if item_count > 100 or item_count < 1:
raise AmazonException(
'ValueError', 'Arg item_count should be between 1 and 100')
if item_page < 1:
raise AmazonException('ValueError',
'Arg item_page should be 1 or higher')
if not keywords and not actor and not artist and not author and not brand and not title and not browse_node and not search_index:
raise AmazonException(
'ValueError', 'At least one of the following args must be '
'provided: keywords, actor, artist, author, brand, '
'title, browse_node, search_index')
results = []
while len(results) < item_count:
try:
request = SearchItemsRequest(
partner_tag=self.tag,
partner_type=PartnerType.ASSOCIATES,
actor=actor,
artist=artist,
author=author,
availability=availability,
brand=brand,
browse_node_id=browse_node,
condition=CONDITION[condition],
delivery_flags=delivery,
item_count=items_per_page,
item_page=item_page,
keywords=keywords,
max_price=max_price,
merchant=merchant,
min_price=min_price,
min_reviews_rating=min_rating,
min_saving_percent=min_discount,
offer_count=1,
resources=SEARCH_RESOURCES,
search_index=search_index,
sort_by=sort_by,
title=title)
except KeyError:
raise AmazonException('KeyError', 'Invalid condition value')
except Exception as e:
raise AmazonException('SearchItemsError', e)
for x in range(3):
try:
# Send the request and create results
self._throttle()
if async_req:
thread = self.api.search_items(request, async_req=True)
response = thread.get()
else:
response = self.api.search_items(request)
break
except ApiException as e:
if x == 2:
raise AmazonException('ApiException', e)
try:
if response.search_result is not None:
if response.search_result.items is not None:
for item in response.search_result.items:
results.append(parse_product(item))
if len(results) >= item_count:
break
if len(response.search_result.items) < items_per_page:
break
else:
break
if response.errors is not None:
raise AmazonException(response.errors[0].code,
response.errors[0].message)
except Exception as e:
if e.status == "NoResults":
break
raise AmazonException('ResponseError', e)
item_page += 1
if results:
return results
else:
return None