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'>)
-
- 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:
- 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