Catalog

class sp_api.api.Catalog(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/catalog-items-api/catalogItemsV0.md

get_item(self, asin: str, **kwargs) ApiResponse

Returns a specified item and its attributes.

Usage Plan:

Rate (requests per second)

Burst

1

1

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

Examples

literal blocks:

res = Catalog().get_item('ASIN_200', MarketplaceId='TEST_CASE_200')
Parameters:
  • asin – str

  • MarketplaceId (key) – str

  • **kwargs

Return type:

GetCatalogItemResponse

list_items(self, **kwargs) ApiResponse

Returns a list of items and their attributes, based on a search query or item identifiers that you specify. When based on a search query, provide the Query parameter and optionally, the QueryContextId parameter. When based on item identifiers, provide a single appropriate parameter based on the identifier type, and specify the associated item value. MarketplaceId is always required.

Usage Plan:

Rate (requests per second)

Burst

1

1

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

Examples

literal blocks:

res = Catalog().list_items(MarketplaceId='TEST_CASE_200', SellerSKU='SKU_200')
Parameters:
  • MarketplaceId (key) – str

  • Query (key) – str

  • QueryContextId (key) – str

  • SellerSKU (key) – str

  • UPC (key) – str

  • EAN (key) – str

  • ISBN (key) – str

  • JAN (key) – str

Return type:

ListCatalogItemsResponse

list_categories(self, **kwargs) ApiResponse

Returns the parent categories to which an item belongs, based on the specified ASIN or SellerSKU

Usage Plan:

Rate (requests per second)

Burst

1

2

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

Parameters:
  • MarketplaceId (key) – str

  • ASIN (key) – str

  • SellerSKU (key) – str

Return type:

ListCatalogCategoriesResponse