Products

class sp_api.api.Products(marketplace: ~sp_api.base.marketplaces.Marketplaces = Marketplaces.US, *, refresh_token=None, account='default', credentials=None, restricted_data_token=None, proxies=None, verify=True, timeout=None, version=None, credential_providers=None, auth_token_client_class=<class 'sp_api.auth.access_token_client.AccessTokenClient'>)

Link:

https://github.com/amzn/selling-partner-api-docs/blob/main/references/product-pricing-api/productPricingV0.md

get_product_pricing_for_skus(self, seller_sku_list: [str], item_condition: str = None, **kwargs) → ApiResponse

Returns pricing information for a seller’s offer listings based on SKU.

Usage Plan:

Rate (requests per second)	Burst
.5	1

Examples

literal blocks:

Products().get_product_pricing_for_skus(['sku', 'sku1'], MarketplaceId="ATVPDKIKX0DER")

Parameters:

• seller_sku_list – [str]

• item_condition – str (“New”, “Used”, “Collectible”, “Refurbished”, “Club”)

• offer_type – str (“B2C” or “B2B”) Default is B2C.

• **kwargs

Return type:

ApiResponse

get_product_pricing_for_asins(self, asin_list: [str], item_condition=None, **kwargs) → ApiResponse

Returns pricing information for a seller’s offer listings based on ASIN.

Usage Plan:

Rate (requests per second)	Burst
.5	1

Examples

literal blocks:

Products().get_product_pricing_for_asins(['asin1', 'asin2'], MarketplaceId="ATVPDKIKX0DER")

Parameters:

• asin_list – [str]

• item_condition – str | (“New”, “Used”, “Collectible”, “Refurbished”, “Club”) Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club. Available values : New, Used, Collectible, Refurbished, Club

• offer_type – str (“B2C” or “B2B”) Default is B2C.

Returns:

ApiResponse

get_competitive_pricing_for_skus(self, seller_sku_list, **kwargs) → ApiResponse

Returns competitive pricing information for a seller’s offer listings based on Seller Sku

Usage Plan:

Rate (requests per second)	Burst
.5	1

Examples

literal blocks:

Products().get_competitive_pricing_for_skus([], MarketplaceId="ATVPDKIKX0DER")

Parameters:

• seller_sku_list – [str]

• customer_type – Optional (query) str (“Consumer” or “Business”) Indicates whether to request pricing information from the point of view of Consumer or Business buyers. Default is Consumer.

Returns:

ApiResponse

get_competitive_pricing_for_asins(self, asin_list, **kwargs) → ApiResponse

Returns competitive pricing information for a seller’s offer listings based on ASIN

Usage Plan:

Rate (requests per second)	Burst
.5	1

Examples

literal blocks:

Products().get_competitive_pricing_for_asins([], MarketplaceId="ATVPDKIKX0DER")

Parameters:

• asin_list – [str]

• customer_type – Optional (query) str (“Consumer” or “Business”) Indicates whether to request pricing information from the point of view of Consumer or Business buyers. Default is Consumer.

Returns:

ApiResponse

get_listings_offer(self, seller_sku: str, **kwargs) → ApiResponse

Returns the lowest priced offers for a single SKU listing

Usage Plan:

Rate (requests per second)	Burst
1	2

Parameters:

• MarketplaceId (key) – Required (query) str

• item_condition – Required (query) str | (“New”, “Used”, “Collectible”, “Refurbished”, “Club”) Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club. Available values : New, Used, Collectible, Refurbished, Club

• seller_sku – Required (path) str

• customer_type – Optional (query) str (“Consumer” or “Business”) Indicates whether to request pricing information from the point of view of Consumer or Business buyers. Default is Consumer.

Returns:

ApiResponse

get_item_offers(self, asin: str, **kwargs) → ApiResponse

Returns the lowest priced offers for a single item based on ASIN

Usage Plan:

Rate (requests per second)	Burst
.5	1

Parameters:

• MarketplaceId (key) – Required (query) str

• item_condition – Required (query) str | (“New”, “Used”, “Collectible”, “Refurbished”, “Club”) Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club. Available values : New, Used, Collectible, Refurbished, Club

• asin – Required (path) str

• customer_type – Optional (query) str (“Consumer” or “Business”) Indicates whether to request pricing information from the point of view of Consumer or Business buyers. Default is Consumer.

Returns:

ApiResponse

get_item_offers_batch(self, requests_: List[Dict | ItemOffersRequest] | None, **kwargs) → ApiResponse

Returns the lowest priced offers for a batch of items based on ASIN.

Usage Plan:

Rate (requests per second)	Burst
.5	1

Parameters:

requests – Optional (Body) [dict] The request associated with the getItemOffersBatch API call.

Returns:

ApiResponse

get_listing_offers_batch(self, requests_: List[Dict] | GetListingOffersBatchRequest | None, **kwargs) → ApiResponse

Returns the lowest priced offers for a batch of listings based on ASIN.

Usage Plan:

Rate (requests per second)	Burst
.5	1

Parameters:

requests – Optional (Body) [dict] The request associated with the getListingOffersBatch API call.

Returns:

ApiResponse