Products

class sp_api.api.Products(marketplace: 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)
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