Products V0

class sp_api.api.ProductsV0(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'>)
Links:

https://github.com/amzn/selling-partner-api-docs/blob/main/references/product-pricing-api/productPricingV0.md https://developer-docs.amazon.com/sp-api/docs/product-pricing-api-v2022-05-01-reference

get_product_pricing_for_skus(self, seller_sku_list, item_condition, offer_type, **kwargs) → ApiResponse

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

Note: The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).

Usage Plan:

Rate (requests per second)

Burst

0.5

1

For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.

Examples

literal blocks:

ProductsV0().get_product_pricing_for_skus("value", "value", "value")
Parameters:

  • MarketplaceId (key) – object | required A marketplace identifier. Specifies the marketplace for which prices are returned.

  • Asins (key) – object | A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.

  • Skus (key) – object | A list of up to twenty seller SKU values used to identify items in the given marketplace.

  • ItemType (key) – object | required Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter.

  • ItemCondition (key) – object | Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

  • OfferType (key) – object | Indicates whether to request pricing information for the seller’s B2C or B2B offers. Default is B2C.

Returns:

ApiResponse

get_product_pricing_for_asins(self, asin_list, item_condition, offer_type, **kwargs) → ApiResponse

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

Note: The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).

Usage Plan:

Rate (requests per second)

Burst

0.5

1

For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.

Examples

literal blocks:

ProductsV0().get_product_pricing_for_asins("value", "value", "value")
Parameters:

  • MarketplaceId (key) – object | required A marketplace identifier. Specifies the marketplace for which prices are returned.

  • Asins (key) – object | A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.

  • Skus (key) – object | A list of up to twenty seller SKU values used to identify items in the given marketplace.

  • ItemType (key) – object | required Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter.

  • ItemCondition (key) – object | Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

  • OfferType (key) – object | Indicates whether to request pricing information for the seller’s B2C or B2B offers. Default is B2C.

Returns:

ApiResponse

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

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

Note: The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).

Usage Plan:

Rate (requests per second)

Burst

0.5

1

For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.

Examples

literal blocks:

ProductsV0().get_competitive_pricing_for_skus("value", "value")
Parameters:

  • MarketplaceId (key) – object | required A marketplace identifier. Specifies the marketplace for which prices are returned.

  • Asins (key) – object | A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.

  • Skus (key) – object | A list of up to twenty seller SKU values used to identify items in the given marketplace.

  • ItemType (key) – object | required Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter. Possible values: Asin, Sku.

  • CustomerType (key) – object | 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, customer_type, **kwargs) → ApiResponse

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

Note: The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).

Usage Plan:

Rate (requests per second)

Burst

0.5

1

For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.

Examples

literal blocks:

ProductsV0().get_competitive_pricing_for_asins("value", "value")
Parameters:

  • MarketplaceId (key) – object | required A marketplace identifier. Specifies the marketplace for which prices are returned.

  • Asins (key) – object | A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.

  • Skus (key) – object | A list of up to twenty seller SKU values used to identify items in the given marketplace.

  • ItemType (key) – object | required Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter. Possible values: Asin, Sku.

  • CustomerType (key) – object | 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, item_condition, customer_type, **kwargs) → ApiResponse

Returns the lowest priced offers for a single SKU listing.

Note: The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to [URL Encoding](https://developer-docs.amazon.com/sp-api/docs/url-encoding).

Usage Plan:

Rate (requests per second)

Burst

1

2

For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.

Examples

literal blocks:

ProductsV0().get_listings_offer("value", "value", "value")
Parameters:

  • MarketplaceId (key) – object | required A marketplace identifier. Specifies the marketplace for which prices are returned.

  • ItemCondition (key) – object | required Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

  • SellerSKU – object | required Identifies an item in the given marketplace. SellerSKU is qualified by the seller’s SellerId, which is included with every operation that you submit.

  • CustomerType (key) – object | Indicates whether to request Consumer or Business offers. Default is Consumer.

Returns:

ApiResponse

get_item_offers(self, asin, item_condition, customer_type, **kwargs) → ApiResponse

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

Usage Plan:

Rate (requests per second)

Burst

0.5

1

For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.

Examples

literal blocks:

ProductsV0().get_item_offers("value", "value", "value")
Parameters:

  • MarketplaceId (key) – object | required A marketplace identifier. Specifies the marketplace for which prices are returned.

  • ItemCondition (key) – object | required Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

  • Asin – object | required The Amazon Standard Identification Number (ASIN) of the item.

  • CustomerType (key) – object | Indicates whether to request Consumer or Business offers. Default is Consumer.

Returns:

ApiResponse

get_item_offers_batch(self, requests_, **kwargs) → ApiResponse

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

Usage Plan:

Rate (requests per second)

Burst

0.1

1

For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.

Examples

literal blocks:

ProductsV0().get_item_offers_batch("value")
Parameters:

getItemOffersBatchRequestBody – GetItemOffersBatchRequest | required The request associated with the getItemOffersBatch API call.

Returns:

ApiResponse

get_listing_offers_batch(self, requests_, **kwargs) → ApiResponse

Returns the lowest priced offers for a batch of listings by SKU.

Usage Plan:

Rate (requests per second)

Burst

0.5

1

For more information, see “Usage Plans and Rate Limits” in the Selling Partner API documentation.

Examples

literal blocks:

ProductsV0().get_listing_offers_batch("value")
Parameters:

getListingOffersBatchRequestBody – GetListingOffersBatchRequest | required The request associated with the getListingOffersBatch API call.

Returns:

ApiResponse